Optimize full-stack VigilantRAG for Hugging Face Spaces deployment with MongoDB Atlas

Dockerfile

@@ -5,31 +5,49 @@ FROM python:3.11-slim
 ENV PYTHONUNBUFFERED=1 \
     PYTHONDONTWRITEBYTECODE=1 \
     HF_HOME=/code/.cache/huggingface \
-    PORT=7860
+    PORT=7860 \
+    NODE_ENV=production
 
 # Set the working directory
 WORKDIR /code
 
-# Install system dependencies (git is sometimes used by HF libraries)
+# Install system dependencies & Node.js (LTS v18)
 RUN apt-get update && apt-get install -y --no-install-recommends \
     git \
     build-essential \
+    curl \
+    && curl -fsSL https://deb.nodesource.com/setup_18.x | bash - \
+    && apt-get install -y nodejs \
     && rm -rf /var/lib/apt/lists/*
 
-# Copy requirements file first to leverage Docker layer caching
+# 1. Install Python RAG Backend dependencies
 COPY requirements.txt .
-
-# Install python dependencies
 RUN pip install --no-cache-dir --upgrade pip && \
     pip install --no-cache-dir -r requirements.txt
 
-# Create a writable cache directory for Hugging Face models
-# Hugging Face Spaces runs as user 1000, so we must make /code writable
-RUN mkdir -p /code/.cache/huggingface && chmod -R 777 /code
+# 2. Build React Frontend static files
+COPY frontend/package*.json ./frontend/
+RUN cd frontend && npm install
+
+COPY frontend/ ./frontend/
+RUN cd frontend && npm run build
+
+# 3. Setup Node.js API Gateway
+COPY gateway/package*.json ./gateway/
+RUN cd gateway && npm install --production
 
-# Copy the rest of the application files
+# Copy build output from frontend to gateway's public directory
+RUN mkdir -p gateway/public && cp -r frontend/build/* gateway/public/
+
+# Copy the rest of the application files (including backends)
 COPY . .
 
+# Ensure start.sh has execution permissions
+RUN chmod +x start.sh
+
+# Create a writable cache directory for Hugging Face models (user 1000 compatibility)
+RUN mkdir -p /code/.cache/huggingface && chmod -R 777 /code
+
 # Pre-download and cache models in the container image during build time
 RUN python download_models.py
 
@@ -39,5 +57,5 @@ RUN python scratch/ingest_large_samples.py
 # Expose port 7860 for Hugging Face Space / external access
 EXPOSE 7860
 
-# Run the FastAPI application on host 0.0.0.0 and port 7860
-CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]
+# Run the startup script to concurrently run FastAPI and Node.js
+CMD ["bash", "start.sh"]

frontend/src/App.js

@@ -6,6 +6,8 @@ import {
 } from 'lucide-react';
 import './App.css';
 
+const API_URL = process.env.REACT_APP_API_URL || 'http://localhost:5000';
+
 function App() {
   const [token, setToken] = useState(localStorage.getItem('token') || '');
   const [email, setEmail] = useState('');
@@ -238,7 +240,7 @@ function App() {
     const targetEmail = devEmail || email;
     const targetPassword = devEmail ? 'password123' : password;
     try {
-      const res = await fetch('http://localhost:5000/api/login', {
+      const res = await fetch(`${API_URL}/api/login`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ email: targetEmail, password: targetPassword })
@@ -283,7 +285,7 @@ function App() {
     }
 
     try {
-      const res = await fetch('http://localhost:5000/api/register', {
+      const res = await fetch(`${API_URL}/api/register`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
@@ -322,7 +324,7 @@ function App() {
 
   const fetchUserStatus = async () => {
     try {
-      const res = await fetch('http://localhost:5000/api/user-status', {
+      const res = await fetch(`${API_URL}/api/user-status`, {
         headers: { 'Authorization': `Bearer ${token}` }
       });
       const data = await res.json();
@@ -333,7 +335,7 @@ function App() {
 
   const fetchDocuments = async () => {
     try {
-      const res = await fetch('http://localhost:5000/api/documents', {
+      const res = await fetch(`${API_URL}/api/documents`, {
         headers: { 'Authorization': `Bearer ${token}` }
       });
       const data = await res.json();
@@ -351,7 +353,7 @@ function App() {
 
   const fetchChatThreads = async (projId) => {
     try {
-      const res = await fetch(`http://localhost:5000/api/projects/${projId}/chats`, {
+      const res = await fetch(`${API_URL}/api/projects/${projId}/chats`, {
         headers: { 'Authorization': `Bearer ${token}` }
       });
       const data = await res.json();
@@ -363,7 +365,7 @@ function App() {
 
   const handleCreateChatThread = async (projId, threadTitle) => {
     try {
-      const res = await fetch(`http://localhost:5000/api/projects/${projId}/chats`, {
+      const res = await fetch(`${API_URL}/api/projects/${projId}/chats`, {
         method: 'POST',
         headers: { 
           'Content-Type': 'application/json',
@@ -380,7 +382,7 @@ function App() {
   const handleDeleteChatThread = async (e, threadId) => {
     e.stopPropagation();
     try {
-      await fetch(`http://localhost:5000/api/projects/${selectedProjectId}/chats/${threadId}`, {
+      await fetch(`${API_URL}/api/projects/${selectedProjectId}/chats/${threadId}`, {
         method: 'DELETE',
         headers: { 'Authorization': `Bearer ${token}` }
       });
@@ -397,7 +399,7 @@ function App() {
     if (newTitle === currentTitle) return;
 
     try {
-      const res = await fetch(`http://localhost:5000/api/projects/${selectedProjectId}/chats/${threadId}`, {
+      const res = await fetch(`${API_URL}/api/projects/${selectedProjectId}/chats/${threadId}`, {
         method: 'PUT',
         headers: { 
           'Content-Type': 'application/json',
@@ -419,7 +421,7 @@ function App() {
     if (!window.confirm("Are you sure you want to delete this document from the database? This will permanently wipe its text vectors and conversation history.")) return;
 
     try {
-      const res = await fetch(`http://localhost:5000/api/documents/${docId}`, {
+      const res = await fetch(`${API_URL}/api/documents/${docId}`, {
         method: 'DELETE',
         headers: { 'Authorization': `Bearer ${token}` }
       });
@@ -479,7 +481,7 @@ function App() {
     setQuery('');
     setLoading(true);
     try {
-      const response = await fetch('http://localhost:5000/api/query', {
+      const response = await fetch(`${API_URL}/api/query`, {
         method: 'POST',
         headers: { 
           'Content-Type': 'application/json',
@@ -518,7 +520,7 @@ function App() {
     formData.append('doc_id', docId);
     formData.append('title', uploadTitle);
     try {
-      const res = await fetch('http://localhost:5000/api/ingest-file', {
+      const res = await fetch(`${API_URL}/api/ingest-file`, {
         method: 'POST',
         headers: { 'Authorization': `Bearer ${token}` },
         body: formData
@@ -543,7 +545,7 @@ function App() {
     setUploadStatus({ type: '', text: '' });
     const docId = `doc_${uploadTitle.toLowerCase().replace(/[^a-z0-9]/g, '_')}`;
     try {
-      const res = await fetch('http://localhost:5000/api/ingest', {
+      const res = await fetch(`${API_URL}/api/ingest`, {
         method: 'POST',
         headers: { 
           'Content-Type': 'application/json',
@@ -568,7 +570,7 @@ function App() {
 
   const handleViewDocContent = async (docId) => {
     try {
-      const res = await fetch(`http://localhost:5000/api/documents/${docId}`, {
+      const res = await fetch(`${API_URL}/api/documents/${docId}`, {
         headers: { 'Authorization': `Bearer ${token}` }
       });
       const data = await res.json();
@@ -578,7 +580,7 @@ function App() {
 
   const handleUpgrade = async () => {
     try {
-      const res = await fetch('http://localhost:5000/api/create-razorpay-order', {
+      const res = await fetch(`${API_URL}/api/create-razorpay-order`, {
         method: 'POST',
         headers: { 
           'Content-Type': 'application/json', 
@@ -600,7 +602,7 @@ function App() {
         order_id: order.id,
         handler: async function (response) {
           try {
-            const verifyRes = await fetch("http://localhost:5000/api/verify-razorpay-payment", {
+            const verifyRes = await fetch(`${API_URL}/api/verify-razorpay-payment`, {
               method: "POST",
               headers: {
                 "Content-Type": "application/json",
@@ -659,7 +661,7 @@ function App() {
     setProfileSaveStatus({ type: '', text: '' });
 
     try {
-      const res = await fetch('http://localhost:5000/api/user-profile', {
+      const res = await fetch(`${API_URL}/api/user-profile`, {
         method: 'PUT',
         headers: {
           'Content-Type': 'application/json',
@@ -691,7 +693,7 @@ function App() {
     if (!confirmCancel) return;
 
     try {
-      const res = await fetch('http://localhost:5000/api/cancel-subscription', {
+      const res = await fetch(`${API_URL}/api/cancel-subscription`, {
         method: 'POST',
         headers: {
           'Authorization': `Bearer ${token}`

gateway/migrate.js

@@ -0,0 +1,83 @@
+const fs = require('fs');
+const path = require('path');
+const mongoose = require('mongoose');
+const dotenv = require('dotenv');
+
+// Load environment variables
+dotenv.config();
+
+const User = require('./models/User');
+const ProjectChat = require('./models/Chat');
+
+const USERS_FILE = path.join(__dirname, 'users.json');
+const CHATS_FILE = path.join(__dirname, 'chats.json');
+
+async function migrate() {
+    if (!process.env.MONGODB_URI) {
+        console.error("❌ MONGODB_URI not found in environment configurations.");
+        process.exit(1);
+    }
+
+    console.log("🌿 Connecting to MongoDB...");
+    await mongoose.connect(process.env.MONGODB_URI);
+    console.log("🌿 Connected successfully.");
+
+    // 1. Migrate Users
+    if (fs.existsSync(USERS_FILE)) {
+        try {
+            const rawUsers = JSON.parse(fs.readFileSync(USERS_FILE, 'utf8'));
+            console.log(`💼 Found ${rawUsers.length} users in users.json to migrate.`);
+            
+            for (const user of rawUsers) {
+                const exists = await User.findOne({ userId: user.userId });
+                if (!exists) {
+                    // Create new user model (preserving old plain-text passwords or bcrypt hashes as-is)
+                    await User.create(user);
+                    console.log(`   ✅ Migrated user profile: ${user.name} (${user.email})`);
+                } else {
+                    console.log(`   ⏭️ User already exists in MongoDB: ${user.name} (${user.email})`);
+                }
+            }
+        } catch (err) {
+            console.error("❌ Failed migrating users:", err.message);
+        }
+    } else {
+        console.log("⏭️ No users.json file found to migrate.");
+    }
+
+    // 2. Migrate Chats
+    if (fs.existsSync(CHATS_FILE)) {
+        try {
+            const chatsDb = JSON.parse(fs.readFileSync(CHATS_FILE, 'utf8'));
+            let threadCount = 0;
+
+            for (const userId of Object.keys(chatsDb)) {
+                for (const projectId of Object.keys(chatsDb[userId])) {
+                    const exists = await ProjectChat.findOne({ userId, projectId });
+                    if (!exists) {
+                        const projectData = chatsDb[userId][projectId];
+                        await ProjectChat.create({
+                            userId,
+                            projectId,
+                            chats: projectData.chats || []
+                        });
+                        threadCount += (projectData.chats || []).length;
+                        console.log(`   ✅ Migrated project workspace chats for User: ${userId}, Project: ${projectId}`);
+                    } else {
+                        console.log(`   ⏭️ Project chat already exists in MongoDB for User: ${userId}, Project: ${projectId}`);
+                    }
+                }
+            }
+            console.log(`💼 Migrated total of ${threadCount} chat threads to MongoDB.`);
+        } catch (err) {
+            console.error("❌ Failed migrating chats:", err.message);
+        }
+    } else {
+        console.log("⏭️ No chats.json file found to migrate.");
+    }
+
+    console.log("\n🎉 Migration completed successfully!");
+    mongoose.connection.close();
+}
+
+migrate();

gateway/models/Chat.js

@@ -0,0 +1,25 @@
+const mongoose = require('mongoose');
+
+const messageSchema = new mongoose.Schema({
+    sender: { type: String, enum: ['user', 'ai'], required: true },
+    text: { type: String, required: true },
+    timestamp: { type: Date, default: Date.now },
+    telemetry: { type: mongoose.Schema.Types.Mixed } // Multi-source metadata storage
+});
+
+const threadSchema = new mongoose.Schema({
+    chatId: { type: String, required: true },
+    chatTitle: { type: String, required: true },
+    messages: [messageSchema]
+});
+
+const projectChatSchema = new mongoose.Schema({
+    userId: { type: String, required: true },
+    projectId: { type: String, required: true }, // active document workspace ID
+    chats: [threadSchema]
+}, { timestamps: true });
+
+// Dynamic indexes for fast lookups
+projectChatSchema.index({ userId: 1, projectId: 1 }, { unique: true });
+
+module.exports = mongoose.model('ProjectChat', projectChatSchema);

gateway/models/User.js

@@ -0,0 +1,25 @@
+const mongoose = require('mongoose');
+
+const documentSchema = new mongoose.Schema({
+    id: { type: String, required: true },
+    name: { type: String, required: true },
+    sizeBytes: { type: Number, required: true },
+    uploadedAt: { type: Date, default: Date.now }
+});
+
+const userSchema = new mongoose.Schema({
+    userId: { type: String, required: true, unique: true },
+    name: { type: String, required: true },
+    email: { type: String, required: true, unique: true, lowercase: true, trim: true },
+    password: { type: String, required: true }, // bcrypt hashed passwords
+    isPremium: { type: Boolean, default: false },
+    queryCount: { type: Number, default: 0 },
+    totalStorageBytes: { type: Number, default: 0 },
+    uploadedDocuments: [documentSchema],
+    profilePhoto: { type: String, default: '👨‍💻' },
+    phoneNumber: { type: String, default: '' },
+    razorpayPaymentId: { type: String },
+    stripeCustomerId: { type: String }
+}, { timestamps: true }); // Auto adds createdAt & updatedAt fields
+
+module.exports = mongoose.model('User', userSchema);

gateway/node_modules/.package-lock.json

@@ -4,6 +4,36 @@
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
+    "node_modules/@mongodb-js/saslprep": {
+      "version": "1.4.13",
+      "resolved": "https://registry.npmjs.org/@mongodb-js/saslprep/-/saslprep-1.4.13.tgz",
+      "integrity": "sha512-E3Sv4eCYAlKYUTx8S3ioQcDUscOif+8zZ5OnW1IzJ+Tt+EO+ke8mn+Y3FX6N1H79picwbdOavVOb1jPi2EOyrg==",
+      "license": "MIT",
+      "dependencies": {
+        "sparse-bitfield": "^3.0.3"
+      }
+    },
+    "node_modules/@standard-schema/spec": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+      "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
+      "license": "MIT"
+    },
+    "node_modules/@types/webidl-conversions": {
+      "version": "7.0.3",
+      "resolved": "https://registry.npmjs.org/@types/webidl-conversions/-/webidl-conversions-7.0.3.tgz",
+      "integrity": "sha512-CiJJvcRtIgzadHCYXw7dqEnMNRjhGZlYK05Mj9OyktqV8uVT8fD2BFOB7S1uwBE3Kj2Z+4UyPmFw/Ixgw/LAlA==",
+      "license": "MIT"
+    },
+    "node_modules/@types/whatwg-url": {
+      "version": "13.0.0",
+      "resolved": "https://registry.npmjs.org/@types/whatwg-url/-/whatwg-url-13.0.0.tgz",
+      "integrity": "sha512-N8WXpbE6Wgri7KUSvrmQcqrMllKZ9uxkYWMt+mCSGwNc0Hsw9VQTW7ApqI4XNrx6/SaM2QQJCzMPDEXE058s+Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/webidl-conversions": "*"
+      }
+    },
     "node_modules/accepts": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
@@ -99,6 +129,15 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/bson": {
+      "version": "7.3.2",
+      "resolved": "https://registry.npmjs.org/bson/-/bson-7.3.2.tgz",
+      "integrity": "sha512-1w0ra+ho1cuE+w8jzwgzTFIimFtCfZeCoOsvIPQg6uyFCsp8M29U7bNNf5GrFh88TXbYg1g3TyKUGpd6O7q6zA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=20.19.0"
+      }
+    },
     "node_modules/buffer-equal-constant-time": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz",
@@ -766,6 +805,15 @@
         "safe-buffer": "^5.0.1"
       }
     },
+    "node_modules/kareem": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/kareem/-/kareem-3.3.0.tgz",
+      "integrity": "sha512-kpSuLD3/7RenBnjnJdOHXCKC8dTd1JzeOiJhN0necWWci6cC+qX+VuwPnMVgb+a4+KNJSfgqahpnfWaeDXCimw==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
     "node_modules/lodash.includes": {
       "version": "4.3.0",
       "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz",
@@ -830,6 +878,12 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/memory-pager": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/memory-pager/-/memory-pager-1.5.0.tgz",
+      "integrity": "sha512-ZS4Bp4r/Zoeq6+NLJpP+0Zzm0pR8whtGPf1XExKLJBAczGMnSi3It14OiNCStjQjM6NU1okjQGSxgEZN8eBYKg==",
+      "license": "MIT"
+    },
     "node_modules/merge-descriptors": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
@@ -867,6 +921,105 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/mongodb": {
+      "version": "7.5.0",
+      "resolved": "https://registry.npmjs.org/mongodb/-/mongodb-7.5.0.tgz",
+      "integrity": "sha512-5FnrEDLnvp6ycUOGLNLLU33BfCx2qmp2mJjGPDwKLruYsVzXVSK5fsGpoDXvsXJwBfBsD7ebMRdawbDxC2814g==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@mongodb-js/saslprep": "^1.4.11",
+        "bson": "^7.2.0",
+        "mongodb-connection-string-url": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "peerDependencies": {
+        "@aws-sdk/credential-providers": "^3.806.0",
+        "@mongodb-js/zstd": "^7.0.0",
+        "gcp-metadata": "^7.0.1",
+        "kerberos": "^7.0.0",
+        "mongodb-client-encryption": "^7.2.0",
+        "snappy": "^7.3.2",
+        "socks": "^2.8.6"
+      },
+      "peerDependenciesMeta": {
+        "@aws-sdk/credential-providers": {
+          "optional": true
+        },
+        "@mongodb-js/zstd": {
+          "optional": true
+        },
+        "gcp-metadata": {
+          "optional": true
+        },
+        "kerberos": {
+          "optional": true
+        },
+        "mongodb-client-encryption": {
+          "optional": true
+        },
+        "snappy": {
+          "optional": true
+        },
+        "socks": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/mongodb-connection-string-url": {
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/mongodb-connection-string-url/-/mongodb-connection-string-url-7.0.2.tgz",
+      "integrity": "sha512-ZoS07RoFqpKYQwAk59qmrx8+jJHNHU30UjlU96QktiGn1ltvDr+vCznLX5DiUBLEpMAHatHNWV1nM/74ul66kA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@types/whatwg-url": "^13.0.0",
+        "whatwg-url": "^14.1.0"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      }
+    },
+    "node_modules/mongoose": {
+      "version": "9.9.3",
+      "resolved": "https://registry.npmjs.org/mongoose/-/mongoose-9.9.3.tgz",
+      "integrity": "sha512-9dQaKct05LNgVkunDzFPZsGGBhinobl3Qc5B5KYJkLNG5lBLgqESUEItl1EUIkVaCwZJGBgTuvJiFAjjIATCiw==",
+      "license": "MIT",
+      "dependencies": {
+        "@standard-schema/spec": "^1.1.0",
+        "kareem": "3.3.0",
+        "mongodb": "~7.5",
+        "mpath": "0.9.0",
+        "mquery": "6.0.0",
+        "ms": "2.1.3",
+        "sift": "17.1.3"
+      },
+      "engines": {
+        "node": ">=20.19.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/mongoose"
+      }
+    },
+    "node_modules/mpath": {
+      "version": "0.9.0",
+      "resolved": "https://registry.npmjs.org/mpath/-/mpath-0.9.0.tgz",
+      "integrity": "sha512-ikJRQTk8hw5DEoFVxHG1Gn9T/xcjtdnOKIU1JTmGjZZlg9LST2mBLmcX3/ICIbgJydT2GOc15RnNy5mHmzfSew==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/mquery": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/mquery/-/mquery-6.0.0.tgz",
+      "integrity": "sha512-b2KQNsmgtkscfeDgkYMcWGn9vZI9YoXh802VDEwE6qc50zxBFQ0Oo8ROkawbPAsXCY1/Z1yp0MagqsZStPWJjw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.19.0"
+      }
+    },
     "node_modules/ms": {
       "version": "2.1.3",
       "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
@@ -1027,6 +1180,15 @@
         "node": ">=10"
       }
     },
+    "node_modules/punycode": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/qs": {
       "version": "6.15.3",
       "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.3.tgz",
@@ -1271,6 +1433,21 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/sift": {
+      "version": "17.1.3",
+      "resolved": "https://registry.npmjs.org/sift/-/sift-17.1.3.tgz",
+      "integrity": "sha512-Rtlj66/b0ICeFzYTuNvX/EF1igRbbnGSvEyT79McoZa/DeGhMyC5pWKOEsZKnpkqtSeovd5FL/bjHWC3CIIvCQ==",
+      "license": "MIT"
+    },
+    "node_modules/sparse-bitfield": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/sparse-bitfield/-/sparse-bitfield-3.0.3.tgz",
+      "integrity": "sha512-kvzhi7vqKTfkh0PZU+2D2PIllw2ymqJKujUcyPMd9Y75Nv4nPbGJZXNhxsgdQab2BmlDct1YnfQCguEvHr7VsQ==",
+      "license": "MIT",
+      "dependencies": {
+        "memory-pager": "^1.0.2"
+      }
+    },
     "node_modules/statuses": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
@@ -1323,6 +1500,18 @@
         "node": ">=0.6"
       }
     },
+    "node_modules/tr46": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-5.1.1.tgz",
+      "integrity": "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==",
+      "license": "MIT",
+      "dependencies": {
+        "punycode": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/type-is": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.1.0.tgz",
@@ -1384,6 +1573,28 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/webidl-conversions": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-7.0.0.tgz",
+      "integrity": "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/whatwg-url": {
+      "version": "14.2.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-14.2.0.tgz",
+      "integrity": "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==",
+      "license": "MIT",
+      "dependencies": {
+        "tr46": "^5.1.0",
+        "webidl-conversions": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/wrappy": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",

gateway/node_modules/@mongodb-js/saslprep/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Dmitry Tsvettsikh
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

gateway/node_modules/@mongodb-js/saslprep/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@mongodb-js/saslprep",
+  "description": "SASLprep: Stringprep Profile for User Names and Passwords, rfc4013",
+  "keywords": [
+    "sasl",
+    "saslprep",
+    "stringprep",
+    "rfc4013",
+    "4013"
+  ],
+  "author": "Dmitry Tsvettsikh <me@reklatsmasters.com>",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/node.js",
+  "bugs": {
+    "url": "https://jira.mongodb.org/projects/COMPASS/issues",
+    "email": "compass@mongodb.com"
+  },
+  "homepage": "https://github.com/mongodb-js/devtools-shared/tree/main/packages/saslprep",
+  "version": "1.4.13",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mongodb-js/devtools-shared.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "exports": {
+    "browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
+    },
+    "import": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/.esm-wrapper.mjs"
+    },
+    "require": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    }
+  },
+  "types": "./dist/node.d.ts",
+  "scripts": {
+    "gen-code-points": "ts-node src/generate-code-points.ts src/code-points-data.ts src/code-points-data-browser.ts",
+    "bootstrap": "npm run compile",
+    "prepublishOnly": "npm run compile",
+    "compile": "npm run gen-code-points && tsc -p tsconfig.json && gen-esm-wrapper . ./dist/.esm-wrapper.mjs",
+    "typecheck": "tsc --noEmit",
+    "eslint": "eslint",
+    "prettier": "prettier",
+    "lint": "npm run eslint . && npm run prettier -- --check .",
+    "depcheck": "depcheck",
+    "check": "npm run typecheck && npm run lint && npm run depcheck",
+    "check-ci": "npm run check",
+    "test": "mocha",
+    "test-cov": "nyc -x \"**/*.spec.*\" --reporter=lcov --reporter=text --reporter=html npm run test",
+    "test-watch": "npm run test -- --watch",
+    "test-ci": "npm run test-cov",
+    "reformat": "npm run prettier -- --write ."
+  },
+  "dependencies": {
+    "sparse-bitfield": "^3.0.3"
+  },
+  "devDependencies": {
+    "@mongodb-js/eslint-config-devtools": "^0.11.8",
+    "@mongodb-js/mocha-config-devtools": "^1.1.3",
+    "@mongodb-js/prettier-config-devtools": "^1.0.4",
+    "@mongodb-js/tsconfig-devtools": "^1.1.3",
+    "@types/chai": "^4.2.21",
+    "@types/mocha": "^9.1.1",
+    "@types/node": "^25.5.2",
+    "@types/sinon-chai": "^4.0.0",
+    "@types/sparse-bitfield": "^3.0.4",
+    "chai": "^4.5.0",
+    "depcheck": "^1.4.7",
+    "eslint": "^7.25.0 || ^8.0.0",
+    "gen-esm-wrapper": "^1.1.3",
+    "mocha": "^8.4.0",
+    "nyc": "^15.1.0",
+    "prettier": "^3.8.1",
+    "sinon": "^9.2.3",
+    "typescript": "^5.9.3"
+  },
+  "gitHead": "58acee6dbcadb316e3fd3d52bd97c2bd31d621cc"
+}

gateway/node_modules/@mongodb-js/saslprep/readme.md

@@ -0,0 +1,29 @@
+# saslprep
+
+_Note: This is a fork of the original [`saslprep`](https://www.npmjs.com/package/saslprep) npm package
+and provides equivalent functionality._
+
+Stringprep Profile for User Names and Passwords, [rfc4013](https://tools.ietf.org/html/rfc4013)
+
+### Usage
+
+```js
+const saslprep = require('@mongodb-js/saslprep');
+
+saslprep('password\u00AD'); // password
+saslprep('password\u0007'); // Error: prohibited character
+```
+
+### API
+
+##### `saslprep(input: String, opts: Options): String`
+
+Normalize user name or password.
+
+##### `Options.allowUnassigned: bool`
+
+A special behavior for unassigned code points, see https://tools.ietf.org/html/rfc4013#section-2.5. Disabled by default.
+
+## License
+
+MIT, 2017-2019 (c) Dmitriy Tsvettsikh

gateway/node_modules/@standard-schema/spec/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gateway/node_modules/@standard-schema/spec/README.md

@@ -0,0 +1,198 @@
+<h1 align="center">
+  <img alt="Standard Schema fire logo" loading="lazy" width="50" height="50" decoding="async" data-nimg="1" style="color:transparent" src="https://standardschema.dev/favicon.svg">
+  </br>
+  Standard Schema</h1>
+<p align="center">
+  A family of specs for interoperable TypeScript
+  <br/>
+  <a href="https://standardschema.dev">standardschema.dev</a>
+</p>
+<br/>
+
+<!-- start -->
+
+The Standard Schema project is a set of interfaces that standardize the provision and consumption of shared functionality in the TypeScript ecosystem.
+
+Its goal is to allow tools to accept a single input that includes all the types and capabilities they need— no library-specific adapters, no extra dependencies. The result is an ecosystem that's fair for implementers, friendly for consumers, and open for end users.
+
+## The specifications
+
+The specifications can be found below in their entirety. Libraries wishing to implement a spec can copy/paste the code block below into their codebase. They're also available at `@standard-schema/spec` on [npm](https://www.npmjs.com/package/@standard-schema/spec) and [JSR](https://jsr.io/@standard-schema/spec).
+
+```ts
+// #########################
+// ###   Standard Typed  ###
+// #########################
+
+/** The Standard Typed interface. This is a base type extended by other specs. */
+export interface StandardTypedV1<Input = unknown, Output = Input> {
+  /** The Standard properties. */
+  readonly "~standard": StandardTypedV1.Props<Input, Output>;
+}
+
+export declare namespace StandardTypedV1 {
+  /** The Standard Typed properties interface. */
+  export interface Props<Input = unknown, Output = Input> {
+    /** The version number of the standard. */
+    readonly version: 1;
+    /** The vendor name of the schema library. */
+    readonly vendor: string;
+    /** Inferred types associated with the schema. */
+    readonly types?: Types<Input, Output> | undefined;
+  }
+
+  /** The Standard Typed types interface. */
+  export interface Types<Input = unknown, Output = Input> {
+    /** The input type of the schema. */
+    readonly input: Input;
+    /** The output type of the schema. */
+    readonly output: Output;
+  }
+
+  /** Infers the input type of a Standard Typed. */
+  export type InferInput<Schema extends StandardTypedV1> = NonNullable<
+    Schema["~standard"]["types"]
+  >["input"];
+
+  /** Infers the output type of a Standard Typed. */
+  export type InferOutput<Schema extends StandardTypedV1> = NonNullable<
+    Schema["~standard"]["types"]
+  >["output"];
+}
+
+// ##########################
+// ###   Standard Schema  ###
+// ##########################
+
+/** The Standard Schema interface. */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+  /** The Standard Schema properties. */
+  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+}
+
+export declare namespace StandardSchemaV1 {
+  /** The Standard Schema properties interface. */
+  export interface Props<Input = unknown, Output = Input>
+    extends StandardTypedV1.Props<Input, Output> {
+    /** Validates unknown input values. */
+    readonly validate: (
+      value: unknown,
+      options?: StandardSchemaV1.Options | undefined
+    ) => Result<Output> | Promise<Result<Output>>;
+  }
+
+  /** The result interface of the validate function. */
+  export type Result<Output> = SuccessResult<Output> | FailureResult;
+
+  /** The result interface if validation succeeds. */
+  export interface SuccessResult<Output> {
+    /** The typed output value. */
+    readonly value: Output;
+    /** A falsy value for `issues` indicates success. */
+    readonly issues?: undefined;
+  }
+
+  export interface Options {
+    /** Explicit support for additional vendor-specific parameters, if needed. */
+    readonly libraryOptions?: Record<string, unknown> | undefined;
+  }
+
+  /** The result interface if validation fails. */
+  export interface FailureResult {
+    /** The issues of failed validation. */
+    readonly issues: ReadonlyArray<Issue>;
+  }
+
+  /** The issue interface of the failure output. */
+  export interface Issue {
+    /** The error message of the issue. */
+    readonly message: string;
+    /** The path of the issue, if any. */
+    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+  }
+
+  /** The path segment interface of the issue. */
+  export interface PathSegment {
+    /** The key representing a path segment. */
+    readonly key: PropertyKey;
+  }
+
+  /** The Standard types interface. */
+  export interface Types<Input = unknown, Output = Input>
+    extends StandardTypedV1.Types<Input, Output> {}
+
+  /** Infers the input type of a Standard. */
+  export type InferInput<Schema extends StandardTypedV1> =
+    StandardTypedV1.InferInput<Schema>;
+
+  /** Infers the output type of a Standard. */
+  export type InferOutput<Schema extends StandardTypedV1> =
+    StandardTypedV1.InferOutput<Schema>;
+}
+
+// ###############################
+// ###   Standard JSON Schema  ###
+// ###############################
+
+/** The Standard JSON Schema interface. */
+export interface StandardJSONSchemaV1<Input = unknown, Output = Input> {
+  /** The Standard JSON Schema properties. */
+  readonly "~standard": StandardJSONSchemaV1.Props<Input, Output>;
+}
+
+export declare namespace StandardJSONSchemaV1 {
+  /** The Standard JSON Schema properties interface. */
+  export interface Props<Input = unknown, Output = Input>
+    extends StandardTypedV1.Props<Input, Output> {
+    /** Methods for generating the input/output JSON Schema. */
+    readonly jsonSchema: StandardJSONSchemaV1.Converter;
+  }
+
+  /** The Standard JSON Schema converter interface. */
+  export interface Converter {
+    /** Converts the input type to JSON Schema. May throw if conversion is not supported. */
+    readonly input: (
+      options: StandardJSONSchemaV1.Options
+    ) => Record<string, unknown>;
+    /** Converts the output type to JSON Schema. May throw if conversion is not supported. */
+    readonly output: (
+      options: StandardJSONSchemaV1.Options
+    ) => Record<string, unknown>;
+  }
+
+  /**
+   * The target version of the generated JSON Schema.
+   *
+   * It is *strongly recommended* that implementers support `"draft-2020-12"` and `"draft-07"`, as they are both in wide use. All other targets can be implemented on a best-effort basis. Libraries should throw if they don't support a specified target.
+   *
+   * The `"openapi-3.0"` target is intended as a standardized specifier for OpenAPI 3.0 which is a superset of JSON Schema `"draft-04"`.
+   */
+  export type Target =
+    | "draft-2020-12"
+    | "draft-07"
+    | "openapi-3.0"
+    // Accepts any string for future targets while preserving autocomplete
+    | ({} & string);
+
+  /** The options for the input/output methods. */
+  export interface Options {
+    /** Specifies the target version of the generated JSON Schema. Support for all versions is on a best-effort basis. If a given version is not supported, the library should throw. */
+    readonly target: Target;
+
+    /** Explicit support for additional vendor-specific parameters, if needed. */
+    readonly libraryOptions?: Record<string, unknown> | undefined;
+  }
+
+  /** The Standard types interface. */
+  export interface Types<Input = unknown, Output = Input>
+    extends StandardTypedV1.Types<Input, Output> {}
+
+  /** Infers the input type of a Standard. */
+  export type InferInput<Schema extends StandardTypedV1> =
+    StandardTypedV1.InferInput<Schema>;
+
+  /** Infers the output type of a Standard. */
+  export type InferOutput<Schema extends StandardTypedV1> =
+    StandardTypedV1.InferOutput<Schema>;
+}
+```

gateway/node_modules/@standard-schema/spec/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@standard-schema/spec",
+  "description": "A family of specs for interoperable TypeScript",
+  "version": "1.1.0",
+  "license": "MIT",
+  "author": "Colin McDonnell",
+  "homepage": "https://standardschema.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/standard-schema/standard-schema"
+  },
+  "keywords": [
+    "typescript",
+    "schema",
+    "validation",
+    "standard",
+    "interface"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "standard-schema-spec": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.2"
+  },
+  "scripts": {
+    "lint": "pnpm biome lint ./src",
+    "format": "pnpm biome format --write ./src",
+    "check": "pnpm biome check ./src",
+    "build": "tsup"
+  }
+}

gateway/node_modules/@types/webidl-conversions/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

gateway/node_modules/@types/webidl-conversions/README.md

@@ -0,0 +1,15 @@
+# Installation
+> `npm install --save @types/webidl-conversions`
+
+# Summary
+This package contains type definitions for webidl-conversions (https://github.com/jsdom/webidl-conversions#readme).
+
+# Details
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/webidl-conversions.
+
+### Additional Details
+ * Last updated: Tue, 07 Nov 2023 15:11:36 GMT
+ * Dependencies: none
+
+# Credits
+These definitions were written by [ExE Boss](https://github.com/ExE-Boss), and [BendingBender](https://github.com/BendingBender).

gateway/node_modules/@types/webidl-conversions/index.d.ts

@@ -0,0 +1,91 @@
+declare namespace WebIDLConversions {
+    interface Globals {
+        [key: string]: unknown;
+
+        Number: (value?: unknown) => number;
+        String: (value?: unknown) => string;
+        TypeError: new(message?: string) => TypeError;
+    }
+
+    interface Options {
+        context?: string | undefined;
+        globals?: Globals | undefined;
+    }
+
+    interface IntegerOptions extends Options {
+        enforceRange?: boolean | undefined;
+        clamp?: boolean | undefined;
+    }
+
+    interface StringOptions extends Options {
+        treatNullAsEmptyString?: boolean | undefined;
+    }
+
+    interface BufferSourceOptions extends Options {
+        allowShared?: boolean | undefined;
+    }
+
+    type IntegerConversion = (V: unknown, opts?: IntegerOptions) => number;
+    type StringConversion = (V: unknown, opts?: StringOptions) => string;
+    type NumberConversion = (V: unknown, opts?: Options) => number;
+}
+
+declare const WebIDLConversions: {
+    any<V>(V: V, opts?: WebIDLConversions.Options): V;
+    undefined(V?: unknown, opts?: WebIDLConversions.Options): void;
+    boolean(V: unknown, opts?: WebIDLConversions.Options): boolean;
+
+    byte(V: unknown, opts?: WebIDLConversions.IntegerOptions): number;
+    octet(V: unknown, opts?: WebIDLConversions.IntegerOptions): number;
+
+    short(V: unknown, opts?: WebIDLConversions.IntegerOptions): number;
+    ["unsigned short"](V: unknown, opts?: WebIDLConversions.IntegerOptions): number;
+
+    long(V: unknown, opts?: WebIDLConversions.IntegerOptions): number;
+    ["unsigned long"](V: unknown, opts?: WebIDLConversions.IntegerOptions): number;
+
+    ["long long"](V: unknown, opts?: WebIDLConversions.IntegerOptions): number;
+    ["unsigned long long"](V: unknown, opts?: WebIDLConversions.IntegerOptions): number;
+
+    double(V: unknown, opts?: WebIDLConversions.Options): number;
+    ["unrestricted double"](V: unknown, opts?: WebIDLConversions.Options): number;
+
+    float(V: unknown, opts?: WebIDLConversions.Options): number;
+    ["unrestricted float"](V: unknown, opts?: WebIDLConversions.Options): number;
+
+    DOMString(V: unknown, opts?: WebIDLConversions.StringOptions): string;
+    ByteString(V: unknown, opts?: WebIDLConversions.StringOptions): string;
+    USVString(V: unknown, opts?: WebIDLConversions.StringOptions): string;
+
+    object<V>(V: V, opts?: WebIDLConversions.Options): V extends object ? V : V & object;
+    ArrayBuffer(
+        V: unknown,
+        opts?: WebIDLConversions.BufferSourceOptions & { allowShared?: false | undefined },
+    ): ArrayBuffer;
+    ArrayBuffer(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): ArrayBufferLike;
+    DataView(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): DataView;
+
+    Int8Array(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Int8Array;
+    Int16Array(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Int16Array;
+    Int32Array(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Int32Array;
+
+    Uint8Array(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Uint8Array;
+    Uint16Array(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Uint16Array;
+    Uint32Array(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Uint32Array;
+    Uint8ClampedArray(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Uint8ClampedArray;
+
+    Float32Array(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Float32Array;
+    Float64Array(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): Float64Array;
+
+    ArrayBufferView(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): ArrayBufferView;
+    BufferSource(
+        V: unknown,
+        opts?: WebIDLConversions.BufferSourceOptions & { allowShared?: false | undefined },
+    ): ArrayBuffer | ArrayBufferView;
+    BufferSource(V: unknown, opts?: WebIDLConversions.BufferSourceOptions): ArrayBufferLike | ArrayBufferView;
+
+    DOMTimeStamp(V: unknown, opts?: WebIDLConversions.Options): number;
+};
+
+// This can't use ES6 style exports, as those can't have spaces in export names.
+export = WebIDLConversions;

gateway/node_modules/@types/webidl-conversions/package.json

@@ -0,0 +1,30 @@
+{
+    "name": "@types/webidl-conversions",
+    "version": "7.0.3",
+    "description": "TypeScript definitions for webidl-conversions",
+    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/webidl-conversions",
+    "license": "MIT",
+    "contributors": [
+        {
+            "name": "ExE Boss",
+            "githubUsername": "ExE-Boss",
+            "url": "https://github.com/ExE-Boss"
+        },
+        {
+            "name": "BendingBender",
+            "githubUsername": "BendingBender",
+            "url": "https://github.com/BendingBender"
+        }
+    ],
+    "main": "",
+    "types": "index.d.ts",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/DefinitelyTyped/DefinitelyTyped.git",
+        "directory": "types/webidl-conversions"
+    },
+    "scripts": {},
+    "dependencies": {},
+    "typesPublisherContentHash": "ff1514e10869784e8b7cca9c4099a4213d3f14b48c198b1bf116300df94bf608",
+    "typeScriptVersion": "4.5"
+}

gateway/node_modules/@types/whatwg-url/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

gateway/node_modules/@types/whatwg-url/README.md

@@ -0,0 +1,15 @@
+# Installation
+> `npm install --save @types/whatwg-url`
+
+# Summary
+This package contains type definitions for whatwg-url (https://github.com/jsdom/whatwg-url#readme).
+
+# Details
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/whatwg-url.
+
+### Additional Details
+ * Last updated: Tue, 12 Nov 2024 00:46:36 GMT
+ * Dependencies: [@types/webidl-conversions](https://npmjs.com/package/@types/webidl-conversions)
+
+# Credits
+These definitions were written by [Alexander Marks](https://github.com/aomarks), [ExE Boss](https://github.com/ExE-Boss), and [BendingBender](https://github.com/BendingBender).

gateway/node_modules/@types/whatwg-url/index.d.ts

@@ -0,0 +1,172 @@
+/// <reference lib="es2020"/>
+/** https://url.spec.whatwg.org/#url-representation */
+export interface URLRecord {
+    scheme: string;
+    username: string;
+    password: string;
+    host: string | number | IPv6Address | null;
+    port: number | null;
+    path: string | string[];
+    query: string | null;
+    fragment: string | null;
+}
+
+/** https://url.spec.whatwg.org/#concept-ipv6 */
+export type IPv6Address = [number, number, number, number, number, number, number, number];
+
+/** https://url.spec.whatwg.org/#url-class */
+export class URL {
+    constructor(url: string, base?: string | URL);
+
+    static canParse(url: string, base?: string): boolean;
+
+    get href(): string;
+    set href(V: string);
+
+    get origin(): string;
+
+    get protocol(): string;
+    set protocol(V: string);
+
+    get username(): string;
+    set username(V: string);
+
+    get password(): string;
+    set password(V: string);
+
+    get host(): string;
+    set host(V: string);
+
+    get hostname(): string;
+    set hostname(V: string);
+
+    get port(): string;
+    set port(V: string);
+
+    get pathname(): string;
+    set pathname(V: string);
+
+    get search(): string;
+    set search(V: string);
+
+    get searchParams(): URLSearchParams;
+
+    get hash(): string;
+    set hash(V: string);
+
+    toJSON(): string;
+
+    readonly [Symbol.toStringTag]: "URL";
+}
+
+/** https://url.spec.whatwg.org/#interface-urlsearchparams */
+export class URLSearchParams {
+    constructor(
+        init?:
+            | ReadonlyArray<readonly [name: string, value: string]>
+            | Iterable<readonly [name: string, value: string]>
+            | { readonly [name: string]: string }
+            | string,
+    );
+
+    get size(): number;
+    append(name: string, value: string): void;
+    delete(name: string, value?: string): void;
+    get(name: string): string | null;
+    getAll(name: string): string[];
+    has(name: string, value?: string): boolean;
+    set(name: string, value: string): void;
+    sort(): void;
+
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<string>;
+    entries(): IterableIterator<[name: string, value: string]>;
+    forEach<THIS_ARG = void>(
+        callback: (this: THIS_ARG, value: string, name: string, searchParams: this) => void,
+        thisArg?: THIS_ARG,
+    ): void;
+
+    readonly [Symbol.toStringTag]: "URLSearchParams";
+    [Symbol.iterator](): IterableIterator<[name: string, value: string]>;
+}
+
+/** https://url.spec.whatwg.org/#concept-url-parser */
+export function parseURL(input: string, options?: { readonly baseURL?: URLRecord | undefined }): URLRecord | null;
+
+/** https://url.spec.whatwg.org/#concept-basic-url-parser */
+export function basicURLParse(
+    input: string,
+    options?: {
+        baseURL?: URLRecord | undefined;
+        url?: URLRecord | undefined;
+        stateOverride?: StateOverride | undefined;
+    },
+): URLRecord | null;
+
+/** https://url.spec.whatwg.org/#scheme-start-state */
+export type StateOverride =
+    | "scheme start"
+    | "scheme"
+    | "no scheme"
+    | "special relative or authority"
+    | "path or authority"
+    | "relative"
+    | "relative slash"
+    | "special authority slashes"
+    | "special authority ignore slashes"
+    | "authority"
+    | "host"
+    | "hostname"
+    | "port"
+    | "file"
+    | "file slash"
+    | "file host"
+    | "path start"
+    | "path"
+    | "opaque path"
+    | "query"
+    | "fragment";
+
+/** https://url.spec.whatwg.org/#concept-url-serializer */
+export function serializeURL(urlRecord: URLRecord, excludeFragment?: boolean): string;
+
+/** https://url.spec.whatwg.org/#concept-host-serializer */
+export function serializeHost(host: string | number | IPv6Address): string;
+
+/** https://url.spec.whatwg.org/#url-path-serializer */
+export function serializePath(urlRecord: URLRecord): string;
+
+/** https://url.spec.whatwg.org/#serialize-an-integer */
+export function serializeInteger(number: number): string;
+
+/** https://html.spec.whatwg.org#ascii-serialisation-of-an-origin */
+export function serializeURLOrigin(urlRecord: URLRecord): string;
+
+/** https://url.spec.whatwg.org/#set-the-username */
+export function setTheUsername(urlRecord: URLRecord, username: string): void;
+
+/** https://url.spec.whatwg.org/#set-the-password */
+export function setThePassword(urlRecord: URLRecord, password: string): void;
+
+/** https://url.spec.whatwg.org/#url-opaque-path */
+export function hasAnOpaquePath(urlRecord: URLRecord): boolean;
+
+/** https://url.spec.whatwg.org/#cannot-have-a-username-password-port */
+export function cannotHaveAUsernamePasswordPort(urlRecord: URLRecord): boolean;
+
+/** https://url.spec.whatwg.org/#percent-decode */
+export function percentDecodeBytes(buffer: TypedArray): Uint8Array;
+
+/** https://url.spec.whatwg.org/#string-percent-decode */
+export function percentDecodeString(string: string): Uint8Array;
+
+export type TypedArray =
+    | Uint8Array
+    | Uint8ClampedArray
+    | Uint16Array
+    | Uint32Array
+    | Int8Array
+    | Int16Array
+    | Int32Array
+    | Float32Array
+    | Float64Array;

gateway/node_modules/@types/whatwg-url/package.json

@@ -0,0 +1,38 @@
+{
+    "name": "@types/whatwg-url",
+    "version": "13.0.0",
+    "description": "TypeScript definitions for whatwg-url",
+    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/whatwg-url",
+    "license": "MIT",
+    "contributors": [
+        {
+            "name": "Alexander Marks",
+            "githubUsername": "aomarks",
+            "url": "https://github.com/aomarks"
+        },
+        {
+            "name": "ExE Boss",
+            "githubUsername": "ExE-Boss",
+            "url": "https://github.com/ExE-Boss"
+        },
+        {
+            "name": "BendingBender",
+            "githubUsername": "BendingBender",
+            "url": "https://github.com/BendingBender"
+        }
+    ],
+    "main": "",
+    "types": "index.d.ts",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/DefinitelyTyped/DefinitelyTyped.git",
+        "directory": "types/whatwg-url"
+    },
+    "scripts": {},
+    "dependencies": {
+        "@types/webidl-conversions": "*"
+    },
+    "peerDependencies": {},
+    "typesPublisherContentHash": "fd4818c1b74d8ef43c58e984d60d82658280822821b6ea5d4978f4007f29c39c",
+    "typeScriptVersion": "4.9"
+}

gateway/node_modules/@types/whatwg-url/webidl2js-wrapper.d.ts

@@ -0,0 +1,4 @@
+import * as URL from "./lib/URL";
+import * as URLSearchParams from "./lib/URLSearchParams";
+
+export { URL, URLSearchParams };

gateway/node_modules/bson/LICENSE.md

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

gateway/node_modules/bson/README.md

@@ -0,0 +1,297 @@
+# BSON parser
+
+BSON is short for "Binary JSON," and is the binary-encoded serialization of JSON-like documents.
+You can learn more about it in [the specification](http://bsonspec.org).
+
+### Table of Contents
+
+- [Usage](#usage)
+- [Bugs/Feature Requests](#bugs--feature-requests)
+- [Installation](#installation)
+- [Documentation](#documentation)
+- [FAQ](#faq)
+
+
+### Release Integrity
+
+Releases are created automatically and signed using the [Node team's GPG key](https://pgp.mongodb.com/node-driver.asc). All release packages provided as part of a GitHub release are signed. To verify the provided packages, download the key and import it using gpg:
+
+```shell
+gpg --import node-driver.asc
+```
+
+The GitHub release contains a detached signature file for the NPM package (named
+`bson-X.Y.Z.tgz.sig`).
+
+The following command returns the link npm package. 
+```shell
+npm view bson@vX.Y.Z dist.tarball 
+```
+
+Using the result of the above command, a `curl` command can return the official npm package for the release.
+
+To verify the integrity of the downloaded package, run the following command:
+```shell
+gpg --verify bson-X.Y.Z.tgz.sig bson-X.Y.Z.tgz
+```
+
+>[!Note]
+No GPG verification is done when using npm to install the package. The contents of the GitHub tarball and npm's tarball are identical.
+
+Releases published to the npm registry also include a [provenance attestation](https://docs.npmjs.com/generating-provenance-statements), which cryptographically links the package to its source repository and build workflow. To verify provenance:
+
+```shell
+npm audit signatures
+```
+
+## Bugs / Feature Requests
+
+Think you've found a bug? Want to see a new feature in `bson`? Please open a case in our issue management tool, JIRA:
+
+1. Create an account and login: [jira.mongodb.org](https://jira.mongodb.org)
+2. Navigate to the NODE project: [jira.mongodb.org/browse/NODE](https://jira.mongodb.org/browse/NODE)
+3. Click **Create Issue** - Please provide as much information as possible about the issue and how to reproduce it.
+
+Bug reports in JIRA for the NODE driver project are **public**.
+
+## Usage
+
+To build a new version perform the following operations:
+
+```
+npm install
+npm run build
+```
+
+### Node.js or Bundling Usage
+
+When using a bundler or Node.js you can import bson using the package name:
+
+```js
+import { BSON, EJSON, ObjectId } from 'bson';
+// or:
+// const { BSON, EJSON, ObjectId } = require('bson');
+
+const bytes = BSON.serialize({ _id: new ObjectId() });
+console.log(bytes);
+const doc = BSON.deserialize(bytes);
+console.log(EJSON.stringify(doc));
+// {"_id":{"$oid":"..."}}
+```
+
+### Browser Usage
+
+If you are working directly in the browser without a bundler please use the `.mjs` bundle like so:
+
+```html
+<script type="module">
+  import { BSON, EJSON, ObjectId } from './lib/bson.mjs';
+
+  const bytes = BSON.serialize({ _id: new ObjectId() });
+  console.log(bytes);
+  const doc = BSON.deserialize(bytes);
+  console.log(EJSON.stringify(doc));
+  // {"_id":{"$oid":"..."}}
+</script>
+```
+
+## Installation
+
+```sh
+npm install bson
+```
+
+### MongoDB Node.js Driver Version Compatibility
+
+Only the following version combinations with the [MongoDB Node.js Driver](https://github.com/mongodb/node-mongodb-native) are considered stable.
+
+|               | `bson@1.x` | `bson@4.x` | `bson@5.x` | `bson@6.x` | `bson@7.x` |
+| ------------- | ---------- | ---------- | ---------- | ---------- | ---------- |
+| `mongodb@7.x` | N/A        | N/A        | N/A        | N/A        | ✓          |
+| `mongodb@6.x` | N/A        | N/A        | N/A        | ✓          | N/A        |
+| `mongodb@5.x` | N/A        | N/A        | ✓          | N/A        | N/A        |
+| `mongodb@4.x` | N/A        | ✓          | N/A        | N/A        | N/A        |
+| `mongodb@3.x` | ✓          | N/A        | N/A        | N/A        | N/A        |
+
+## Documentation
+
+### BSON
+
+[API documentation](https://mongodb.github.io/node-mongodb-native/Next/modules/BSON.html)
+
+<a name="EJSON"></a>
+
+### EJSON
+
+- [EJSON](#EJSON)
+
+  - [.parse(text, [options])](#EJSON.parse)
+
+  - [.stringify(value, [replacer], [space], [options])](#EJSON.stringify)
+
+  - [.serialize(bson, [options])](#EJSON.serialize)
+
+  - [.deserialize(ejson, [options])](#EJSON.deserialize)
+
+<a name="EJSON.parse"></a>
+
+#### _EJSON_.parse(text, [options])
+
+| Param             | Type                 | Default           | Description                                                                        |
+| ----------------- | -------------------- | ----------------- | ---------------------------------------------------------------------------------- |
+| text              | <code>string</code>  |                   |                                                                                    |
+| [options]         | <code>object</code>  |                   | Optional settings                                                                  |
+| [options.relaxed] | <code>boolean</code> | <code>true</code> | Attempt to return native JS types where possible, rather than BSON types (if true) |
+
+Parse an Extended JSON string, constructing the JavaScript value or object described by that
+string.
+
+**Example**
+
+```js
+const { EJSON } = require('bson');
+const text = '{ "int32": { "$numberInt": "10" } }';
+
+// prints { int32: { [String: '10'] _bsontype: 'Int32', value: '10' } }
+console.log(EJSON.parse(text, { relaxed: false }));
+
+// prints { int32: 10 }
+console.log(EJSON.parse(text));
+```
+
+<a name="EJSON.stringify"></a>
+
+#### _EJSON_.stringify(value, [replacer], [space], [options])
+
+| Param             | Type                                        | Default           | Description                                                                                                                                                                                                                                                                                                                                        |
+| ----------------- | ------------------------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| value             | <code>object</code>                         |                   | The value to convert to extended JSON                                                                                                                                                                                                                                                                                                              |
+| [replacer]        | <code>function</code> \| <code>array</code> |                   | A function that alters the behavior of the stringification process, or an array of String and Number objects that serve as a whitelist for selecting/filtering the properties of the value object to be included in the JSON string. If this value is null or not provided, all properties of the object are included in the resulting JSON string |
+| [space]           | <code>string</code> \| <code>number</code>  |                   | A String or Number object that's used to insert white space into the output JSON string for readability purposes.                                                                                                                                                                                                                                  |
+| [options]         | <code>object</code>                         |                   | Optional settings                                                                                                                                                                                                                                                                                                                                  |
+| [options.relaxed] | <code>boolean</code>                        | <code>true</code> | Enabled Extended JSON's `relaxed` mode                                                                                                                                                                                                                                                                                                             |
+| [options.legacy]  | <code>boolean</code>                        | <code>true</code> | Output in Extended JSON v1                                                                                                                                                                                                                                                                                                                         |
+
+Converts a BSON document to an Extended JSON string, optionally replacing values if a replacer
+function is specified or optionally including only the specified properties if a replacer array
+is specified.
+
+**Example**
+
+```js
+const { EJSON } = require('bson');
+const Int32 = require('mongodb').Int32;
+const doc = { int32: new Int32(10) };
+
+// prints '{"int32":{"$numberInt":"10"}}'
+console.log(EJSON.stringify(doc, { relaxed: false }));
+
+// prints '{"int32":10}'
+console.log(EJSON.stringify(doc));
+```
+
+<a name="EJSON.serialize"></a>
+
+#### _EJSON_.serialize(bson, [options])
+
+| Param     | Type                | Description                                          |
+| --------- | ------------------- | ---------------------------------------------------- |
+| bson      | <code>object</code> | The object to serialize                              |
+| [options] | <code>object</code> | Optional settings passed to the `stringify` function |
+
+Serializes an object to an Extended JSON string, and reparse it as a JavaScript object.
+
+<a name="EJSON.deserialize"></a>
+
+#### _EJSON_.deserialize(ejson, [options])
+
+| Param     | Type                | Description                                  |
+| --------- | ------------------- | -------------------------------------------- |
+| ejson     | <code>object</code> | The Extended JSON object to deserialize      |
+| [options] | <code>object</code> | Optional settings passed to the parse method |
+
+Deserializes an Extended JSON object into a plain JavaScript object with native/BSON types
+
+## Error Handling
+
+It is our recommendation to use `BSONError.isBSONError()` checks on errors and to avoid relying on parsing `error.message` and `error.name` strings in your code. We guarantee `BSONError.isBSONError()` checks will pass according to semver guidelines, but errors may be sub-classed or their messages may change at any time, even patch releases, as we see fit to increase the helpfulness of the errors.
+
+Any new errors we add to the driver will directly extend an existing error class and no existing error will be moved to a different parent class outside of a major release.
+This means `BSONError.isBSONError()` will always be able to accurately capture the errors that our BSON library throws.
+
+Hypothetical example: A collection in our Db has an issue with UTF-8 data:
+
+```ts
+let documentCount = 0;
+const cursor = collection.find({}, { utf8Validation: true });
+try {
+  for await (const doc of cursor) documentCount += 1;
+} catch (error) {
+  if (BSONError.isBSONError(error)) {
+    console.log(`Found the troublemaker UTF-8!: ${documentCount} ${error.message}`);
+    return documentCount;
+  }
+  throw error;
+}
+```
+
+## React Native
+
+js-bson requires the `atob`, `btoa` and `TextEncoder` globals.  Older versions of React Native did not support these global objects, and so 
+[js-bson v5.4.0](https://github.com/mongodb/js-bson/releases/tag/v5.4.0) added support for bundled polyfills for these globals.  Newer versions
+of Hermes includes these globals, and so the polyfills for are no longer needed in the js-bson package.
+
+If you find yourself on a version of React Native that does not have these globals, either:
+
+1. polyfill them yourself
+2. upgrade to a later version of hermes
+3. use a version of js-bson `>=5.4.0` and `<7.0.0`
+
+One additional polyfill, `crypto.getRandomValues` is recommended and can be installed with the following command:
+
+```sh
+npm install --save react-native-get-random-values
+```
+
+The following snippet should be placed at the top of the entrypoint (by default this is the root `index.js` file) for React Native projects using the BSON library. These lines must be placed for any code that imports `BSON`.
+
+```typescript
+// Required Polyfills For ReactNative
+import 'react-native-get-random-values';
+```
+
+Finally, import the `BSON` library like so:
+
+```typescript
+import { BSON, EJSON } from 'bson';
+```
+
+This will cause React Native to import the `node_modules/bson/lib/bson.rn.cjs` bundle (see the `"react-native"` setting we have in the `"exports"` section of our [package.json](./package.json).)
+
+### Technical Note about React Native module import
+
+The `"exports"` definition in our `package.json` will result in BSON's CommonJS bundle being imported in a React Native project instead of the ES module bundle. Importing the CommonJS bundle is necessary because BSON's ES module bundle of BSON uses top-level await, which is not supported syntax in [React Native's runtime hermes](https://hermesengine.dev/).
+
+## FAQ
+
+#### Why does `undefined` get converted to `null`?
+
+The `undefined` BSON type has been [deprecated for many years](http://bsonspec.org/spec.html), so this library has dropped support for it. Use the `ignoreUndefined` option (for example, from the [driver](http://mongodb.github.io/node-mongodb-native/2.2/api/MongoClient.html#connect) ) to instead remove `undefined` keys.
+
+#### How do I add custom serialization logic?
+
+This library looks for `toBSON()` functions on every path, and calls the `toBSON()` function to get the value to serialize.
+
+```javascript
+const BSON = require('bson');
+
+class CustomSerialize {
+  toBSON() {
+    return 42;
+  }
+}
+
+const obj = { answer: new CustomSerialize() };
+// "{ answer: 42 }"
+console.log(BSON.deserialize(BSON.serialize(obj)));
+```

gateway/node_modules/bson/bson.d.ts

@@ -0,0 +1,1901 @@
+/**
+ * A class representation of the BSON Binary type.
+ * @public
+ * @category BSONType
+ */
+export declare class Binary extends BSONValue {
+    get _bsontype(): 'Binary';
+    /* Excluded from this release type: BSON_BINARY_SUBTYPE_DEFAULT */
+    /** Initial buffer default size */
+    static readonly BUFFER_SIZE = 256;
+    /** Default BSON type */
+    static readonly SUBTYPE_DEFAULT = 0;
+    /** Function BSON type */
+    static readonly SUBTYPE_FUNCTION = 1;
+    /**
+     * Legacy default BSON Binary type
+     * @deprecated BSON Binary subtype 2 is deprecated in the BSON specification
+     */
+    static readonly SUBTYPE_BYTE_ARRAY = 2;
+    /** Deprecated UUID BSON type @deprecated Please use SUBTYPE_UUID */
+    static readonly SUBTYPE_UUID_OLD = 3;
+    /** UUID BSON type */
+    static readonly SUBTYPE_UUID = 4;
+    /** MD5 BSON type */
+    static readonly SUBTYPE_MD5 = 5;
+    /** Encrypted BSON type */
+    static readonly SUBTYPE_ENCRYPTED = 6;
+    /** Column BSON type */
+    static readonly SUBTYPE_COLUMN = 7;
+    /** Sensitive BSON type */
+    static readonly SUBTYPE_SENSITIVE = 8;
+    /** Vector BSON type */
+    static readonly SUBTYPE_VECTOR = 9;
+    /** User BSON type */
+    static readonly SUBTYPE_USER_DEFINED = 128;
+    /** datatype of a Binary Vector (subtype: 9) */
+    static readonly VECTOR_TYPE: Readonly<{
+        readonly Int8: 3;
+        readonly Float32: 39;
+        readonly PackedBit: 16;
+    }>;
+    /**
+     * The bytes of the Binary value.
+     *
+     * The format of a Binary value in BSON is defined as:
+     * ```txt
+     * binary	::= int32 subtype (byte*)
+     * ```
+     *
+     * This `buffer` is the "(byte*)" segment.
+     *
+     * Unless the value is subtype 2, then deserialize will read the first 4 bytes as an int32 and set this to the remaining bytes.
+     *
+     * ```txt
+     * binary	::= int32 unsigned_byte(2) int32 (byte*)
+     * ```
+     *
+     * @see https://bsonspec.org/spec.html
+     */
+    buffer: Uint8Array;
+    /**
+     * The binary subtype.
+     *
+     * Current defined values are:
+     *
+     * - `unsigned_byte(0)` Generic binary subtype
+     * - `unsigned_byte(1)` Function
+     * - `unsigned_byte(2)` Binary (Deprecated)
+     * - `unsigned_byte(3)` UUID (Deprecated)
+     * - `unsigned_byte(4)` UUID
+     * - `unsigned_byte(5)` MD5
+     * - `unsigned_byte(6)` Encrypted BSON value
+     * - `unsigned_byte(7)` Compressed BSON column
+     * - `unsigned_byte(8)` Sensitive
+     * - `unsigned_byte(9)` Vector
+     * - `unsigned_byte(128)` - `unsigned_byte(255)` User defined
+     */
+    sub_type: number;
+    /**
+     * The Binary's `buffer` can be larger than the Binary's content.
+     * This property is used to determine where the content ends in the buffer.
+     */
+    position: number;
+    /**
+     * Create a new Binary instance.
+     * @param buffer - a buffer object containing the binary data.
+     * @param subType - the option binary type.
+     */
+    constructor(buffer?: BinarySequence, subType?: number);
+    /**
+     * Updates this binary with byte_value.
+     *
+     * @param byteValue - a single byte we wish to write.
+     */
+    put(byteValue: string | number | Uint8Array | number[]): void;
+    /**
+     * Writes a buffer to the binary.
+     *
+     * @param sequence - a string or buffer to be written to the Binary BSON object.
+     * @param offset - specify the binary of where to write the content.
+     */
+    write(sequence: BinarySequence, offset: number): void;
+    /**
+     * Returns a view of **length** bytes starting at **position**.
+     *
+     * @param position - read from the given position in the Binary.
+     * @param length - the number of bytes to read.
+     */
+    read(position: number, length: number): Uint8Array;
+    /** returns a view of the binary value as a Uint8Array */
+    value(): Uint8Array;
+    /** the length of the binary sequence */
+    length(): number;
+    toJSON(): string;
+    toString(encoding?: 'hex' | 'base64' | 'utf8' | 'utf-8'): string;
+    /* Excluded from this release type: toExtendedJSON */
+    toUUID(): UUID;
+    /** Creates an Binary instance from a hex digit string */
+    static createFromHexString(hex: string, subType?: number): Binary;
+    /** Creates an Binary instance from a base64 string */
+    static createFromBase64(base64: string, subType?: number): Binary;
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+    /**
+     * If this Binary represents a Int8 Vector (`binary.buffer[0] === Binary.VECTOR_TYPE.Int8`),
+     * returns a copy of the bytes in a new Int8Array.
+     *
+     * If the Binary is not a Vector, or the datatype is not Int8, an error is thrown.
+     */
+    toInt8Array(): Int8Array;
+    /**
+     * If this Binary represents a Float32 Vector (`binary.buffer[0] === Binary.VECTOR_TYPE.Float32`),
+     * returns a copy of the bytes in a new Float32Array.
+     *
+     * If the Binary is not a Vector, or the datatype is not Float32, an error is thrown.
+     */
+    toFloat32Array(): Float32Array;
+    /**
+     * If this Binary represents packed bit Vector (`binary.buffer[0] === Binary.VECTOR_TYPE.PackedBit`),
+     * returns a copy of the bytes that are packed bits.
+     *
+     * Use `toBits` to get the unpacked bits.
+     *
+     * If the Binary is not a Vector, or the datatype is not PackedBit, an error is thrown.
+     */
+    toPackedBits(): Uint8Array;
+    /**
+     * If this Binary represents a Packed bit Vector (`binary.buffer[0] === Binary.VECTOR_TYPE.PackedBit`),
+     * returns a copy of the bit unpacked into a new Int8Array.
+     *
+     * Use `toPackedBits` to get the bits still in packed form.
+     *
+     * If the Binary is not a Vector, or the datatype is not PackedBit, an error is thrown.
+     */
+    toBits(): Int8Array;
+    /**
+     * Constructs a Binary representing an Int8 Vector.
+     * @param array - The array to store as a view on the Binary class
+     */
+    static fromInt8Array(array: Int8Array): Binary;
+    /** Constructs a Binary representing an Float32 Vector. */
+    static fromFloat32Array(array: Float32Array): Binary;
+    /**
+     * Constructs a Binary representing a packed bit Vector.
+     *
+     * Use `fromBits` to pack an array of 1s and 0s.
+     */
+    static fromPackedBits(array: Uint8Array, padding?: number): Binary;
+    /**
+     * Constructs a Binary representing an Packed Bit Vector.
+     * @param array - The array of 1s and 0s to pack into the Binary instance
+     */
+    static fromBits(bits: ArrayLike<number>): Binary;
+}
+
+/** @public */
+export declare interface BinaryExtended {
+    $binary: {
+        subType: string;
+        base64: string;
+    };
+}
+
+/** @public */
+export declare interface BinaryExtendedLegacy {
+    $type: string;
+    $binary: string;
+}
+
+/** @public */
+export declare type BinarySequence = Uint8Array | number[];
+
+declare namespace BSON {
+    export {
+        setInternalBufferSize,
+        serialize,
+        serializeWithBufferAndIndex,
+        deserialize,
+        calculateObjectSize,
+        deserializeStream,
+        UUIDExtended,
+        BinaryExtended,
+        BinaryExtendedLegacy,
+        BinarySequence,
+        CodeExtended,
+        DBRefLike,
+        Decimal128Extended,
+        DoubleExtended,
+        EJSONOptions,
+        EJSONOptionsBase,
+        EJSONSerializeOptions,
+        EJSONParseOptions,
+        Int32Extended,
+        LongExtended,
+        MaxKeyExtended,
+        MinKeyExtended,
+        ObjectIdExtended,
+        ObjectIdLike,
+        BSONRegExpExtended,
+        BSONRegExpExtendedLegacy,
+        BSONSymbolExtended,
+        LongWithoutOverrides,
+        TimestampExtended,
+        TimestampOverrides,
+        LongWithoutOverridesClass,
+        SerializeOptions,
+        DeserializeOptions,
+        Code,
+        BSONSymbol,
+        DBRef,
+        Binary,
+        ObjectId,
+        UUID,
+        Long,
+        Timestamp,
+        Double,
+        Int32,
+        MinKey,
+        MaxKey,
+        BSONRegExp,
+        Decimal128,
+        NumberUtils,
+        ByteUtils,
+        BSONValue,
+        bsonType,
+        BSONTypeTag,
+        BSONError,
+        BSONVersionError,
+        BSONRuntimeError,
+        BSONOffsetError,
+        BSONType,
+        EJSON,
+        onDemand,
+        OnDemand,
+        Document,
+        CalculateObjectSizeOptions
+    }
+}
+export { BSON }
+
+/* Excluded from this release type: BSON_MAJOR_VERSION */
+
+/* Excluded from this release type: BSON_VERSION_SYMBOL */
+
+/**
+ * @public
+ * @experimental
+ */
+declare type BSONElement = [
+type: number,
+nameOffset: number,
+nameLength: number,
+offset: number,
+length: number
+];
+
+/**
+ * @public
+ * @category Error
+ *
+ * `BSONError` objects are thrown when BSON encounters an error.
+ *
+ * This is the parent class for all the other errors thrown by this library.
+ */
+export declare class BSONError extends Error {
+    /* Excluded from this release type: bsonError */
+    get name(): string;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+    /**
+     * @public
+     *
+     * All errors thrown from the BSON library inherit from `BSONError`.
+     * This method can assist with determining if an error originates from the BSON library
+     * even if it does not pass an `instanceof` check against this class' constructor.
+     *
+     * @param value - any javascript value that needs type checking
+     */
+    static isBSONError(value: unknown): value is BSONError;
+}
+
+/**
+ * @public
+ * @category Error
+ *
+ * @experimental
+ *
+ * An error generated when BSON bytes are invalid.
+ * Reports the offset the parser was able to reach before encountering the error.
+ */
+export declare class BSONOffsetError extends BSONError {
+    get name(): 'BSONOffsetError';
+    offset: number;
+    constructor(message: string, offset: number, options?: {
+        cause?: unknown;
+    });
+}
+
+/**
+ * A class representation of the BSON RegExp type.
+ * @public
+ * @category BSONType
+ */
+export declare class BSONRegExp extends BSONValue {
+    get _bsontype(): 'BSONRegExp';
+    pattern: string;
+    options: string;
+    /**
+     * @param pattern - The regular expression pattern to match
+     * @param options - The regular expression options
+     */
+    constructor(pattern: string, options?: string);
+    static parseOptions(options?: string): string;
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface BSONRegExpExtended {
+    $regularExpression: {
+        pattern: string;
+        options: string;
+    };
+}
+
+/** @public */
+export declare interface BSONRegExpExtendedLegacy {
+    $regex: string | BSONRegExp;
+    $options: string;
+}
+
+/**
+ * @public
+ * @category Error
+ *
+ * An error generated when BSON functions encounter an unexpected input
+ * or reaches an unexpected/invalid internal state
+ *
+ */
+export declare class BSONRuntimeError extends BSONError {
+    get name(): 'BSONRuntimeError';
+    constructor(message: string);
+}
+
+/**
+ * A class representation of the BSON Symbol type.
+ * @public
+ * @category BSONType
+ */
+export declare class BSONSymbol extends BSONValue {
+    get _bsontype(): 'BSONSymbol';
+    value: string;
+    /**
+     * @param value - the string representing the symbol.
+     */
+    constructor(value: string);
+    /** Access the wrapped string value. */
+    valueOf(): string;
+    toString(): string;
+    toJSON(): string;
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface BSONSymbolExtended {
+    $symbol: string;
+}
+
+/** @public */
+export declare const BSONType: Readonly<{
+    readonly double: 1;
+    readonly string: 2;
+    readonly object: 3;
+    readonly array: 4;
+    readonly binData: 5;
+    readonly undefined: 6;
+    readonly objectId: 7;
+    readonly bool: 8;
+    readonly date: 9;
+    readonly null: 10;
+    readonly regex: 11;
+    readonly dbPointer: 12;
+    readonly javascript: 13;
+    readonly symbol: 14;
+    readonly javascriptWithScope: 15;
+    readonly int: 16;
+    readonly timestamp: 17;
+    readonly long: 18;
+    readonly decimal: 19;
+    readonly minKey: -1;
+    readonly maxKey: 127;
+}>;
+
+/** @public */
+export declare type BSONType = (typeof BSONType)[keyof typeof BSONType];
+
+/** @public */
+export declare const bsonType: unique symbol;
+
+/** @public */
+export declare type BSONTypeTag = 'BSONRegExp' | 'BSONSymbol' | 'ObjectId' | 'Binary' | 'Decimal128' | 'Double' | 'Int32' | 'Long' | 'MaxKey' | 'MinKey' | 'Timestamp' | 'Code' | 'DBRef';
+
+/** @public */
+export declare abstract class BSONValue {
+    /** @public */
+    abstract get _bsontype(): BSONTypeTag;
+    get [bsonType](): this['_bsontype'];
+    /* Excluded from this release type: [BSON_VERSION_SYMBOL] */
+    /**
+     * @public
+     * Prints a human-readable string of BSON value information
+     * If invoked manually without node.js.inspect function, this will default to a modified JSON.stringify
+     */
+    abstract inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+    /* Excluded from this release type: toExtendedJSON */
+}
+
+/**
+ * @public
+ * @category Error
+ */
+export declare class BSONVersionError extends BSONError {
+    get name(): 'BSONVersionError';
+    constructor();
+}
+
+/**
+ * @public
+ * @experimental
+ *
+ * A collection of functions that help work with data in a Uint8Array.
+ * ByteUtils is configured at load time to use Node.js or Web based APIs for the internal implementations.
+ */
+export declare type ByteUtils = {
+    /** Checks if the given value is a Uint8Array. */
+    isUint8Array: (value: unknown) => value is Uint8Array;
+    /** Transforms the input to an instance of Buffer if running on node, otherwise Uint8Array */
+    toLocalBufferType: (buffer: Uint8Array | ArrayBufferView | ArrayBuffer) => Uint8Array;
+    /** Create empty space of size */
+    allocate: (size: number) => Uint8Array;
+    /** Create empty space of size, use pooled memory when available */
+    allocateUnsafe: (size: number) => Uint8Array;
+    /** Compare 2 Uint8Arrays lexicographically */
+    compare: (buffer1: Uint8Array, buffer2: Uint8Array) => -1 | 0 | 1;
+    /** Concatenating all the Uint8Arrays in new Uint8Array. */
+    concat: (list: Uint8Array[]) => Uint8Array;
+    /** Copy bytes from source Uint8Array to target Uint8Array */
+    copy: (source: Uint8Array, target: Uint8Array, targetStart?: number, sourceStart?: number, sourceEnd?: number) => number;
+    /** Check if two Uint8Arrays are deep equal */
+    equals: (a: Uint8Array, b: Uint8Array) => boolean;
+    /** Create a Uint8Array from an array of numbers */
+    fromNumberArray: (array: number[]) => Uint8Array;
+    /** Create a Uint8Array from a base64 string */
+    fromBase64: (base64: string) => Uint8Array;
+    /** Create a Uint8Array from a UTF8 string */
+    fromUTF8: (utf8: string) => Uint8Array;
+    /** Create a base64 string from bytes */
+    toBase64: (buffer: Uint8Array) => string;
+    /** **Legacy** binary strings are an outdated method of data transfer. Do not add public API support for interpreting this format */
+    fromISO88591: (codePoints: string) => Uint8Array;
+    /** **Legacy** binary strings are an outdated method of data transfer. Do not add public API support for interpreting this format */
+    toISO88591: (buffer: Uint8Array) => string;
+    /** Create a Uint8Array from a hex string */
+    fromHex: (hex: string) => Uint8Array;
+    /** Create a lowercase hex string from bytes */
+    toHex: (buffer: Uint8Array) => string;
+    /** Create a string from utf8 code units, fatal=true will throw an error if UTF-8 bytes are invalid, fatal=false will insert replacement characters */
+    toUTF8: (buffer: Uint8Array, start: number, end: number, fatal: boolean) => string;
+    /** Get the utf8 code unit count from a string if it were to be transformed to utf8 */
+    utf8ByteLength: (input: string) => number;
+    /** Encode UTF8 bytes generated from `source` string into `destination` at byteOffset. Returns the number of bytes encoded. */
+    encodeUTF8Into: (destination: Uint8Array, source: string, byteOffset: number) => number;
+    /** Generate a Uint8Array filled with random bytes with byteLength */
+    randomBytes: (byteLength: number) => Uint8Array;
+    /** Interprets `buffer` as an array of 32-bit values and swaps the byte order in-place. */
+    swap32: (buffer: Uint8Array) => Uint8Array;
+};
+
+/**
+ * This is the only ByteUtils that should be used across the rest of the BSON library.
+ *
+ * The type annotation is important here, it asserts that each of the platform specific
+ * utils implementations are compatible with the common one.
+ *
+ * @public
+ * @experimental
+ */
+export declare const ByteUtils: ByteUtils;
+
+/**
+ * Calculate the bson size for a passed in Javascript object.
+ *
+ * @param object - the Javascript object to calculate the BSON byte size for
+ * @returns size of BSON object in bytes
+ * @public
+ */
+export declare function calculateObjectSize(object: Document, options?: CalculateObjectSizeOptions): number;
+
+/** @public */
+export declare type CalculateObjectSizeOptions = Pick<SerializeOptions, 'serializeFunctions' | 'ignoreUndefined'>;
+
+/**
+ * A class representation of the BSON Code type.
+ * @public
+ * @category BSONType
+ */
+export declare class Code extends BSONValue {
+    get _bsontype(): 'Code';
+    code: string;
+    scope: Document | null;
+    /**
+     * @param code - a string or function.
+     * @param scope - an optional scope for the function.
+     */
+    constructor(code: string | Function, scope?: Document | null);
+    toJSON(): {
+        code: string;
+        scope?: Document;
+    };
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface CodeExtended {
+    $code: string;
+    $scope?: Document;
+}
+
+/**
+ * A class representation of the BSON DBRef type.
+ * @public
+ * @category BSONType
+ */
+export declare class DBRef extends BSONValue {
+    get _bsontype(): 'DBRef';
+    collection: string;
+    oid: ObjectId;
+    db?: string;
+    fields: Document;
+    /**
+     * @param collection - the collection name.
+     * @param oid - the reference ObjectId.
+     * @param db - optional db name, if omitted the reference is local to the current db.
+     */
+    constructor(collection: string, oid: ObjectId, db?: string, fields?: Document);
+    /* Excluded from this release type: namespace */
+    /* Excluded from this release type: namespace */
+    toJSON(): DBRefLike & Document;
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface DBRefLike {
+    $ref: string;
+    $id: ObjectId;
+    $db?: string;
+}
+
+/**
+ * A class representation of the BSON Decimal128 type.
+ * @public
+ * @category BSONType
+ */
+export declare class Decimal128 extends BSONValue {
+    get _bsontype(): 'Decimal128';
+    readonly bytes: Uint8Array;
+    /**
+     * @param bytes - a buffer containing the raw Decimal128 bytes in little endian order,
+     *                or a string representation as returned by .toString()
+     */
+    constructor(bytes: Uint8Array | string);
+    /**
+     * Create a Decimal128 instance from a string representation
+     *
+     * @param representation - a numeric string representation.
+     */
+    static fromString(representation: string): Decimal128;
+    /**
+     * Create a Decimal128 instance from a string representation, allowing for rounding to 34
+     * significant digits
+     *
+     * @example Example of a number that will be rounded
+     * ```ts
+     * > let d = Decimal128.fromString('37.499999999999999196428571428571375')
+     * Uncaught:
+     * BSONError: "37.499999999999999196428571428571375" is not a valid Decimal128 string - inexact rounding
+     * at invalidErr (/home/wajames/js-bson/lib/bson.cjs:1402:11)
+     * at Decimal128.fromStringInternal (/home/wajames/js-bson/lib/bson.cjs:1633:25)
+     * at Decimal128.fromString (/home/wajames/js-bson/lib/bson.cjs:1424:27)
+     *
+     * > d = Decimal128.fromStringWithRounding('37.499999999999999196428571428571375')
+     * new Decimal128("37.49999999999999919642857142857138")
+     * ```
+     * @param representation - a numeric string representation.
+     */
+    static fromStringWithRounding(representation: string): Decimal128;
+    private static _fromString;
+    /** Create a string representation of the raw Decimal128 value */
+    toString(): string;
+    toJSON(): Decimal128Extended;
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface Decimal128Extended {
+    $numberDecimal: string;
+}
+
+/**
+ * Deserialize data as BSON.
+ *
+ * @param buffer - the buffer containing the serialized set of BSON documents.
+ * @returns returns the deserialized Javascript Object.
+ * @public
+ */
+export declare function deserialize(buffer: Uint8Array, options?: DeserializeOptions): Document;
+
+/** @public */
+export declare interface DeserializeOptions {
+    /**
+     * when deserializing a Long return as a BigInt.
+     * @defaultValue `false`
+     */
+    useBigInt64?: boolean;
+    /**
+     * when deserializing a Long will fit it into a Number if it's smaller than 53 bits.
+     * @defaultValue `true`
+     */
+    promoteLongs?: boolean;
+    /**
+     * when deserializing a Binary will return it as a node.js Buffer instance.
+     * @defaultValue `false`
+     */
+    promoteBuffers?: boolean;
+    /**
+     * when deserializing will promote BSON values to their Node.js closest equivalent types.
+     * @defaultValue `true`
+     */
+    promoteValues?: boolean;
+    /**
+     * allow to specify if there what fields we wish to return as unserialized raw buffer.
+     * @defaultValue `null`
+     */
+    fieldsAsRaw?: Document;
+    /**
+     * return BSON regular expressions as BSONRegExp instances.
+     * @defaultValue `false`
+     */
+    bsonRegExp?: boolean;
+    /**
+     * allows the buffer to be larger than the parsed BSON object.
+     * @defaultValue `false`
+     */
+    allowObjectSmallerThanBufferSize?: boolean;
+    /**
+     * Offset into buffer to begin reading document from
+     * @defaultValue `0`
+     */
+    index?: number;
+    raw?: boolean;
+    /** Allows for opt-out utf-8 validation for all keys or
+     * specified keys. Must be all true or all false.
+     *
+     * @example
+     * ```js
+     * // disables validation on all keys
+     *  validation: { utf8: false }
+     *
+     * // enables validation only on specified keys a, b, and c
+     *  validation: { utf8: { a: true, b: true, c: true } }
+     *
+     *  // disables validation only on specified keys a, b
+     *  validation: { utf8: { a: false, b: false } }
+     * ```
+     */
+    validation?: {
+        utf8: boolean | Record<string, true> | Record<string, false>;
+    };
+}
+
+/**
+ * Deserialize stream data as BSON documents.
+ *
+ * @param data - the buffer containing the serialized set of BSON documents.
+ * @param startIndex - the start index in the data Buffer where the deserialization is to start.
+ * @param numberOfDocuments - number of documents to deserialize.
+ * @param documents - an array where to store the deserialized documents.
+ * @param docStartIndex - the index in the documents array from where to start inserting documents.
+ * @param options - additional options used for the deserialization.
+ * @returns next index in the buffer after deserialization **x** numbers of documents.
+ * @public
+ */
+export declare function deserializeStream(data: Uint8Array | ArrayBuffer, startIndex: number, numberOfDocuments: number, documents: Document[], docStartIndex: number, options: DeserializeOptions): number;
+
+/** @public */
+export declare interface Document {
+    [key: string]: any;
+}
+
+/**
+ * A class representation of the BSON Double type.
+ * @public
+ * @category BSONType
+ */
+export declare class Double extends BSONValue {
+    get _bsontype(): 'Double';
+    value: number;
+    /**
+     * Create a Double type
+     *
+     * @param value - the number we want to represent as a double.
+     */
+    constructor(value: number);
+    /**
+     * Attempt to create an double type from string.
+     *
+     * This method will throw a BSONError on any string input that is not representable as a IEEE-754 64-bit double.
+     * Notably, this method will also throw on the following string formats:
+     * - Strings in non-decimal and non-exponential formats (binary, hex, or octal digits)
+     * - Strings with characters other than numeric, floating point, or leading sign characters (Note: 'Infinity', '-Infinity', and 'NaN' input strings are still allowed)
+     * - Strings with leading and/or trailing whitespace
+     *
+     * Strings with leading zeros, however, are also allowed
+     *
+     * @param value - the string we want to represent as a double.
+     */
+    static fromString(value: string): Double;
+    /**
+     * Access the number value.
+     *
+     * @returns returns the wrapped double number.
+     */
+    valueOf(): number;
+    toJSON(): number;
+    toString(radix?: number): string;
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface DoubleExtended {
+    $numberDouble: string;
+}
+
+/** @public */
+export declare const EJSON: {
+    parse: typeof parse;
+    stringify: typeof stringify;
+    serialize: typeof EJSONserialize;
+    deserialize: typeof EJSONdeserialize;
+};
+
+/**
+ * Deserializes an Extended JSON object into a plain JavaScript object with native/BSON types
+ *
+ * @param ejson - The Extended JSON object to deserialize
+ * @param options - Optional settings passed to the parse method
+ */
+declare function EJSONdeserialize(ejson: Document, options?: EJSONParseOptions): any;
+
+/** @public */
+export declare type EJSONOptions = EJSONSerializeOptions & EJSONParseOptions;
+
+/** @public */
+export declare type EJSONOptionsBase = {
+    /**
+     * Output using the Extended JSON v1 spec
+     * @defaultValue `false`
+     */
+    legacy?: boolean;
+    /**
+     * Enable Extended JSON's `relaxed` mode, which attempts to return native JS types where possible, rather than BSON types
+     * @defaultValue `false`
+     */
+    relaxed?: boolean;
+};
+
+/** @public */
+export declare type EJSONParseOptions = EJSONOptionsBase & {
+    /**
+     * Enable native bigint support
+     * @defaultValue `false`
+     */
+    useBigInt64?: boolean;
+};
+
+/**
+ * Serializes an object to an Extended JSON string, and reparse it as a JavaScript object.
+ *
+ * @param value - The object to serialize
+ * @param options - Optional settings passed to the `stringify` function
+ */
+declare function EJSONserialize(value: any, options?: EJSONSerializeOptions): Document;
+
+/** @public */
+export declare type EJSONSerializeOptions = EJSONOptionsBase & {
+    /**
+     * Omits undefined values from the output instead of converting them to null
+     * @defaultValue `false`
+     */
+    ignoreUndefined?: boolean;
+};
+
+declare type InspectFn = (x: unknown, options?: unknown) => string;
+
+/**
+ * A class representation of a BSON Int32 type.
+ * @public
+ * @category BSONType
+ */
+export declare class Int32 extends BSONValue {
+    get _bsontype(): 'Int32';
+    value: number;
+    /**
+     * Create an Int32 type
+     *
+     * @param value - the number we want to represent as an int32.
+     */
+    constructor(value: number | string);
+    /**
+     * Attempt to create an Int32 type from string.
+     *
+     * This method will throw a BSONError on any string input that is not representable as an Int32.
+     * Notably, this method will also throw on the following string formats:
+     * - Strings in non-decimal formats (exponent notation, binary, hex, or octal digits)
+     * - Strings non-numeric and non-leading sign characters (ex: '2.0', '24,000')
+     * - Strings with leading and/or trailing whitespace
+     *
+     * Strings with leading zeros, however, are allowed.
+     *
+     * @param value - the string we want to represent as an int32.
+     */
+    static fromString(value: string): Int32;
+    /**
+     * Access the number value.
+     *
+     * @returns returns the wrapped int32 number.
+     */
+    valueOf(): number;
+    toString(radix?: number): string;
+    toJSON(): number;
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface Int32Extended {
+    $numberInt: string;
+}
+
+/**
+ * A class representing a 64-bit integer
+ * @public
+ * @category BSONType
+ * @remarks
+ * The internal representation of a long is the two given signed, 32-bit values.
+ * We use 32-bit pieces because these are the size of integers on which
+ * Javascript performs bit-operations.  For operations like addition and
+ * multiplication, we split each number into 16 bit pieces, which can easily be
+ * multiplied within Javascript's floating-point representation without overflow
+ * or change in sign.
+ * In the algorithms below, we frequently reduce the negative case to the
+ * positive case by negating the input(s) and then post-processing the result.
+ * Note that we must ALWAYS check specially whether those values are MIN_VALUE
+ * (-2^63) because -MIN_VALUE == MIN_VALUE (since 2^63 cannot be represented as
+ * a positive number, it overflows back into a negative).  Not handling this
+ * case would often result in infinite recursion.
+ * Common constant values ZERO, ONE, NEG_ONE, etc. are found as static properties on this class.
+ */
+export declare class Long extends BSONValue {
+    get _bsontype(): 'Long';
+    /** An indicator used to reliably determine if an object is a Long or not. */
+    get __isLong__(): boolean;
+    /**
+     * The high 32 bits as a signed value.
+     */
+    high: number;
+    /**
+     * The low 32 bits as a signed value.
+     */
+    low: number;
+    /**
+     * Whether unsigned or not.
+     */
+    unsigned: boolean;
+    /**
+     * Constructs a 64 bit two's-complement integer, given its low and high 32 bit values as *signed* integers.
+     *
+     * @param low - The low (signed) 32 bits of the long
+     * @param high - The high (signed) 32 bits of the long
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     */
+    constructor(low: number, high?: number, unsigned?: boolean);
+    /**
+     * Constructs a 64 bit two's-complement integer, given a bigint representation.
+     *
+     * @param value - BigInt representation of the long value
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     */
+    constructor(value: bigint, unsigned?: boolean);
+    /**
+     * Constructs a 64 bit two's-complement integer, given a string representation.
+     *
+     * @param value - String representation of the long value
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     */
+    constructor(value: string, unsigned?: boolean);
+    static TWO_PWR_24: Long;
+    /** Maximum unsigned value. */
+    static MAX_UNSIGNED_VALUE: Long;
+    /** Signed zero */
+    static ZERO: Long;
+    /** Unsigned zero. */
+    static UZERO: Long;
+    /** Signed one. */
+    static ONE: Long;
+    /** Unsigned one. */
+    static UONE: Long;
+    /** Signed negative one. */
+    static NEG_ONE: Long;
+    /** Maximum signed value. */
+    static MAX_VALUE: Long;
+    /** Minimum signed value. */
+    static MIN_VALUE: Long;
+    /**
+     * Returns a Long representing the 64 bit integer that comes by concatenating the given low and high bits.
+     * Each is assumed to use 32 bits.
+     * @param lowBits - The low 32 bits
+     * @param highBits - The high 32 bits
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @returns The corresponding Long value
+     */
+    static fromBits(lowBits: number, highBits: number, unsigned?: boolean): Long;
+    /**
+     * Returns a Long representing the given 32 bit integer value.
+     * @param value - The 32 bit integer in question
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @returns The corresponding Long value
+     */
+    static fromInt(value: number, unsigned?: boolean): Long;
+    /**
+     * Returns a Long representing the given value, provided that it is a finite number. Otherwise, zero is returned.
+     * @param value - The number in question
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @returns The corresponding Long value
+     */
+    static fromNumber(value: number, unsigned?: boolean): Long;
+    /**
+     * Returns a Long representing the given value, provided that it is a finite number. Otherwise, zero is returned.
+     * @param value - The number in question
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @returns The corresponding Long value
+     */
+    static fromBigInt(value: bigint, unsigned?: boolean): Long;
+    /* Excluded from this release type: _fromString */
+    /**
+     * Returns a signed Long representation of the given string, written using radix 10.
+     * Will throw an error if the given text is not exactly representable as a Long.
+     * Throws an error if any of the following conditions are true:
+     * - the string contains invalid characters for the radix 10
+     * - the string contains whitespace
+     * - the value the string represents is too large or too small to be a Long
+     * Unlike Long.fromString, this method does not coerce '+/-Infinity' and 'NaN' to Long.Zero
+     * @param str - The textual representation of the Long
+     * @returns The corresponding Long value
+     */
+    static fromStringStrict(str: string): Long;
+    /**
+     * Returns a Long representation of the given string, written using the radix 10.
+     * Will throw an error if the given parameters are not exactly representable as a Long.
+     * Throws an error if any of the following conditions are true:
+     * - the string contains invalid characters for the given radix
+     * - the string contains whitespace
+     * - the value the string represents is too large or too small to be a Long
+     * Unlike Long.fromString, this method does not coerce '+/-Infinity' and 'NaN' to Long.Zero
+     * @param str - The textual representation of the Long
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @returns The corresponding Long value
+     */
+    static fromStringStrict(str: string, unsigned?: boolean): Long;
+    /**
+     * Returns a signed Long representation of the given string, written using the specified radix.
+     * Will throw an error if the given parameters are not exactly representable as a Long.
+     * Throws an error if any of the following conditions are true:
+     * - the string contains invalid characters for the given radix
+     * - the string contains whitespace
+     * - the value the string represents is too large or too small to be a Long
+     * Unlike Long.fromString, this method does not coerce '+/-Infinity' and 'NaN' to Long.Zero
+     * @param str - The textual representation of the Long
+     * @param radix - The radix in which the text is written (2-36), defaults to 10
+     * @returns The corresponding Long value
+     */
+    static fromStringStrict(str: string, radix?: boolean): Long;
+    /**
+     * Returns a Long representation of the given string, written using the specified radix.
+     * Will throw an error if the given parameters are not exactly representable as a Long.
+     * Throws an error if any of the following conditions are true:
+     * - the string contains invalid characters for the given radix
+     * - the string contains whitespace
+     * - the value the string represents is too large or too small to be a Long
+     * Unlike Long.fromString, this method does not coerce '+/-Infinity' and 'NaN' to Long.Zero
+     * @param str - The textual representation of the Long
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @param radix - The radix in which the text is written (2-36), defaults to 10
+     * @returns The corresponding Long value
+     */
+    static fromStringStrict(str: string, unsigned?: boolean, radix?: number): Long;
+    /**
+     * Returns a signed Long representation of the given string, written using radix 10.
+     *
+     * If the input string is empty, this function will throw a BSONError.
+     *
+     * If input string does not have valid signed 64-bit Long representation, this method will return a coerced value:
+     * - inputs that overflow 64-bit signed long will be coerced to Long.MAX_VALUE and Long.MIN_VALUE respectively
+     * - 'NaN' or '+/-Infinity' are coerced to Long.ZERO
+     * - other invalid characters sequences have variable behavior
+     *
+     * @param str - The textual representation of the Long
+     * @returns The corresponding Long value
+     */
+    static fromString(str: string): Long;
+    /**
+     * Returns a signed Long representation of the given string, written using the provided radix.
+     *
+     * If the input string is empty or a provided radix is not within (2-36), this function will throw a BSONError.
+     *
+     * If input parameters do not have valid signed 64-bit Long representation, this method will return a coerced value:
+     * - inputs that overflow 64-bit signed long will be coerced to Long.MAX_VALUE and Long.MIN_VALUE respectively
+     * - if the radix is less than 24, 'NaN' is coerced to Long.ZERO
+     * - if the radix is less than 35, '+/-Infinity' inputs are coerced to Long.ZERO
+     * - other invalid characters sequences have variable behavior
+     * @param str - The textual representation of the Long
+     * @param radix - The radix in which the text is written (2-36), defaults to 10
+     * @returns The corresponding Long value
+     */
+    static fromString(str: string, radix?: number): Long;
+    /**
+     * Returns a Long representation of the given string, written using radix 10.
+     *
+     * If the input string is empty, this function will throw a BSONError.
+     *
+     * If input parameters do not have a valid 64-bit Long representation, this method will return a coerced value:
+     * - inputs that overflow 64-bit long will be coerced to max or min (if signed) values
+     * - if the radix is less than 24, 'NaN' is coerced to Long.ZERO
+     * - if the radix is less than 35, '+/-Infinity' inputs are coerced to Long.ZERO
+     * - other invalid characters sequences have variable behavior
+     * @param str - The textual representation of the Long
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @returns The corresponding Long value
+     */
+    static fromString(str: string, unsigned?: boolean): Long;
+    /**
+     * Returns a Long representation of the given string, written using the specified radix.
+     *
+     * If the input string is empty or a provided radix is not within (2-36), this function will throw a BSONError.
+     *
+     * If input parameters do not have a valid 64-bit Long representation, this method will return a coerced value:
+     * - inputs that overflow 64-bit long will be coerced to max or min (if signed) values
+     * - if the radix is less than 24, 'NaN' is coerced to Long.ZERO
+     * - if the radix is less than 35, '+/-Infinity' inputs are coerced to Long.ZERO
+     * - other invalid characters sequences have variable behavior
+     * @param str - The textual representation of the Long
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @param radix - The radix in which the text is written (2-36), defaults to 10
+     * @returns The corresponding Long value
+     */
+    static fromString(str: string, unsigned?: boolean, radix?: number): Long;
+    /**
+     * Creates a Long from its byte representation.
+     * @param bytes - Byte representation
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @param le - Whether little or big endian, defaults to big endian
+     * @returns The corresponding Long value
+     */
+    static fromBytes(bytes: number[], unsigned?: boolean, le?: boolean): Long;
+    /**
+     * Creates a Long from its little endian byte representation.
+     * @param bytes - Little endian byte representation
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @returns The corresponding Long value
+     */
+    static fromBytesLE(bytes: number[], unsigned?: boolean): Long;
+    /**
+     * Creates a Long from its big endian byte representation.
+     * @param bytes - Big endian byte representation
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     * @returns The corresponding Long value
+     */
+    static fromBytesBE(bytes: number[], unsigned?: boolean): Long;
+    /**
+     * Tests if the specified object is a Long.
+     */
+    static isLong(value: unknown): value is Long;
+    /**
+     * Converts the specified value to a Long.
+     * @param unsigned - Whether unsigned or not, defaults to signed
+     */
+    static fromValue(val: number | string | {
+        low: number;
+        high: number;
+        unsigned?: boolean;
+    }, unsigned?: boolean): Long;
+    /** Returns the sum of this and the specified Long. */
+    add(addend: string | number | Long | Timestamp): Long;
+    /**
+     * Returns the sum of this and the specified Long.
+     * @returns Sum
+     */
+    and(other: string | number | Long | Timestamp): Long;
+    /**
+     * Compares this Long's value with the specified's.
+     * @returns 0 if they are the same, 1 if the this is greater and -1 if the given one is greater
+     */
+    compare(other: string | number | Long | Timestamp): 0 | 1 | -1;
+    /** This is an alias of {@link Long.compare} */
+    comp(other: string | number | Long | Timestamp): 0 | 1 | -1;
+    /**
+     * Returns this Long divided by the specified. The result is signed if this Long is signed or unsigned if this Long is unsigned.
+     * @returns Quotient
+     */
+    divide(divisor: string | number | Long | Timestamp): Long;
+    /**This is an alias of {@link Long.divide} */
+    div(divisor: string | number | Long | Timestamp): Long;
+    /**
+     * Tests if this Long's value equals the specified's.
+     * @param other - Other value
+     */
+    equals(other: string | number | Long | Timestamp): boolean;
+    /** This is an alias of {@link Long.equals} */
+    eq(other: string | number | Long | Timestamp): boolean;
+    /** Gets the high 32 bits as a signed integer. */
+    getHighBits(): number;
+    /** Gets the high 32 bits as an unsigned integer. */
+    getHighBitsUnsigned(): number;
+    /** Gets the low 32 bits as a signed integer. */
+    getLowBits(): number;
+    /** Gets the low 32 bits as an unsigned integer. */
+    getLowBitsUnsigned(): number;
+    /** Gets the number of bits needed to represent the absolute value of this Long. */
+    getNumBitsAbs(): number;
+    /** Tests if this Long's value is greater than the specified's. */
+    greaterThan(other: string | number | Long | Timestamp): boolean;
+    /** This is an alias of {@link Long.greaterThan} */
+    gt(other: string | number | Long | Timestamp): boolean;
+    /** Tests if this Long's value is greater than or equal the specified's. */
+    greaterThanOrEqual(other: string | number | Long | Timestamp): boolean;
+    /** This is an alias of {@link Long.greaterThanOrEqual} */
+    gte(other: string | number | Long | Timestamp): boolean;
+    /** This is an alias of {@link Long.greaterThanOrEqual} */
+    ge(other: string | number | Long | Timestamp): boolean;
+    /** Tests if this Long's value is even. */
+    isEven(): boolean;
+    /** Tests if this Long's value is negative. */
+    isNegative(): boolean;
+    /** Tests if this Long's value is odd. */
+    isOdd(): boolean;
+    /** Tests if this Long's value is positive. */
+    isPositive(): boolean;
+    /** Tests if this Long's value equals zero. */
+    isZero(): boolean;
+    /** Tests if this Long's value is less than the specified's. */
+    lessThan(other: string | number | Long | Timestamp): boolean;
+    /** This is an alias of {@link Long#lessThan}. */
+    lt(other: string | number | Long | Timestamp): boolean;
+    /** Tests if this Long's value is less than or equal the specified's. */
+    lessThanOrEqual(other: string | number | Long | Timestamp): boolean;
+    /** This is an alias of {@link Long.lessThanOrEqual} */
+    lte(other: string | number | Long | Timestamp): boolean;
+    /** Returns this Long modulo the specified. */
+    modulo(divisor: string | number | Long | Timestamp): Long;
+    /** This is an alias of {@link Long.modulo} */
+    mod(divisor: string | number | Long | Timestamp): Long;
+    /** This is an alias of {@link Long.modulo} */
+    rem(divisor: string | number | Long | Timestamp): Long;
+    /**
+     * Returns the product of this and the specified Long.
+     * @param multiplier - Multiplier
+     * @returns Product
+     */
+    multiply(multiplier: string | number | Long | Timestamp): Long;
+    /** This is an alias of {@link Long.multiply} */
+    mul(multiplier: string | number | Long | Timestamp): Long;
+    /** Returns the Negation of this Long's value. */
+    negate(): Long;
+    /** This is an alias of {@link Long.negate} */
+    neg(): Long;
+    /** Returns the bitwise NOT of this Long. */
+    not(): Long;
+    /** Tests if this Long's value differs from the specified's. */
+    notEquals(other: string | number | Long | Timestamp): boolean;
+    /** This is an alias of {@link Long.notEquals} */
+    neq(other: string | number | Long | Timestamp): boolean;
+    /** This is an alias of {@link Long.notEquals} */
+    ne(other: string | number | Long | Timestamp): boolean;
+    /**
+     * Returns the bitwise OR of this Long and the specified.
+     */
+    or(other: number | string | Long): Long;
+    /**
+     * Returns this Long with bits shifted to the left by the given amount.
+     * @param numBits - Number of bits
+     * @returns Shifted Long
+     */
+    shiftLeft(numBits: number | Long): Long;
+    /** This is an alias of {@link Long.shiftLeft} */
+    shl(numBits: number | Long): Long;
+    /**
+     * Returns this Long with bits arithmetically shifted to the right by the given amount.
+     * @param numBits - Number of bits
+     * @returns Shifted Long
+     */
+    shiftRight(numBits: number | Long): Long;
+    /** This is an alias of {@link Long.shiftRight} */
+    shr(numBits: number | Long): Long;
+    /**
+     * Returns this Long with bits logically shifted to the right by the given amount.
+     * @param numBits - Number of bits
+     * @returns Shifted Long
+     */
+    shiftRightUnsigned(numBits: Long | number): Long;
+    /** This is an alias of {@link Long.shiftRightUnsigned} */
+    shr_u(numBits: number | Long): Long;
+    /** This is an alias of {@link Long.shiftRightUnsigned} */
+    shru(numBits: number | Long): Long;
+    /**
+     * Returns the difference of this and the specified Long.
+     * @param subtrahend - Subtrahend
+     * @returns Difference
+     */
+    subtract(subtrahend: string | number | Long | Timestamp): Long;
+    /** This is an alias of {@link Long.subtract} */
+    sub(subtrahend: string | number | Long | Timestamp): Long;
+    /** Converts the Long to a 32 bit integer, assuming it is a 32 bit integer. */
+    toInt(): number;
+    /** Converts the Long to a the nearest floating-point representation of this value (double, 53 bit mantissa). */
+    toNumber(): number;
+    /** Converts the Long to a BigInt (arbitrary precision). */
+    toBigInt(): bigint;
+    /**
+     * Converts this Long to its byte representation.
+     * @param le - Whether little or big endian, defaults to big endian
+     * @returns Byte representation
+     */
+    toBytes(le?: boolean): number[];
+    /**
+     * Converts this Long to its little endian byte representation.
+     * @returns Little endian byte representation
+     */
+    toBytesLE(): number[];
+    /**
+     * Converts this Long to its big endian byte representation.
+     * @returns Big endian byte representation
+     */
+    toBytesBE(): number[];
+    /**
+     * Converts this Long to signed.
+     */
+    toSigned(): Long;
+    /**
+     * Converts the Long to a string written in the specified radix.
+     * @param radix - Radix (2-36), defaults to 10
+     * @throws RangeError If `radix` is out of range
+     */
+    toString(radix?: number): string;
+    /** Converts this Long to unsigned. */
+    toUnsigned(): Long;
+    /** Returns the bitwise XOR of this Long and the given one. */
+    xor(other: Long | number | string): Long;
+    /** This is an alias of {@link Long.isZero} */
+    eqz(): boolean;
+    /** This is an alias of {@link Long.lessThanOrEqual} */
+    le(other: string | number | Long | Timestamp): boolean;
+    toExtendedJSON(options?: EJSONOptions): number | LongExtended;
+    static fromExtendedJSON(doc: {
+        $numberLong: string;
+    }, options?: EJSONOptions): number | Long | bigint;
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface LongExtended {
+    $numberLong: string;
+}
+
+/** @public */
+export declare type LongWithoutOverrides = new (low: unknown, high?: number | boolean, unsigned?: boolean) => {
+    [P in TimestampKept]: Long[P];
+};
+
+/** @public */
+export declare const LongWithoutOverridesClass: LongWithoutOverrides;
+
+/**
+ * A class representation of the BSON MaxKey type.
+ * @public
+ * @category BSONType
+ */
+export declare class MaxKey extends BSONValue {
+    get _bsontype(): 'MaxKey';
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(): string;
+}
+
+/** @public */
+export declare interface MaxKeyExtended {
+    $maxKey: 1;
+}
+
+/**
+ * A class representation of the BSON MinKey type.
+ * @public
+ * @category BSONType
+ */
+export declare class MinKey extends BSONValue {
+    get _bsontype(): 'MinKey';
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(): string;
+}
+
+/** @public */
+export declare interface MinKeyExtended {
+    $minKey: 1;
+}
+
+/**
+ * @experimental
+ * @public
+ *
+ * A collection of functions that get or set various numeric types and bit widths from a Uint8Array.
+ */
+export declare type NumberUtils = {
+    /** Is true if the current system is big endian. */
+    isBigEndian: boolean;
+    /**
+     * Parses a signed int32 at offset. Throws a `RangeError` if value is negative.
+     */
+    getNonnegativeInt32LE: (source: Uint8Array, offset: number) => number;
+    getInt32LE: (source: Uint8Array, offset: number) => number;
+    getUint32LE: (source: Uint8Array, offset: number) => number;
+    getUint32BE: (source: Uint8Array, offset: number) => number;
+    getBigInt64LE: (source: Uint8Array, offset: number) => bigint;
+    getFloat64LE: (source: Uint8Array, offset: number) => number;
+    setInt32BE: (destination: Uint8Array, offset: number, value: number) => 4;
+    setInt32LE: (destination: Uint8Array, offset: number, value: number) => 4;
+    setBigInt64LE: (destination: Uint8Array, offset: number, value: bigint) => 8;
+    setFloat64LE: (destination: Uint8Array, offset: number, value: number) => 8;
+};
+
+/**
+ * Number parsing and serializing utilities.
+ *
+ * @experimental
+ * @public
+ */
+export declare const NumberUtils: NumberUtils;
+
+/**
+ * A class representation of the BSON ObjectId type.
+ * @public
+ * @category BSONType
+ */
+export declare class ObjectId extends BSONValue {
+    get _bsontype(): 'ObjectId';
+    /* Excluded from this release type: index */
+    /* Excluded from this release type: PROCESS_UNIQUE */
+    /* Excluded from this release type: resetState */
+    static cacheHexString: boolean;
+    /* Excluded from this release type: i0 */
+    /* Excluded from this release type: i1 */
+    /* Excluded from this release type: i2 */
+    /* Excluded from this release type: i3 */
+    /* Excluded from this release type: setFromBytes */
+    /* Excluded from this release type: setFromHex */
+    /** To generate a new ObjectId, use ObjectId() with no argument. */
+    constructor();
+    /**
+     * Create ObjectId from a 24 character hex string.
+     *
+     * @param inputId - A 24 character hex string.
+     */
+    constructor(inputId: string);
+    /**
+     * Create ObjectId from the BSON ObjectId type.
+     *
+     * @param inputId - The BSON ObjectId type.
+     */
+    constructor(inputId: ObjectId);
+    /**
+     * Create ObjectId from the object type that has the toHexString method.
+     *
+     * @param inputId - The ObjectIdLike type.
+     */
+    constructor(inputId: ObjectIdLike);
+    /**
+     * Create ObjectId from a 12 byte binary Buffer.
+     *
+     * @param inputId - A 12 byte binary Buffer.
+     */
+    constructor(inputId: Uint8Array);
+    /**
+     * Implementation overload.
+     *
+     * @param inputId - All input types that are used in the constructor implementation.
+     */
+    constructor(inputId?: string | ObjectId | ObjectIdLike | Uint8Array);
+    /* Excluded from this release type: __constructor */
+    /**
+     * The ObjectId bytes, rebuilt from the packed integer fields on each access. Every read
+     * returns a freshly allocated 12-byte buffer.
+     * @readonly
+     */
+    get id(): Uint8Array;
+    set id(value: Uint8Array);
+    /* Excluded from this release type: validateHexString */
+    /** Returns the ObjectId id as a 24 lowercase character hex string representation */
+    toHexString(): string;
+    /* Excluded from this release type: getInc */
+    /**
+     * Generate a 12 byte id buffer used in ObjectId's
+     *
+     * @param time - pass in a second based timestamp.
+     */
+    static generate(time?: number): Uint8Array;
+    /**
+     * Converts the id into a 24 character hex string for printing, unless encoding is provided.
+     * @param encoding - hex or base64
+     */
+    toString(encoding?: 'hex' | 'base64'): string;
+    /** Converts to its JSON the 24 character hex string representation. */
+    toJSON(): string;
+    /* Excluded from this release type: is */
+    /**
+     * Compares the equality of this ObjectId with `otherID`.
+     *
+     * @param otherId - ObjectId instance to compare against.
+     */
+    equals(otherId: string | ObjectId | ObjectIdLike | undefined | null): boolean;
+    /** Returns the generation date (accurate up to the second) that this ID was generated. */
+    getTimestamp(): Date;
+    /* Excluded from this release type: createPk */
+    /* Excluded from this release type: serializeInto */
+    /**
+     * Creates an ObjectId from a second based number, with the rest of the ObjectId zeroed out. Used for comparisons or sorting the ObjectId.
+     *
+     * @param time - an integer number representing a number of seconds.
+     */
+    static createFromTime(time: number): ObjectId;
+    /**
+     * Creates an ObjectId from a hex string representation of an ObjectId.
+     *
+     * @param hexString - create a ObjectId from a passed in 24 character hexstring.
+     */
+    static createFromHexString(hexString: string): ObjectId;
+    /** Creates an ObjectId instance from a base64 string */
+    static createFromBase64(base64: string): ObjectId;
+    /**
+     * Checks if a value can be used to create a valid bson ObjectId
+     * @param id - any JS value
+     */
+    static isValid(id: string | ObjectId | ObjectIdLike | Uint8Array): boolean;
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    /* Excluded from this release type: isCached */
+    /**
+     * Converts to a string representation of this Id.
+     *
+     * @returns return the 24 character hex string representation.
+     */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare interface ObjectIdExtended {
+    $oid: string;
+}
+
+/** @public */
+export declare interface ObjectIdLike {
+    id: string | Uint8Array;
+    __id?: string;
+    toHexString(): string;
+}
+
+/**
+ * @experimental
+ * @public
+ *
+ * A new set of BSON APIs that are currently experimental and not intended for production use.
+ */
+export declare type OnDemand = {
+    parseToElements: (this: void, bytes: Uint8Array, startOffset?: number) => Iterable<BSONElement>;
+    BSONElement: BSONElement;
+    ByteUtils: ByteUtils;
+    NumberUtils: NumberUtils;
+};
+
+/**
+ * @experimental
+ * @public
+ */
+export declare const onDemand: OnDemand;
+
+/**
+ * Parse an Extended JSON string, constructing the JavaScript value or object described by that
+ * string.
+ *
+ * @example
+ * ```js
+ * const { EJSON } = require('bson');
+ * const text = '{ "int32": { "$numberInt": "10" } }';
+ *
+ * // prints { int32: { [String: '10'] _bsontype: 'Int32', value: '10' } }
+ * console.log(EJSON.parse(text, { relaxed: false }));
+ *
+ * // prints { int32: 10 }
+ * console.log(EJSON.parse(text));
+ * ```
+ */
+declare function parse(text: string, options?: EJSONParseOptions): any;
+
+/**
+ * Serialize a Javascript object.
+ *
+ * @param object - the Javascript object to serialize.
+ * @returns Buffer object containing the serialized object.
+ * @public
+ */
+export declare function serialize(object: Document, options?: SerializeOptions): Uint8Array;
+
+/** @public */
+export declare interface SerializeOptions {
+    /**
+     * the serializer will check if keys are valid.
+     * @defaultValue `false`
+     */
+    checkKeys?: boolean;
+    /**
+     * serialize the javascript functions
+     * @defaultValue `false`
+     */
+    serializeFunctions?: boolean;
+    /**
+     * serialize will not emit undefined fields
+     * note that the driver sets this to `false`
+     * @defaultValue `true`
+     */
+    ignoreUndefined?: boolean;
+    /* Excluded from this release type: minInternalBufferSize */
+    /**
+     * the index in the buffer where we wish to start serializing into
+     * @defaultValue `0`
+     */
+    index?: number;
+}
+
+/**
+ * Serialize a Javascript object using a predefined Buffer and index into the buffer,
+ * useful when pre-allocating the space for serialization.
+ *
+ * @param object - the Javascript object to serialize.
+ * @param finalBuffer - the Buffer you pre-allocated to store the serialized BSON object.
+ * @returns the index pointing to the last written byte in the buffer.
+ * @public
+ */
+export declare function serializeWithBufferAndIndex(object: Document, finalBuffer: Uint8Array, options?: SerializeOptions): number;
+
+/**
+ * Sets the size of the internal serialization buffer.
+ *
+ * @param size - The desired size for the internal serialization buffer in bytes
+ * @public
+ */
+export declare function setInternalBufferSize(size: number): void;
+
+/**
+ * Converts a BSON document to an Extended JSON string, optionally replacing values if a replacer
+ * function is specified or optionally including only the specified properties if a replacer array
+ * is specified.
+ *
+ * @param value - The value to convert to extended JSON
+ * @param replacer - A function that alters the behavior of the stringification process, or an array of String and Number objects that serve as a whitelist for selecting/filtering the properties of the value object to be included in the JSON string. If this value is null or not provided, all properties of the object are included in the resulting JSON string
+ * @param space - A String or Number object that's used to insert white space into the output JSON string for readability purposes.
+ * @param options - Optional settings
+ *
+ * @example
+ * ```js
+ * const { EJSON } = require('bson');
+ * const Int32 = require('mongodb').Int32;
+ * const doc = { int32: new Int32(10) };
+ *
+ * // prints '{"int32":{"$numberInt":"10"}}'
+ * console.log(EJSON.stringify(doc, { relaxed: false }));
+ *
+ * // prints '{"int32":10}'
+ * console.log(EJSON.stringify(doc));
+ *
+ * // prints '{"int32":{"$numberInt":"10"}}' with 2 space indentation
+ * console.log(EJSON.stringify(doc, { relaxed: false }, 2));
+ * ```
+ */
+declare function stringify(value: any, replacer?: (number | string)[] | ((this: any, key: string, value: any) => any) | null, space?: string | number, options?: EJSONSerializeOptions): string;
+
+declare function stringify(value: any, replacer?: (number | string)[] | ((this: any, key: string, value: any) => any) | null, options?: EJSONSerializeOptions): string;
+
+declare function stringify(value: any, options?: EJSONSerializeOptions, space?: string | number): string;
+
+/**
+ * @public
+ * @category BSONType
+ *
+ * A special type for _internal_ MongoDB use and is **not** associated with the regular Date type.
+ */
+export declare class Timestamp extends LongWithoutOverridesClass {
+    get _bsontype(): 'Timestamp';
+    get [bsonType](): 'Timestamp';
+    /**
+     * @deprecated Use `Long.MAX_UNSIGNED_VALUE` instead.
+     */
+    static readonly MAX_VALUE: Long;
+    /**
+     * An incrementing ordinal for operations within a given second.
+     */
+    get i(): number;
+    /**
+     * A `time_t` value measuring seconds since the Unix epoch
+     */
+    get t(): number;
+    /**
+     * @param int - A 64-bit bigint representing the Timestamp.
+     */
+    constructor(int: bigint);
+    /**
+     * @param long - A 64-bit Long representing the Timestamp.
+     */
+    constructor(long: Long);
+    /**
+     * @param value - A pair of two values indicating timestamp and increment.
+     */
+    constructor(value: {
+        t: number;
+        i: number;
+    });
+    toJSON(): {
+        $timestamp: string;
+    };
+    /**
+     * Returns a Timestamp represented by the given (32-bit) integer value.
+     * @deprecated Stores `value` in the low 32 bits (increment), leaving t = 0. Use `new Timestamp({ t, i })` or `Timestamp.fromBits(lowBits, highBits)` for explicit construction.
+     */
+    static fromInt(value: number): Timestamp;
+    /**
+     * Returns a Timestamp representing the given number value, provided that it is a finite number. Otherwise, zero is returned.
+     * @deprecated Splits `value` across (t, i) as a uint64; the result rarely matches user intent. Use `new Timestamp({ t, i })` or `Timestamp.fromBits(lowBits, highBits)` for explicit construction.
+     */
+    static fromNumber(value: number): Timestamp;
+    /**
+     * Returns a Timestamp for the given high and low bits. Each is assumed to use 32 bits.
+     *
+     * @param lowBits - the low 32-bits.
+     * @param highBits - the high 32-bits.
+     */
+    static fromBits(lowBits: number, highBits: number): Timestamp;
+    /**
+     * Returns a Timestamp from the given string, optionally using the given radix.
+     *
+     * @param str - the textual representation of the Timestamp.
+     * @param optRadix - the radix in which the text is written.
+     */
+    static fromString(str: string, optRadix: number): Timestamp;
+    /* Excluded from this release type: toExtendedJSON */
+    /* Excluded from this release type: fromExtendedJSON */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    add: Long['add'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    subtract: Long['subtract'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    sub: Long['sub'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    multiply: Long['multiply'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    mul: Long['mul'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    divide: Long['divide'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    div: Long['div'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    modulo: Long['modulo'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    mod: Long['mod'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    rem: Long['rem'];
+    /** @deprecated Not applicable to Timestamp as the underlying Long is always unsigned. */
+    negate: Long['negate'];
+    /** @deprecated Not applicable to Timestamp as the underlying Long is always unsigned. */
+    neg: Long['neg'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    and: Long['and'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    or: Long['or'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    xor: Long['xor'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    not: Long['not'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    shiftLeft: Long['shiftLeft'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    shl: Long['shl'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    shiftRight: Long['shiftRight'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    shr: Long['shr'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    shiftRightUnsigned: Long['shiftRightUnsigned'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    shr_u: Long['shr_u'];
+    /** @deprecated Not applicable to Timestamp; Timestamp is not intended to be used as a Long. */
+    shru: Long['shru'];
+    /** @deprecated Not applicable to Timestamp as the underlying Long is always unsigned. */
+    toSigned: Long['toSigned'];
+    /** @deprecated Not applicable to Timestamp as the underlying Long is always unsigned (this is a no-op). */
+    toUnsigned: Long['toUnsigned'];
+    /** @deprecated Not applicable to Timestamp as the underlying Long is always unsigned (is always false). */
+    isNegative: Long['isNegative'];
+    /** @deprecated Not applicable to Timestamp as the underlying Long is always unsigned (is always true). */
+    isPositive: Long['isPositive'];
+    /** @deprecated Not applicable to Timestamp as the underlying Long is always unsigned (is always true). */
+    unsigned: Long['unsigned'];
+    /** @deprecated Not applicable to Timestamp; use `.t` for seconds since the Unix epoch, or `.i` for the increment ordinal. */
+    toInt: Long['toInt'];
+    /** @deprecated Not applicable to Timestamp; use `.t` for seconds since the Unix epoch, or `.i` for the increment ordinal. */
+    toNumber: Long['toNumber'];
+    /** @deprecated Not applicable to Timestamp; use `.t` for seconds since the Unix epoch, or `.i` for the increment ordinal. */
+    toBytes: Long['toBytes'];
+    /** @deprecated Not applicable to Timestamp; use `.t` for seconds since the Unix epoch, or `.i` for the increment ordinal. */
+    toBytesLE: Long['toBytesLE'];
+    /** @deprecated Not applicable to Timestamp; use `.t` for seconds since the Unix epoch, or `.i` for the increment ordinal. */
+    toBytesBE: Long['toBytesBE'];
+    /** @deprecated Incompatible with Timestamp: returns a signed integer, but Timestamp is always unsigned. Use `.t` for seconds since the Unix epoch. */
+    getHighBits: Long['getHighBits'];
+    /** @deprecated Not applicable to Timestamp; use `.t` for seconds since the Unix epoch. */
+    getHighBitsUnsigned: Long['getHighBitsUnsigned'];
+    /** @deprecated Incompatible with Timestamp: returns a signed integer, but Timestamp is always unsigned. Use `.i` for the increment ordinal. */
+    getLowBits: Long['getLowBits'];
+    /** @deprecated Not applicable to Timestamp; use `.i` for the increment ordinal. */
+    getLowBitsUnsigned: Long['getLowBitsUnsigned'];
+    /** @deprecated Not applicable to Timestamp; use `.i` instead. */
+    low: Long['low'];
+    /** @deprecated Not applicable to Timestamp; use `.t` instead. */
+    high: Long['high'];
+    /** @deprecated Use .compare() for general comparison, or .equals(), .lessThan(), .greaterThan() for specific cases. */
+    comp: Long['comp'];
+    /** @deprecated Compare `.t` and `.i` against `0` explicitly. */
+    isZero: Long['isZero'];
+    /** @deprecated Compare `.t` and `.i` against `0` explicitly. */
+    eqz: Long['eqz'];
+    /** @deprecated Not applicable to Timestamp. Use the bsonType symbol or _bsontype === 'Timestamp' to identify a Timestamp. */
+    __isLong__: Long['__isLong__'];
+    /** @deprecated Not applicable to Timestamp. */
+    getNumBitsAbs: Long['getNumBitsAbs'];
+    /** @deprecated Not applicable to Timestamp; tests parity of the increment only. */
+    isEven: Long['isEven'];
+    /** @deprecated Not applicable to Timestamp; tests parity of the increment only. */
+    isOdd: Long['isOdd'];
+}
+
+/** @public */
+export declare interface TimestampExtended {
+    $timestamp: {
+        t: number;
+        i: number;
+    };
+}
+
+/**
+ * @public
+ *
+ * Inherited `Long` members surfaced on `Timestamp`.
+ * When `Long` gains a new member: add it here if it should pass through, or
+ * add a `@deprecated declare` line on the `Timestamp` class if it should be
+ * surfaced as deprecated. Anything left unclassified is silently dropped from
+ * the public type — preventing accidental behavioral bleed-through.
+ */
+declare type TimestampKept = 'toBigInt' | 'toString' | 'compare' | 'equals' | 'eq' | 'notEquals' | 'neq' | 'ne' | 'lessThan' | 'lt' | 'lessThanOrEqual' | 'lte' | 'le' | 'greaterThan' | 'gt' | 'greaterThanOrEqual' | 'gte' | 'ge';
+
+/**
+ * @public
+ * @deprecated This type is no longer used internally and will be removed in a future version.
+ */
+export declare type TimestampOverrides = '_bsontype' | 'toExtendedJSON' | 'fromExtendedJSON' | 'inspect' | typeof bsonType;
+
+/**
+ * A class representation of the BSON UUID type.
+ * @public
+ */
+export declare class UUID extends Binary {
+    /**
+     * Create a UUID type
+     *
+     * When the argument to the constructor is omitted a random v4 UUID will be generated.
+     *
+     * @param input - Can be a 32 or 36 character hex string (dashes excluded/included) or a 16 byte binary Buffer.
+     */
+    constructor(input?: string | Uint8Array | UUID);
+    /**
+     * The UUID bytes
+     * @readonly
+     */
+    get id(): Uint8Array;
+    set id(value: Uint8Array);
+    /**
+     * Returns the UUID id as a 32 or 36 character hex string representation, excluding/including dashes (defaults to 36 character dash separated)
+     * @param includeDashes - should the string exclude dash-separators.
+     */
+    toHexString(includeDashes?: boolean): string;
+    /**
+     * Converts the id into a 36 character (dashes included) hex string, unless a encoding is specified.
+     */
+    toString(encoding?: 'hex' | 'base64'): string;
+    /**
+     * Converts the id into its JSON string representation.
+     * A 36 character (dashes included) hex string in the format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+     */
+    toJSON(): string;
+    /**
+     * Compares the equality of this UUID with `otherID`.
+     *
+     * @param otherId - UUID instance to compare against.
+     */
+    equals(otherId: string | Uint8Array | UUID): boolean;
+    /**
+     * Creates a Binary instance from the current UUID.
+     */
+    toBinary(): Binary;
+    /**
+     * Generates a populated buffer containing a v4 uuid
+     */
+    static generate(): Uint8Array;
+    /**
+     * Checks if a value is a valid bson UUID
+     * @param input - UUID, string or Buffer to validate.
+     */
+    static isValid(input: string | Uint8Array | UUID | Binary): boolean;
+    /**
+     * Creates an UUID from a hex string representation of an UUID.
+     * @param hexString - 32 or 36 character hex string (dashes excluded/included).
+     */
+    static createFromHexString(hexString: string): UUID;
+    /** Creates an UUID from a base64 string representation of an UUID. */
+    static createFromBase64(base64: string): UUID;
+    /* Excluded from this release type: bytesFromString */
+    /* Excluded from this release type: isValidUUIDString */
+    /**
+     * Converts to a string representation of this Id.
+     *
+     * @returns return the 36 character hex string representation.
+     *
+     */
+    inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+}
+
+/** @public */
+export declare type UUIDExtended = {
+    $uuid: string;
+};
+
+export { }

gateway/node_modules/bson/etc/prepare.js

@@ -0,0 +1,19 @@
+#! /usr/bin/env node
+var cp = require('child_process');
+var fs = require('fs');
+
+var nodeMajorVersion = +process.version.match(/^v(\d+)\.\d+/)[1];
+
+if (fs.existsSync('src') && nodeMajorVersion >= 10) {
+  cp.spawnSync('npm', ['run', 'build'], { stdio: 'inherit', shell: true });
+} else {
+  if (!fs.existsSync('lib')) {
+    console.warn('BSON: No compiled javascript present, the library is not installed correctly.');
+    if (nodeMajorVersion < 10) {
+      console.warn(
+        'This library can only be compiled in nodejs version 10 or later, currently running: ' +
+          nodeMajorVersion
+      );
+    }
+  }
+}

gateway/node_modules/bson/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "bson",
+  "description": "A bson parser for node.js and the browser",
+  "keywords": [
+    "mongodb",
+    "bson",
+    "parser"
+  ],
+  "files": [
+    "lib",
+    "src",
+    "bson.d.ts",
+    "etc/prepare.js",
+    "vendor"
+  ],
+  "types": "bson.d.ts",
+  "version": "7.3.2",
+  "author": {
+    "name": "The MongoDB NodeJS Team",
+    "email": "dbx-node@mongodb.com"
+  },
+  "license": "Apache-2.0",
+  "contributors": [],
+  "repository": "mongodb/js-bson",
+  "bugs": {
+    "url": "https://jira.mongodb.org/projects/NODE/issues/"
+  },
+  "devDependencies": {
+    "@istanbuljs/nyc-config-typescript": "^1.0.2",
+    "@microsoft/api-extractor": "^7.52.5",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/chai": "^4.3.17",
+    "@types/mocha": "^10.0.7",
+    "@types/node": "^24.2.1",
+    "@types/sinon": "^21.0.0",
+    "@types/sinon-chai": "^3.2.12",
+    "@typescript-eslint/eslint-plugin": "^8.31.1",
+    "@typescript-eslint/parser": "^8.31.1",
+    "benchmark": "^2.1.4",
+    "chai": "^4.4.1",
+    "chalk": "^5.3.0",
+    "dbx-js-tools": "github:mongodb-js/dbx-js-tools#main",
+    "eslint": "^9.33.0",
+    "eslint-config-prettier": "^10.1.2",
+    "eslint-plugin-prettier": "^5.2.6",
+    "eslint-plugin-tsdoc": "^0.5.2",
+    "magic-string": "^0.30.11",
+    "mocha": "^11.7.1",
+    "node-fetch": "^3.3.2",
+    "nyc": "^17.1.0",
+    "prettier": "^3.5.3",
+    "rollup": "^4.40.1",
+    "sinon": "^21.0.0",
+    "sinon-chai": "^3.7.0",
+    "source-map-support": "^0.5.21",
+    "tar": "^7.4.3",
+    "ts-node": "^10.9.2",
+    "tsd": "^0.33.0",
+    "typescript": "^5.8.3",
+    "typescript-cached-transpile": "0.0.6",
+    "uuid": "^13.0.0"
+  },
+  "tsd": {
+    "directory": "test/types",
+    "compilerOptions": {
+      "strict": true,
+      "target": "esnext",
+      "module": "commonjs",
+      "moduleResolution": "node"
+    }
+  },
+  "config": {
+    "native": false
+  },
+  "main": "./lib/bson.cjs",
+  "module": "./lib/bson.node.mjs",
+  "exports": {
+    "browser": {
+      "types": "./bson.d.ts",
+      "default": "./lib/bson.mjs"
+    },
+    "react-native": "./lib/bson.rn.cjs",
+    "default": {
+      "types": "./bson.d.ts",
+      "import": "./lib/bson.node.mjs",
+      "require": "./lib/bson.cjs"
+    }
+  },
+  "compass:exports": {
+    "import": "./lib/bson.cjs",
+    "require": "./lib/bson.cjs"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "pretest": "npm run build",
+    "test": "npm run check:node && npm run check:web",
+    "check:node": "WEB=false mocha test/node",
+    "check:tsd": "npm run build:dts && tsd",
+    "check:web": "WEB=true mocha test/node",
+    "check:granular-bench": "npm run build:bench && npm run check:baseline-bench && node ./test/bench/etc/run_granular_benchmarks.js",
+    "check:spec-bench": "npm run build:bench && npm run check:baseline-bench && node ./test/bench/lib/spec/bsonBench.js",
+    "check:custom-bench": "npm run build && npm run check:baseline-bench && node ./test/bench/custom/main.mjs",
+    "check:baseline-bench": "node ./test/bench/etc/cpuBaseline.js",
+    "build:bench": "cd test/bench && npx tsc",
+    "build:ts": "node ./node_modules/typescript/bin/tsc",
+    "build:dts": "npm run build:ts && api-extractor run --typescript-compiler-folder node_modules/typescript --local && node etc/clean_definition_files.cjs",
+    "build:bundle": "rollup -c rollup.config.mjs",
+    "build": "npm run build:dts && npm run build:bundle",
+    "check:lint": "ESLINT_USE_FLAT_CONFIG=false eslint -v && ESLINT_USE_FLAT_CONFIG=false eslint --ext '.js,.ts' --max-warnings=0 src test && npm run build:dts && npm run check:tsd",
+    "format": "ESLINT_USE_FLAT_CONFIG=false eslint --ext '.js,.ts' src test --fix",
+    "check:coverage": "nyc --check-coverage npm run check:node",
+    "prepare": "node etc/prepare.js",
+    "release": "standard-version -i HISTORY.md"
+  }
+}

gateway/node_modules/bson/src/binary.ts

@@ -0,0 +1,751 @@
+import { type InspectFn, defaultInspect, isAnyArrayBuffer, isUint8Array } from './parser/utils';
+import type { EJSONOptions } from './extended_json';
+import { BSONError } from './error';
+import { BSON_BINARY_SUBTYPE_UUID_NEW } from './constants';
+import { ByteUtils } from './utils/byte_utils';
+import { BSONValue } from './bson_value';
+import { NumberUtils } from './utils/number_utils';
+
+/** @public */
+export type BinarySequence = Uint8Array | number[];
+
+/** @public */
+export interface BinaryExtendedLegacy {
+  $type: string;
+  $binary: string;
+}
+
+/** @public */
+export interface BinaryExtended {
+  $binary: {
+    subType: string;
+    base64: string;
+  };
+}
+
+/**
+ * A class representation of the BSON Binary type.
+ * @public
+ * @category BSONType
+ */
+export class Binary extends BSONValue {
+  get _bsontype(): 'Binary' {
+    return 'Binary';
+  }
+
+  /**
+   * Binary default subtype
+   * @internal
+   */
+  private static readonly BSON_BINARY_SUBTYPE_DEFAULT = 0;
+
+  /** Initial buffer default size */
+  static readonly BUFFER_SIZE = 256;
+  /** Default BSON type */
+  static readonly SUBTYPE_DEFAULT = 0;
+  /** Function BSON type */
+  static readonly SUBTYPE_FUNCTION = 1;
+  /**
+   * Legacy default BSON Binary type
+   * @deprecated BSON Binary subtype 2 is deprecated in the BSON specification
+   */
+  static readonly SUBTYPE_BYTE_ARRAY = 2;
+  /** Deprecated UUID BSON type @deprecated Please use SUBTYPE_UUID */
+  static readonly SUBTYPE_UUID_OLD = 3;
+  /** UUID BSON type */
+  static readonly SUBTYPE_UUID = 4;
+  /** MD5 BSON type */
+  static readonly SUBTYPE_MD5 = 5;
+  /** Encrypted BSON type */
+  static readonly SUBTYPE_ENCRYPTED = 6;
+  /** Column BSON type */
+  static readonly SUBTYPE_COLUMN = 7;
+  /** Sensitive BSON type */
+  static readonly SUBTYPE_SENSITIVE = 8;
+  /** Vector BSON type */
+  static readonly SUBTYPE_VECTOR = 9;
+  /** User BSON type */
+  static readonly SUBTYPE_USER_DEFINED = 128;
+
+  /** datatype of a Binary Vector (subtype: 9) */
+  static readonly VECTOR_TYPE = Object.freeze({
+    Int8: 0x03,
+    Float32: 0x27,
+    PackedBit: 0x10
+  } as const);
+
+  /**
+   * The bytes of the Binary value.
+   *
+   * The format of a Binary value in BSON is defined as:
+   * ```txt
+   * binary	::= int32 subtype (byte*)
+   * ```
+   *
+   * This `buffer` is the "(byte*)" segment.
+   *
+   * Unless the value is subtype 2, then deserialize will read the first 4 bytes as an int32 and set this to the remaining bytes.
+   *
+   * ```txt
+   * binary	::= int32 unsigned_byte(2) int32 (byte*)
+   * ```
+   *
+   * @see https://bsonspec.org/spec.html
+   */
+  public buffer: Uint8Array;
+  /**
+   * The binary subtype.
+   *
+   * Current defined values are:
+   *
+   * - `unsigned_byte(0)` Generic binary subtype
+   * - `unsigned_byte(1)` Function
+   * - `unsigned_byte(2)` Binary (Deprecated)
+   * - `unsigned_byte(3)` UUID (Deprecated)
+   * - `unsigned_byte(4)` UUID
+   * - `unsigned_byte(5)` MD5
+   * - `unsigned_byte(6)` Encrypted BSON value
+   * - `unsigned_byte(7)` Compressed BSON column
+   * - `unsigned_byte(8)` Sensitive
+   * - `unsigned_byte(9)` Vector
+   * - `unsigned_byte(128)` - `unsigned_byte(255)` User defined
+   */
+  public sub_type: number;
+  /**
+   * The Binary's `buffer` can be larger than the Binary's content.
+   * This property is used to determine where the content ends in the buffer.
+   */
+  public position: number;
+
+  /**
+   * Create a new Binary instance.
+   * @param buffer - a buffer object containing the binary data.
+   * @param subType - the option binary type.
+   */
+  constructor(buffer?: BinarySequence, subType?: number) {
+    super();
+    if (
+      !(buffer == null) &&
+      typeof buffer === 'string' &&
+      !ArrayBuffer.isView(buffer) &&
+      !isAnyArrayBuffer(buffer) &&
+      !Array.isArray(buffer)
+    ) {
+      throw new BSONError('Binary can only be constructed from Uint8Array or number[]');
+    }
+
+    this.sub_type = (subType ?? Binary.BSON_BINARY_SUBTYPE_DEFAULT) & 0xff;
+
+    if (buffer == null) {
+      // create an empty binary buffer
+      this.buffer = ByteUtils.allocate(Binary.BUFFER_SIZE);
+      this.position = 0;
+    } else {
+      this.buffer = Array.isArray(buffer)
+        ? ByteUtils.fromNumberArray(buffer)
+        : ByteUtils.toLocalBufferType(buffer);
+      this.position = this.buffer.byteLength;
+    }
+  }
+
+  /**
+   * Updates this binary with byte_value.
+   *
+   * @param byteValue - a single byte we wish to write.
+   */
+  put(byteValue: string | number | Uint8Array | number[]): void {
+    // If it's a string and a has more than one character throw an error
+    if (typeof byteValue === 'string' && byteValue.length !== 1) {
+      throw new BSONError('only accepts single character String');
+    } else if (typeof byteValue !== 'number' && byteValue.length !== 1)
+      throw new BSONError('only accepts single character Uint8Array or Array');
+
+    // Decode the byte value once
+    let decodedByte: number;
+    if (typeof byteValue === 'string') {
+      decodedByte = byteValue.charCodeAt(0);
+    } else if (typeof byteValue === 'number') {
+      decodedByte = byteValue;
+    } else {
+      decodedByte = byteValue[0];
+    }
+
+    if (decodedByte < 0 || decodedByte > 255) {
+      throw new BSONError('only accepts number in a valid unsigned byte range 0-255');
+    }
+
+    if (this.buffer.byteLength > this.position) {
+      this.buffer[this.position++] = decodedByte;
+    } else {
+      const newSpace = ByteUtils.allocate(Binary.BUFFER_SIZE + this.buffer.length);
+      newSpace.set(this.buffer, 0);
+      this.buffer = newSpace;
+      this.buffer[this.position++] = decodedByte;
+    }
+  }
+
+  /**
+   * Writes a buffer to the binary.
+   *
+   * @param sequence - a string or buffer to be written to the Binary BSON object.
+   * @param offset - specify the binary of where to write the content.
+   */
+  write(sequence: BinarySequence, offset: number): void {
+    offset = typeof offset === 'number' ? offset : this.position;
+
+    // If the buffer is to small let's extend the buffer
+    if (this.buffer.byteLength < offset + sequence.length) {
+      const newSpace = ByteUtils.allocate(this.buffer.byteLength + sequence.length);
+      newSpace.set(this.buffer, 0);
+
+      // Assign the new buffer
+      this.buffer = newSpace;
+    }
+
+    if (ArrayBuffer.isView(sequence)) {
+      this.buffer.set(ByteUtils.toLocalBufferType(sequence), offset);
+      this.position =
+        offset + sequence.byteLength > this.position ? offset + sequence.length : this.position;
+    } else if (typeof sequence === 'string') {
+      throw new BSONError('input cannot be string');
+    }
+  }
+
+  /**
+   * Returns a view of **length** bytes starting at **position**.
+   *
+   * @param position - read from the given position in the Binary.
+   * @param length - the number of bytes to read.
+   */
+  read(position: number, length: number): Uint8Array {
+    length = length && length > 0 ? length : this.position;
+    const end = position + length;
+    return this.buffer.subarray(position, end > this.position ? this.position : end);
+  }
+
+  /** returns a view of the binary value as a Uint8Array */
+  value(): Uint8Array {
+    // Optimize to serialize for the situation where the data == size of buffer
+    return this.buffer.length === this.position
+      ? this.buffer
+      : this.buffer.subarray(0, this.position);
+  }
+
+  /** the length of the binary sequence */
+  length(): number {
+    return this.position;
+  }
+
+  toJSON(): string {
+    return ByteUtils.toBase64(this.buffer.subarray(0, this.position));
+  }
+
+  toString(encoding?: 'hex' | 'base64' | 'utf8' | 'utf-8'): string {
+    if (encoding === 'hex') return ByteUtils.toHex(this.buffer.subarray(0, this.position));
+    if (encoding === 'base64') return ByteUtils.toBase64(this.buffer.subarray(0, this.position));
+    if (encoding === 'utf8' || encoding === 'utf-8')
+      return ByteUtils.toUTF8(this.buffer, 0, this.position, false);
+    return ByteUtils.toUTF8(this.buffer, 0, this.position, false);
+  }
+
+  /** @internal */
+  toExtendedJSON(options?: EJSONOptions): BinaryExtendedLegacy | BinaryExtended {
+    options = options || {};
+
+    if (this.sub_type === Binary.SUBTYPE_VECTOR) {
+      validateBinaryVector(this);
+    }
+
+    const base64String = ByteUtils.toBase64(this.buffer);
+
+    const subType = Number(this.sub_type).toString(16);
+    if (options.legacy) {
+      return {
+        $binary: base64String,
+        $type: subType.length === 1 ? '0' + subType : subType
+      };
+    }
+    return {
+      $binary: {
+        base64: base64String,
+        subType: subType.length === 1 ? '0' + subType : subType
+      }
+    };
+  }
+
+  toUUID(): UUID {
+    if (this.sub_type === Binary.SUBTYPE_UUID) {
+      return new UUID(this.buffer.subarray(0, this.position));
+    }
+
+    throw new BSONError(
+      `Binary sub_type "${this.sub_type}" (${typeof this.sub_type}) is not supported for converting to UUID. Only 0x${Binary.SUBTYPE_UUID.toString(16).padStart(2, '0')} is currently supported.`
+    );
+  }
+
+  /** Creates an Binary instance from a hex digit string */
+  static createFromHexString(hex: string, subType?: number): Binary {
+    return new Binary(ByteUtils.fromHex(hex), subType);
+  }
+
+  /** Creates an Binary instance from a base64 string */
+  static createFromBase64(base64: string, subType?: number): Binary {
+    return new Binary(ByteUtils.fromBase64(base64), subType);
+  }
+
+  /** @internal */
+  static fromExtendedJSON(
+    doc: BinaryExtendedLegacy | BinaryExtended | UUIDExtended,
+    options?: EJSONOptions
+  ): Binary {
+    options = options || {};
+    let data: Uint8Array | undefined;
+    let type;
+    if ('$binary' in doc) {
+      if (options.legacy && typeof doc.$binary === 'string' && '$type' in doc) {
+        type = doc.$type ? parseInt(doc.$type, 16) : 0;
+        data = ByteUtils.fromBase64(doc.$binary);
+      } else {
+        if (typeof doc.$binary !== 'string') {
+          type = doc.$binary.subType ? parseInt(doc.$binary.subType, 16) : 0;
+          data = ByteUtils.fromBase64(doc.$binary.base64);
+        }
+      }
+    } else if ('$uuid' in doc) {
+      type = 4;
+      data = UUID.bytesFromString(doc.$uuid);
+    }
+    if (!data) {
+      throw new BSONError(`Unexpected Binary Extended JSON format ${JSON.stringify(doc)}`);
+    }
+    return type === BSON_BINARY_SUBTYPE_UUID_NEW ? new UUID(data) : new Binary(data, type);
+  }
+
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+    const base64 = ByteUtils.toBase64(this.buffer.subarray(0, this.position));
+    const base64Arg = inspect(base64, options);
+    const subTypeArg = inspect(this.sub_type, options);
+    return `Binary.createFromBase64(${base64Arg}, ${subTypeArg})`;
+  }
+
+  /**
+   * If this Binary represents a Int8 Vector (`binary.buffer[0] === Binary.VECTOR_TYPE.Int8`),
+   * returns a copy of the bytes in a new Int8Array.
+   *
+   * If the Binary is not a Vector, or the datatype is not Int8, an error is thrown.
+   */
+  public toInt8Array(): Int8Array {
+    if (this.sub_type !== Binary.SUBTYPE_VECTOR) {
+      throw new BSONError('Binary sub_type is not Vector');
+    }
+
+    if (this.buffer[0] !== Binary.VECTOR_TYPE.Int8) {
+      throw new BSONError('Binary datatype field is not Int8');
+    }
+
+    validateBinaryVector(this);
+
+    return new Int8Array(
+      this.buffer.buffer.slice(this.buffer.byteOffset + 2, this.buffer.byteOffset + this.position)
+    );
+  }
+
+  /**
+   * If this Binary represents a Float32 Vector (`binary.buffer[0] === Binary.VECTOR_TYPE.Float32`),
+   * returns a copy of the bytes in a new Float32Array.
+   *
+   * If the Binary is not a Vector, or the datatype is not Float32, an error is thrown.
+   */
+  public toFloat32Array(): Float32Array {
+    if (this.sub_type !== Binary.SUBTYPE_VECTOR) {
+      throw new BSONError('Binary sub_type is not Vector');
+    }
+
+    if (this.buffer[0] !== Binary.VECTOR_TYPE.Float32) {
+      throw new BSONError('Binary datatype field is not Float32');
+    }
+
+    validateBinaryVector(this);
+
+    const floatBytes = new Uint8Array(
+      this.buffer.buffer.slice(this.buffer.byteOffset + 2, this.buffer.byteOffset + this.position)
+    );
+
+    if (NumberUtils.isBigEndian) ByteUtils.swap32(floatBytes);
+
+    return new Float32Array(floatBytes.buffer);
+  }
+
+  /**
+   * If this Binary represents packed bit Vector (`binary.buffer[0] === Binary.VECTOR_TYPE.PackedBit`),
+   * returns a copy of the bytes that are packed bits.
+   *
+   * Use `toBits` to get the unpacked bits.
+   *
+   * If the Binary is not a Vector, or the datatype is not PackedBit, an error is thrown.
+   */
+  public toPackedBits(): Uint8Array {
+    if (this.sub_type !== Binary.SUBTYPE_VECTOR) {
+      throw new BSONError('Binary sub_type is not Vector');
+    }
+
+    if (this.buffer[0] !== Binary.VECTOR_TYPE.PackedBit) {
+      throw new BSONError('Binary datatype field is not packed bit');
+    }
+
+    validateBinaryVector(this);
+
+    return new Uint8Array(
+      this.buffer.buffer.slice(this.buffer.byteOffset + 2, this.buffer.byteOffset + this.position)
+    );
+  }
+
+  /**
+   * If this Binary represents a Packed bit Vector (`binary.buffer[0] === Binary.VECTOR_TYPE.PackedBit`),
+   * returns a copy of the bit unpacked into a new Int8Array.
+   *
+   * Use `toPackedBits` to get the bits still in packed form.
+   *
+   * If the Binary is not a Vector, or the datatype is not PackedBit, an error is thrown.
+   */
+  public toBits(): Int8Array {
+    if (this.sub_type !== Binary.SUBTYPE_VECTOR) {
+      throw new BSONError('Binary sub_type is not Vector');
+    }
+
+    if (this.buffer[0] !== Binary.VECTOR_TYPE.PackedBit) {
+      throw new BSONError('Binary datatype field is not packed bit');
+    }
+
+    validateBinaryVector(this);
+
+    const byteCount = this.length() - 2;
+    const bitCount = byteCount * 8 - this.buffer[1];
+    const bits = new Int8Array(bitCount);
+
+    for (let bitOffset = 0; bitOffset < bits.length; bitOffset++) {
+      const byteOffset = (bitOffset / 8) | 0;
+      const byte = this.buffer[byteOffset + 2];
+      const shift = 7 - (bitOffset % 8);
+      const bit = (byte >> shift) & 1;
+      bits[bitOffset] = bit;
+    }
+
+    return bits;
+  }
+
+  /**
+   * Constructs a Binary representing an Int8 Vector.
+   * @param array - The array to store as a view on the Binary class
+   */
+  public static fromInt8Array(array: Int8Array): Binary {
+    const buffer = ByteUtils.allocate(array.byteLength + 2);
+    buffer[0] = Binary.VECTOR_TYPE.Int8;
+    buffer[1] = 0;
+    const intBytes = new Uint8Array(array.buffer, array.byteOffset, array.byteLength);
+    buffer.set(intBytes, 2);
+    const bin = new this(buffer, this.SUBTYPE_VECTOR);
+    validateBinaryVector(bin);
+    return bin;
+  }
+
+  /** Constructs a Binary representing an Float32 Vector. */
+  public static fromFloat32Array(array: Float32Array): Binary {
+    const binaryBytes = ByteUtils.allocate(array.byteLength + 2);
+    binaryBytes[0] = Binary.VECTOR_TYPE.Float32;
+    binaryBytes[1] = 0;
+
+    const floatBytes = new Uint8Array(array.buffer, array.byteOffset, array.byteLength);
+    binaryBytes.set(floatBytes, 2);
+
+    if (NumberUtils.isBigEndian) ByteUtils.swap32(new Uint8Array(binaryBytes.buffer, 2));
+
+    const bin = new this(binaryBytes, this.SUBTYPE_VECTOR);
+    validateBinaryVector(bin);
+    return bin;
+  }
+
+  /**
+   * Constructs a Binary representing a packed bit Vector.
+   *
+   * Use `fromBits` to pack an array of 1s and 0s.
+   */
+  public static fromPackedBits(array: Uint8Array, padding = 0): Binary {
+    const buffer = ByteUtils.allocate(array.byteLength + 2);
+    buffer[0] = Binary.VECTOR_TYPE.PackedBit;
+    buffer[1] = padding;
+    buffer.set(array, 2);
+    const bin = new this(buffer, this.SUBTYPE_VECTOR);
+    validateBinaryVector(bin);
+    return bin;
+  }
+
+  /**
+   * Constructs a Binary representing an Packed Bit Vector.
+   * @param array - The array of 1s and 0s to pack into the Binary instance
+   */
+  public static fromBits(bits: ArrayLike<number>): Binary {
+    const byteLength = (bits.length + 7) >>> 3; // ceil(bits.length / 8)
+    const bytes = new Uint8Array(byteLength + 2);
+    bytes[0] = Binary.VECTOR_TYPE.PackedBit;
+
+    const remainder = bits.length % 8;
+    bytes[1] = remainder === 0 ? 0 : 8 - remainder;
+
+    for (let bitOffset = 0; bitOffset < bits.length; bitOffset++) {
+      const byteOffset = bitOffset >>> 3; // floor(bitOffset / 8)
+      const bit = bits[bitOffset];
+
+      if (bit !== 0 && bit !== 1) {
+        throw new BSONError(
+          `Invalid bit value at ${bitOffset}: must be 0 or 1, found ${bits[bitOffset]}`
+        );
+      }
+
+      if (bit === 0) continue;
+
+      const shift = 7 - (bitOffset % 8);
+      bytes[byteOffset + 2] |= bit << shift;
+    }
+
+    return new this(bytes, Binary.SUBTYPE_VECTOR);
+  }
+}
+
+export function validateBinaryVector(vector: Binary): void {
+  if (vector.sub_type !== Binary.SUBTYPE_VECTOR) return;
+
+  const size = vector.position;
+
+  // NOTE: Validation is only applied to **KNOWN** vector types
+  // If a new datatype is introduced, a future version of the library will need to add validation
+  const datatype = vector.buffer[0];
+
+  // NOTE: We do not enable noUncheckedIndexedAccess so TS believes this is always number
+  // a Binary vector may be empty, in which case the padding is undefined
+  // this possible value is tolerable for our validation checks
+  const padding: number | undefined = vector.buffer[1];
+
+  if (
+    (datatype === Binary.VECTOR_TYPE.Float32 || datatype === Binary.VECTOR_TYPE.Int8) &&
+    padding !== 0
+  ) {
+    throw new BSONError('Invalid Vector: padding must be zero for int8 and float32 vectors');
+  }
+
+  if (datatype === Binary.VECTOR_TYPE.Float32) {
+    if (size !== 0 && size - 2 !== 0 && (size - 2) % 4 !== 0) {
+      throw new BSONError('Invalid Vector: Float32 vector must contain a multiple of 4 bytes');
+    }
+  }
+
+  if (datatype === Binary.VECTOR_TYPE.PackedBit && padding !== 0 && size === 2) {
+    throw new BSONError(
+      'Invalid Vector: padding must be zero for packed bit vectors that are empty'
+    );
+  }
+
+  if (datatype === Binary.VECTOR_TYPE.PackedBit && padding > 7) {
+    throw new BSONError(
+      `Invalid Vector: padding must be a value between 0 and 7. found: ${padding}`
+    );
+  }
+}
+
+/** @public */
+export type UUIDExtended = {
+  $uuid: string;
+};
+
+const UUID_BYTE_LENGTH = 16;
+const UUID_WITHOUT_DASHES = /^[0-9A-F]{32}$/i;
+const UUID_WITH_DASHES = /^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i;
+
+/**
+ * A class representation of the BSON UUID type.
+ * @public
+ */
+export class UUID extends Binary {
+  /**
+   * Create a UUID type
+   *
+   * When the argument to the constructor is omitted a random v4 UUID will be generated.
+   *
+   * @param input - Can be a 32 or 36 character hex string (dashes excluded/included) or a 16 byte binary Buffer.
+   */
+  constructor(input?: string | Uint8Array | UUID) {
+    let bytes: Uint8Array;
+    if (input == null) {
+      bytes = UUID.generate();
+    } else if (input instanceof UUID) {
+      bytes = ByteUtils.toLocalBufferType(new Uint8Array(input.buffer));
+    } else if (ArrayBuffer.isView(input) && input.byteLength === UUID_BYTE_LENGTH) {
+      bytes = ByteUtils.toLocalBufferType(input);
+    } else if (typeof input === 'string') {
+      bytes = UUID.bytesFromString(input);
+    } else {
+      throw new BSONError(
+        'Argument passed in UUID constructor must be a UUID, a 16 byte Buffer or a 32/36 character hex string (dashes excluded/included, format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).'
+      );
+    }
+    super(bytes, BSON_BINARY_SUBTYPE_UUID_NEW);
+  }
+
+  /**
+   * The UUID bytes
+   * @readonly
+   */
+  get id(): Uint8Array {
+    return this.buffer;
+  }
+
+  set id(value: Uint8Array) {
+    this.buffer = value;
+  }
+
+  /**
+   * Returns the UUID id as a 32 or 36 character hex string representation, excluding/including dashes (defaults to 36 character dash separated)
+   * @param includeDashes - should the string exclude dash-separators.
+   */
+  toHexString(includeDashes = true): string {
+    if (includeDashes) {
+      return [
+        ByteUtils.toHex(this.buffer.subarray(0, 4)),
+        ByteUtils.toHex(this.buffer.subarray(4, 6)),
+        ByteUtils.toHex(this.buffer.subarray(6, 8)),
+        ByteUtils.toHex(this.buffer.subarray(8, 10)),
+        ByteUtils.toHex(this.buffer.subarray(10, 16))
+      ].join('-');
+    }
+    return ByteUtils.toHex(this.buffer);
+  }
+
+  /**
+   * Converts the id into a 36 character (dashes included) hex string, unless a encoding is specified.
+   */
+  toString(encoding?: 'hex' | 'base64'): string {
+    if (encoding === 'hex') return ByteUtils.toHex(this.id);
+    if (encoding === 'base64') return ByteUtils.toBase64(this.id);
+    return this.toHexString();
+  }
+
+  /**
+   * Converts the id into its JSON string representation.
+   * A 36 character (dashes included) hex string in the format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+   */
+  toJSON(): string {
+    return this.toHexString();
+  }
+
+  /**
+   * Compares the equality of this UUID with `otherID`.
+   *
+   * @param otherId - UUID instance to compare against.
+   */
+  equals(otherId: string | Uint8Array | UUID): boolean {
+    if (!otherId) {
+      return false;
+    }
+
+    if (otherId instanceof UUID) {
+      return ByteUtils.equals(otherId.id, this.id);
+    }
+
+    try {
+      return ByteUtils.equals(new UUID(otherId).id, this.id);
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Creates a Binary instance from the current UUID.
+   */
+  toBinary(): Binary {
+    return new Binary(this.id, Binary.SUBTYPE_UUID);
+  }
+
+  /**
+   * Generates a populated buffer containing a v4 uuid
+   */
+  static generate(): Uint8Array {
+    const bytes = ByteUtils.randomBytes(UUID_BYTE_LENGTH);
+
+    // Per 4.4, set bits for version and `clock_seq_hi_and_reserved`
+    // Kindly borrowed from https://github.com/uuidjs/uuid/blob/master/src/v4.js
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+
+    return bytes;
+  }
+
+  /**
+   * Checks if a value is a valid bson UUID
+   * @param input - UUID, string or Buffer to validate.
+   */
+  static isValid(input: string | Uint8Array | UUID | Binary): boolean {
+    if (!input) {
+      return false;
+    }
+
+    if (typeof input === 'string') {
+      return UUID.isValidUUIDString(input);
+    }
+
+    if (isUint8Array(input)) {
+      return input.byteLength === UUID_BYTE_LENGTH;
+    }
+
+    return (
+      input._bsontype === 'Binary' &&
+      input.sub_type === this.SUBTYPE_UUID &&
+      input.buffer.byteLength === 16
+    );
+  }
+
+  /**
+   * Creates an UUID from a hex string representation of an UUID.
+   * @param hexString - 32 or 36 character hex string (dashes excluded/included).
+   */
+  static override createFromHexString(hexString: string): UUID {
+    const buffer = UUID.bytesFromString(hexString);
+    return new UUID(buffer);
+  }
+
+  /** Creates an UUID from a base64 string representation of an UUID. */
+  static override createFromBase64(base64: string): UUID {
+    return new UUID(ByteUtils.fromBase64(base64));
+  }
+
+  /** @internal */
+  static bytesFromString(representation: string) {
+    if (!UUID.isValidUUIDString(representation)) {
+      throw new BSONError(
+        'UUID string representation must be 32 hex digits or canonical hyphenated representation'
+      );
+    }
+    return ByteUtils.fromHex(representation.replace(/-/g, ''));
+  }
+
+  /**
+   * @internal
+   *
+   * Validates a string to be a hex digit sequence with or without dashes.
+   * The canonical hyphenated representation of a uuid is hex in 8-4-4-4-12 groups.
+   */
+  static isValidUUIDString(representation: string) {
+    return UUID_WITHOUT_DASHES.test(representation) || UUID_WITH_DASHES.test(representation);
+  }
+
+  /**
+   * Converts to a string representation of this Id.
+   *
+   * @returns return the 36 character hex string representation.
+   *
+   */
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+    return `new UUID(${inspect(this.toHexString(), options)})`;
+  }
+}

gateway/node_modules/bson/src/bson.ts

@@ -0,0 +1,253 @@
+import { Binary, UUID } from './binary';
+import { Code } from './code';
+import { DBRef } from './db_ref';
+import { Decimal128 } from './decimal128';
+import { Double } from './double';
+import { Int32 } from './int_32';
+import { Long } from './long';
+import { MaxKey } from './max_key';
+import { MinKey } from './min_key';
+import { ObjectId } from './objectid';
+import { internalCalculateObjectSize } from './parser/calculate_size';
+// Parts of the parser
+import { internalDeserialize, type DeserializeOptions } from './parser/deserializer';
+import { serializeInto, type SerializeOptions } from './parser/serializer';
+import { BSONRegExp } from './regexp';
+import { BSONSymbol } from './symbol';
+import { Timestamp } from './timestamp';
+import { ByteUtils } from './utils/byte_utils';
+import { NumberUtils } from './utils/number_utils';
+export type { UUIDExtended, BinaryExtended, BinaryExtendedLegacy, BinarySequence } from './binary';
+export type { CodeExtended } from './code';
+export type { DBRefLike } from './db_ref';
+export type { Decimal128Extended } from './decimal128';
+export type { DoubleExtended } from './double';
+export type {
+  EJSONOptions,
+  EJSONOptionsBase,
+  EJSONSerializeOptions,
+  EJSONParseOptions
+} from './extended_json';
+export type { Int32Extended } from './int_32';
+export type { LongExtended } from './long';
+export type { MaxKeyExtended } from './max_key';
+export type { MinKeyExtended } from './min_key';
+export type { ObjectIdExtended, ObjectIdLike } from './objectid';
+export type { BSONRegExpExtended, BSONRegExpExtendedLegacy } from './regexp';
+export type { BSONSymbolExtended } from './symbol';
+export type { LongWithoutOverrides, TimestampExtended, TimestampOverrides } from './timestamp';
+export type { LongWithoutOverridesClass } from './timestamp';
+export type { SerializeOptions, DeserializeOptions };
+
+export {
+  Code,
+  BSONSymbol,
+  DBRef,
+  Binary,
+  ObjectId,
+  UUID,
+  Long,
+  Timestamp,
+  Double,
+  Int32,
+  MinKey,
+  MaxKey,
+  BSONRegExp,
+  Decimal128,
+  NumberUtils,
+  ByteUtils
+};
+export { BSONValue, bsonType, type BSONTypeTag } from './bson_value';
+export { BSONError, BSONVersionError, BSONRuntimeError, BSONOffsetError } from './error';
+export { BSONType } from './constants';
+export { EJSON } from './extended_json';
+export { onDemand, type OnDemand } from './parser/on_demand/index';
+
+/** @public */
+export interface Document {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [key: string]: any;
+}
+
+/** @internal */
+// Default Max Size
+const MAXSIZE = 1024 * 1024 * 17;
+
+// Current Internal Temporary Serialization Buffer
+let buffer = ByteUtils.allocate(MAXSIZE);
+
+/**
+ * Sets the size of the internal serialization buffer.
+ *
+ * @param size - The desired size for the internal serialization buffer in bytes
+ * @public
+ */
+export function setInternalBufferSize(size: number): void {
+  // Resize the internal serialization buffer if needed
+  if (buffer.length < size) {
+    buffer = ByteUtils.allocate(size);
+  }
+}
+
+/**
+ * Serialize a Javascript object.
+ *
+ * @param object - the Javascript object to serialize.
+ * @returns Buffer object containing the serialized object.
+ * @public
+ */
+export function serialize(object: Document, options: SerializeOptions = {}): Uint8Array {
+  // Unpack the options
+  const checkKeys = typeof options.checkKeys === 'boolean' ? options.checkKeys : false;
+  const serializeFunctions =
+    typeof options.serializeFunctions === 'boolean' ? options.serializeFunctions : false;
+  const ignoreUndefined =
+    typeof options.ignoreUndefined === 'boolean' ? options.ignoreUndefined : true;
+  const minInternalBufferSize =
+    typeof options.minInternalBufferSize === 'number' ? options.minInternalBufferSize : MAXSIZE;
+
+  // Resize the internal serialization buffer if needed
+  if (buffer.length < minInternalBufferSize) {
+    buffer = ByteUtils.allocate(minInternalBufferSize);
+  }
+
+  // Attempt to serialize
+  const serializationIndex = serializeInto(
+    buffer,
+    object,
+    checkKeys,
+    0,
+    serializeFunctions,
+    ignoreUndefined,
+    null
+  );
+
+  // Create the final buffer
+  const finishedBuffer = ByteUtils.allocateUnsafe(serializationIndex);
+
+  // Copy into the finished buffer
+  finishedBuffer.set(buffer.subarray(0, serializationIndex), 0);
+
+  // Return the buffer
+  return finishedBuffer;
+}
+
+/**
+ * Serialize a Javascript object using a predefined Buffer and index into the buffer,
+ * useful when pre-allocating the space for serialization.
+ *
+ * @param object - the Javascript object to serialize.
+ * @param finalBuffer - the Buffer you pre-allocated to store the serialized BSON object.
+ * @returns the index pointing to the last written byte in the buffer.
+ * @public
+ */
+export function serializeWithBufferAndIndex(
+  object: Document,
+  finalBuffer: Uint8Array,
+  options: SerializeOptions = {}
+): number {
+  // Unpack the options
+  const checkKeys = typeof options.checkKeys === 'boolean' ? options.checkKeys : false;
+  const serializeFunctions =
+    typeof options.serializeFunctions === 'boolean' ? options.serializeFunctions : false;
+  const ignoreUndefined =
+    typeof options.ignoreUndefined === 'boolean' ? options.ignoreUndefined : true;
+  const startIndex = typeof options.index === 'number' ? options.index : 0;
+
+  // Attempt to serialize
+  const serializationIndex = serializeInto(
+    buffer,
+    object,
+    checkKeys,
+    0,
+    serializeFunctions,
+    ignoreUndefined,
+    null
+  );
+
+  finalBuffer.set(buffer.subarray(0, serializationIndex), startIndex);
+
+  // Return the index
+  return startIndex + serializationIndex - 1;
+}
+
+/**
+ * Deserialize data as BSON.
+ *
+ * @param buffer - the buffer containing the serialized set of BSON documents.
+ * @returns returns the deserialized Javascript Object.
+ * @public
+ */
+export function deserialize(buffer: Uint8Array, options: DeserializeOptions = {}): Document {
+  return internalDeserialize(ByteUtils.toLocalBufferType(buffer), options);
+}
+
+/** @public */
+export type CalculateObjectSizeOptions = Pick<
+  SerializeOptions,
+  'serializeFunctions' | 'ignoreUndefined'
+>;
+
+/**
+ * Calculate the bson size for a passed in Javascript object.
+ *
+ * @param object - the Javascript object to calculate the BSON byte size for
+ * @returns size of BSON object in bytes
+ * @public
+ */
+export function calculateObjectSize(
+  object: Document,
+  options: CalculateObjectSizeOptions = {}
+): number {
+  options = options || {};
+
+  const serializeFunctions =
+    typeof options.serializeFunctions === 'boolean' ? options.serializeFunctions : false;
+  const ignoreUndefined =
+    typeof options.ignoreUndefined === 'boolean' ? options.ignoreUndefined : true;
+
+  return internalCalculateObjectSize(object, serializeFunctions, ignoreUndefined);
+}
+
+/**
+ * Deserialize stream data as BSON documents.
+ *
+ * @param data - the buffer containing the serialized set of BSON documents.
+ * @param startIndex - the start index in the data Buffer where the deserialization is to start.
+ * @param numberOfDocuments - number of documents to deserialize.
+ * @param documents - an array where to store the deserialized documents.
+ * @param docStartIndex - the index in the documents array from where to start inserting documents.
+ * @param options - additional options used for the deserialization.
+ * @returns next index in the buffer after deserialization **x** numbers of documents.
+ * @public
+ */
+export function deserializeStream(
+  data: Uint8Array | ArrayBuffer,
+  startIndex: number,
+  numberOfDocuments: number,
+  documents: Document[],
+  docStartIndex: number,
+  options: DeserializeOptions
+): number {
+  const internalOptions = Object.assign(
+    { allowObjectSmallerThanBufferSize: true, index: 0 },
+    options
+  );
+  const bufferData = ByteUtils.toLocalBufferType(data);
+
+  let index = startIndex;
+  // Loop over all documents
+  for (let i = 0; i < numberOfDocuments; i++) {
+    // Find size of the document
+    const size = NumberUtils.getInt32LE(bufferData, index);
+    // Update options with index
+    internalOptions.index = index;
+    // Parse the document at this point
+    documents[docStartIndex + i] = internalDeserialize(bufferData, internalOptions);
+    // Adjust index by the document size
+    index = index + size;
+  }
+
+  // Return object containing end index of parsing and list of documents
+  return index;
+}

gateway/node_modules/bson/src/bson_value.ts

@@ -0,0 +1,55 @@
+import { BSON_MAJOR_VERSION } from './constants';
+import { type InspectFn } from './parser/utils';
+import { BSON_VERSION_SYMBOL } from './constants';
+
+/** @public */
+export type BSONTypeTag =
+  | 'BSONRegExp'
+  | 'BSONSymbol'
+  | 'ObjectId'
+  | 'Binary'
+  | 'Decimal128'
+  | 'Double'
+  | 'Int32'
+  | 'Long'
+  | 'MaxKey'
+  | 'MinKey'
+  | 'Timestamp'
+  | 'Code'
+  | 'DBRef';
+
+/** @public */
+export const bsonType = Symbol.for('@@mdb.bson.type');
+
+/** @public */
+export abstract class BSONValue {
+  /** @public */
+  public abstract get _bsontype(): BSONTypeTag;
+
+  public get [bsonType](): this['_bsontype'] {
+    return this._bsontype;
+  }
+
+  /** @internal */
+  get [BSON_VERSION_SYMBOL](): typeof BSON_MAJOR_VERSION {
+    return BSON_MAJOR_VERSION;
+  }
+
+  [Symbol.for('nodejs.util.inspect.custom')](
+    depth?: number,
+    options?: unknown,
+    inspect?: InspectFn
+  ): string {
+    return this.inspect(depth, options, inspect);
+  }
+
+  /**
+   * @public
+   * Prints a human-readable string of BSON value information
+   * If invoked manually without node.js.inspect function, this will default to a modified JSON.stringify
+   */
+  public abstract inspect(depth?: number, options?: unknown, inspect?: InspectFn): string;
+
+  /** @internal */
+  abstract toExtendedJSON(): unknown;
+}

gateway/node_modules/bson/src/code.ts

@@ -0,0 +1,69 @@
+import type { Document } from './bson';
+import { BSONValue } from './bson_value';
+import { type InspectFn, defaultInspect } from './parser/utils';
+
+/** @public */
+export interface CodeExtended {
+  $code: string;
+  $scope?: Document;
+}
+
+/**
+ * A class representation of the BSON Code type.
+ * @public
+ * @category BSONType
+ */
+export class Code extends BSONValue {
+  get _bsontype(): 'Code' {
+    return 'Code';
+  }
+
+  code: string;
+
+  // a code instance having a null scope is what determines whether
+  // it is BSONType 0x0D (just code) / 0x0F (code with scope)
+  scope: Document | null;
+
+  /**
+   * @param code - a string or function.
+   * @param scope - an optional scope for the function.
+   */
+  constructor(code: string | Function, scope?: Document | null) {
+    super();
+    this.code = code.toString();
+    this.scope = scope ?? null;
+  }
+
+  toJSON(): { code: string; scope?: Document } {
+    if (this.scope != null) {
+      return { code: this.code, scope: this.scope };
+    }
+
+    return { code: this.code };
+  }
+
+  /** @internal */
+  toExtendedJSON(): CodeExtended {
+    if (this.scope) {
+      return { $code: this.code, $scope: this.scope };
+    }
+
+    return { $code: this.code };
+  }
+
+  /** @internal */
+  static fromExtendedJSON(doc: CodeExtended): Code {
+    return new Code(doc.$code, doc.$scope);
+  }
+
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+    let parametersString = inspect(this.code, options);
+    const multiLineFn = parametersString.includes('\n');
+    if (this.scope != null) {
+      parametersString += `,${multiLineFn ? '\n' : ' '}${inspect(this.scope, options)}`;
+    }
+    const endingNewline = multiLineFn && this.scope === null;
+    return `new Code(${multiLineFn ? '\n' : ''}${parametersString}${endingNewline ? '\n' : ''})`;
+  }
+}

gateway/node_modules/bson/src/constants.ts

@@ -0,0 +1,147 @@
+/** @internal */
+export const BSON_MAJOR_VERSION = 7;
+
+/** @internal */
+export const BSON_VERSION_SYMBOL = Symbol.for('@@mdb.bson.version');
+
+/** @internal */
+export const BSON_INT32_MAX = 0x7fffffff;
+/** @internal */
+export const BSON_INT32_MIN = -0x80000000;
+/** @internal */
+export const BSON_INT64_MAX = Math.pow(2, 63) - 1;
+/** @internal */
+export const BSON_INT64_MIN = -Math.pow(2, 63);
+
+/**
+ * Any integer up to 2^53 can be precisely represented by a double.
+ * @internal
+ */
+export const JS_INT_MAX = Math.pow(2, 53);
+
+/**
+ * Any integer down to -2^53 can be precisely represented by a double.
+ * @internal
+ */
+export const JS_INT_MIN = -Math.pow(2, 53);
+
+/** Number BSON Type @internal */
+export const BSON_DATA_NUMBER = 1;
+
+/** String BSON Type @internal */
+export const BSON_DATA_STRING = 2;
+
+/** Object BSON Type @internal */
+export const BSON_DATA_OBJECT = 3;
+
+/** Array BSON Type @internal */
+export const BSON_DATA_ARRAY = 4;
+
+/** Binary BSON Type @internal */
+export const BSON_DATA_BINARY = 5;
+
+/** Binary BSON Type @internal */
+export const BSON_DATA_UNDEFINED = 6;
+
+/** ObjectId BSON Type @internal */
+export const BSON_DATA_OID = 7;
+
+/** Boolean BSON Type @internal */
+export const BSON_DATA_BOOLEAN = 8;
+
+/** Date BSON Type @internal */
+export const BSON_DATA_DATE = 9;
+
+/** null BSON Type @internal */
+export const BSON_DATA_NULL = 10;
+
+/** RegExp BSON Type @internal */
+export const BSON_DATA_REGEXP = 11;
+
+/** Code BSON Type @internal */
+export const BSON_DATA_DBPOINTER = 12;
+
+/** Code BSON Type @internal */
+export const BSON_DATA_CODE = 13;
+
+/** Symbol BSON Type @internal */
+export const BSON_DATA_SYMBOL = 14;
+
+/** Code with Scope BSON Type @internal */
+export const BSON_DATA_CODE_W_SCOPE = 15;
+
+/** 32 bit Integer BSON Type @internal */
+export const BSON_DATA_INT = 16;
+
+/** Timestamp BSON Type @internal */
+export const BSON_DATA_TIMESTAMP = 17;
+
+/** Long BSON Type @internal */
+export const BSON_DATA_LONG = 18;
+
+/** Decimal128 BSON Type @internal */
+export const BSON_DATA_DECIMAL128 = 19;
+
+/** MinKey BSON Type @internal */
+export const BSON_DATA_MIN_KEY = 0xff;
+
+/** MaxKey BSON Type @internal */
+export const BSON_DATA_MAX_KEY = 0x7f;
+
+/** Binary Default Type @internal */
+export const BSON_BINARY_SUBTYPE_DEFAULT = 0;
+
+/** Binary Function Type @internal */
+export const BSON_BINARY_SUBTYPE_FUNCTION = 1;
+
+/** Binary Byte Array Type @internal */
+export const BSON_BINARY_SUBTYPE_BYTE_ARRAY = 2;
+
+/** Binary Deprecated UUID Type @deprecated Please use BSON_BINARY_SUBTYPE_UUID_NEW @internal */
+export const BSON_BINARY_SUBTYPE_UUID = 3;
+
+/** Binary UUID Type @internal */
+export const BSON_BINARY_SUBTYPE_UUID_NEW = 4;
+
+/** Binary MD5 Type @internal */
+export const BSON_BINARY_SUBTYPE_MD5 = 5;
+
+/** Encrypted BSON type @internal */
+export const BSON_BINARY_SUBTYPE_ENCRYPTED = 6;
+
+/** Column BSON type @internal */
+export const BSON_BINARY_SUBTYPE_COLUMN = 7;
+
+/** Sensitive BSON type @internal */
+export const BSON_BINARY_SUBTYPE_SENSITIVE = 8;
+
+/** Binary User Defined Type @internal */
+export const BSON_BINARY_SUBTYPE_USER_DEFINED = 128;
+
+/** @public */
+export const BSONType = Object.freeze({
+  double: 1,
+  string: 2,
+  object: 3,
+  array: 4,
+  binData: 5,
+  undefined: 6,
+  objectId: 7,
+  bool: 8,
+  date: 9,
+  null: 10,
+  regex: 11,
+  dbPointer: 12,
+  javascript: 13,
+  symbol: 14,
+  javascriptWithScope: 15,
+  int: 16,
+  timestamp: 17,
+  long: 18,
+  decimal: 19,
+  minKey: -1,
+  maxKey: 127
+} as const);
+
+/** @public */
+export type BSONType = (typeof BSONType)[keyof typeof BSONType];

gateway/node_modules/bson/src/db_ref.ts

@@ -0,0 +1,128 @@
+import type { Document } from './bson';
+import { BSONValue } from './bson_value';
+import type { EJSONOptions } from './extended_json';
+import type { ObjectId } from './objectid';
+import { type InspectFn, defaultInspect } from './parser/utils';
+
+/** @public */
+export interface DBRefLike {
+  $ref: string;
+  $id: ObjectId;
+  $db?: string;
+}
+
+/** @internal */
+export function isDBRefLike(value: unknown): value is DBRefLike {
+  return (
+    value != null &&
+    typeof value === 'object' &&
+    '$id' in value &&
+    value.$id != null &&
+    '$ref' in value &&
+    typeof value.$ref === 'string' &&
+    // If '$db' is defined it MUST be a string, otherwise it should be absent
+    (!('$db' in value) || ('$db' in value && typeof value.$db === 'string'))
+  );
+}
+
+/**
+ * A class representation of the BSON DBRef type.
+ * @public
+ * @category BSONType
+ */
+export class DBRef extends BSONValue {
+  get _bsontype(): 'DBRef' {
+    return 'DBRef';
+  }
+
+  collection!: string;
+  oid!: ObjectId;
+  db?: string;
+  fields!: Document;
+
+  /**
+   * @param collection - the collection name.
+   * @param oid - the reference ObjectId.
+   * @param db - optional db name, if omitted the reference is local to the current db.
+   */
+  constructor(collection: string, oid: ObjectId, db?: string, fields?: Document) {
+    super();
+    // check if namespace has been provided
+    const parts = collection.split('.');
+    if (parts.length === 2) {
+      db = parts.shift();
+      collection = parts.shift()!;
+    }
+
+    this.collection = collection;
+    this.oid = oid;
+    this.db = db;
+    this.fields = fields || {};
+  }
+
+  // Property provided for compatibility with the 1.x parser
+  // the 1.x parser used a "namespace" property, while 4.x uses "collection"
+
+  /** @internal */
+  get namespace(): string {
+    return this.collection;
+  }
+
+  set namespace(value: string) {
+    this.collection = value;
+  }
+
+  toJSON(): DBRefLike & Document {
+    const o = Object.assign(
+      {
+        $ref: this.collection,
+        $id: this.oid
+      },
+      this.fields
+    );
+
+    if (this.db != null) o.$db = this.db;
+    return o;
+  }
+
+  /** @internal */
+  toExtendedJSON(options?: EJSONOptions): DBRefLike {
+    options = options || {};
+    let o: DBRefLike = {
+      $ref: this.collection,
+      $id: this.oid
+    };
+
+    if (options.legacy) {
+      return o;
+    }
+
+    if (this.db) o.$db = this.db;
+    o = Object.assign(o, this.fields);
+    return o;
+  }
+
+  /** @internal */
+  static fromExtendedJSON(doc: DBRefLike): DBRef {
+    const copy = Object.assign({}, doc) as Partial<DBRefLike>;
+    delete copy.$ref;
+    delete copy.$id;
+    delete copy.$db;
+    return new DBRef(doc.$ref, doc.$id, doc.$db, copy);
+  }
+
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+
+    const args = [
+      inspect(this.namespace, options),
+      inspect(this.oid, options),
+      ...(this.db ? [inspect(this.db, options)] : []),
+      ...(Object.keys(this.fields).length > 0 ? [inspect(this.fields, options)] : [])
+    ];
+
+    args[1] = inspect === defaultInspect ? `new ObjectId(${args[1]})` : args[1];
+
+    return `new DBRef(${args.join(', ')})`;
+  }
+}

gateway/node_modules/bson/src/decimal128.ts

@@ -0,0 +1,855 @@
+import { BSONValue } from './bson_value';
+import { BSONError } from './error';
+import { Long } from './long';
+import { type InspectFn, defaultInspect, isUint8Array } from './parser/utils';
+import { ByteUtils } from './utils/byte_utils';
+
+const PARSE_STRING_REGEXP = /^(\+|-)?(\d+|(\d*\.\d*))?(E|e)?([-+])?(\d+)?$/;
+const PARSE_INF_REGEXP = /^(\+|-)?(Infinity|inf)$/i;
+const PARSE_NAN_REGEXP = /^(\+|-)?NaN$/i;
+
+const EXPONENT_MAX = 6111;
+const EXPONENT_MIN = -6176;
+const EXPONENT_BIAS = 6176;
+const MAX_DIGITS = 34;
+
+// Nan value bits as 32 bit values (due to lack of longs)
+const NAN_BUFFER = ByteUtils.fromNumberArray(
+  [
+    0x7c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
+  ].reverse()
+);
+// Infinity value bits 32 bit values (due to lack of longs)
+const INF_NEGATIVE_BUFFER = ByteUtils.fromNumberArray(
+  [
+    0xf8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
+  ].reverse()
+);
+const INF_POSITIVE_BUFFER = ByteUtils.fromNumberArray(
+  [
+    0x78, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
+  ].reverse()
+);
+
+const EXPONENT_REGEX = /^([-+])?(\d+)?$/;
+
+// Extract least significant 5 bits
+const COMBINATION_MASK = 0x1f;
+// Extract least significant 14 bits
+const EXPONENT_MASK = 0x3fff;
+// Value of combination field for Inf
+const COMBINATION_INFINITY = 30;
+// Value of combination field for NaN
+const COMBINATION_NAN = 31;
+
+// Detect if the value is a digit
+function isDigit(value: string): boolean {
+  return !isNaN(parseInt(value, 10));
+}
+
+// Divide two uint128 values
+function divideu128(value: { parts: [number, number, number, number] }) {
+  const DIVISOR = Long.fromNumber(1000 * 1000 * 1000);
+  let _rem = Long.fromNumber(0);
+
+  if (!value.parts[0] && !value.parts[1] && !value.parts[2] && !value.parts[3]) {
+    return { quotient: value, rem: _rem };
+  }
+
+  for (let i = 0; i <= 3; i++) {
+    // Adjust remainder to match value of next dividend
+    _rem = _rem.shiftLeft(32);
+    // Add the divided to _rem
+    _rem = _rem.add(new Long(value.parts[i], 0));
+    value.parts[i] = _rem.div(DIVISOR).low;
+    _rem = _rem.modulo(DIVISOR);
+  }
+
+  return { quotient: value, rem: _rem };
+}
+
+// Multiply two Long values and return the 128 bit value
+function multiply64x2(left: Long, right: Long): { high: Long; low: Long } {
+  if (!left && !right) {
+    return { high: Long.fromNumber(0), low: Long.fromNumber(0) };
+  }
+
+  const leftHigh = left.shiftRightUnsigned(32);
+  const leftLow = new Long(left.getLowBits(), 0);
+  const rightHigh = right.shiftRightUnsigned(32);
+  const rightLow = new Long(right.getLowBits(), 0);
+
+  let productHigh = leftHigh.multiply(rightHigh);
+  let productMid = leftHigh.multiply(rightLow);
+  const productMid2 = leftLow.multiply(rightHigh);
+  let productLow = leftLow.multiply(rightLow);
+
+  productHigh = productHigh.add(productMid.shiftRightUnsigned(32));
+  productMid = new Long(productMid.getLowBits(), 0)
+    .add(productMid2)
+    .add(productLow.shiftRightUnsigned(32));
+
+  productHigh = productHigh.add(productMid.shiftRightUnsigned(32));
+  productLow = productMid.shiftLeft(32).add(new Long(productLow.getLowBits(), 0));
+
+  // Return the 128 bit result
+  return { high: productHigh, low: productLow };
+}
+
+function lessThan(left: Long, right: Long): boolean {
+  // Make values unsigned
+  const uhleft = left.high >>> 0;
+  const uhright = right.high >>> 0;
+
+  // Compare high bits first
+  if (uhleft < uhright) {
+    return true;
+  } else if (uhleft === uhright) {
+    const ulleft = left.low >>> 0;
+    const ulright = right.low >>> 0;
+    if (ulleft < ulright) return true;
+  }
+
+  return false;
+}
+
+function invalidErr(string: string, message: string) {
+  throw new BSONError(`"${string}" is not a valid Decimal128 string - ${message}`);
+}
+
+/** @public */
+export interface Decimal128Extended {
+  $numberDecimal: string;
+}
+
+/**
+ * A class representation of the BSON Decimal128 type.
+ * @public
+ * @category BSONType
+ */
+export class Decimal128 extends BSONValue {
+  get _bsontype(): 'Decimal128' {
+    return 'Decimal128';
+  }
+
+  readonly bytes!: Uint8Array;
+
+  /**
+   * @param bytes - a buffer containing the raw Decimal128 bytes in little endian order,
+   *                or a string representation as returned by .toString()
+   */
+  constructor(bytes: Uint8Array | string) {
+    super();
+    if (typeof bytes === 'string') {
+      this.bytes = Decimal128.fromString(bytes).bytes;
+    } else if (bytes instanceof Uint8Array || isUint8Array(bytes)) {
+      if (bytes.byteLength !== 16) {
+        throw new BSONError('Decimal128 must take a Buffer of 16 bytes');
+      }
+      this.bytes = bytes;
+    } else {
+      throw new BSONError('Decimal128 must take a Buffer or string');
+    }
+  }
+
+  /**
+   * Create a Decimal128 instance from a string representation
+   *
+   * @param representation - a numeric string representation.
+   */
+  static fromString(representation: string): Decimal128 {
+    return Decimal128._fromString(representation, { allowRounding: false });
+  }
+
+  /**
+   * Create a Decimal128 instance from a string representation, allowing for rounding to 34
+   * significant digits
+   *
+   * @example Example of a number that will be rounded
+   * ```ts
+   * > let d = Decimal128.fromString('37.499999999999999196428571428571375')
+   * Uncaught:
+   * BSONError: "37.499999999999999196428571428571375" is not a valid Decimal128 string - inexact rounding
+   * at invalidErr (/home/wajames/js-bson/lib/bson.cjs:1402:11)
+   * at Decimal128.fromStringInternal (/home/wajames/js-bson/lib/bson.cjs:1633:25)
+   * at Decimal128.fromString (/home/wajames/js-bson/lib/bson.cjs:1424:27)
+   *
+   * > d = Decimal128.fromStringWithRounding('37.499999999999999196428571428571375')
+   * new Decimal128("37.49999999999999919642857142857138")
+   * ```
+   * @param representation - a numeric string representation.
+   */
+  static fromStringWithRounding(representation: string): Decimal128 {
+    return Decimal128._fromString(representation, { allowRounding: true });
+  }
+
+  private static _fromString(representation: string, options: { allowRounding: boolean }) {
+    // Parse state tracking
+    let isNegative = false;
+    let sawSign = false;
+    let sawRadix = false;
+    let foundNonZero = false;
+
+    // Total number of significant digits (no leading or trailing zero)
+    let significantDigits = 0;
+    // Total number of significand digits read
+    let nDigitsRead = 0;
+    // Total number of digits (no leading zeros)
+    let nDigits = 0;
+    // The number of the digits after radix
+    let radixPosition = 0;
+    // The index of the first non-zero in *str*
+    let firstNonZero = 0;
+
+    // Digits Array
+    const digits = [0];
+    // The number of digits in digits
+    let nDigitsStored = 0;
+    // Insertion pointer for digits
+    let digitsInsert = 0;
+    // The index of the last digit
+    let lastDigit = 0;
+
+    // Exponent
+    let exponent = 0;
+    // The high 17 digits of the significand
+    let significandHigh = new Long(0, 0);
+    // The low 17 digits of the significand
+    let significandLow = new Long(0, 0);
+    // The biased exponent
+    let biasedExponent = 0;
+
+    // Read index
+    let index = 0;
+
+    // Naively prevent against REDOS attacks.
+    // TODO: implementing a custom parsing for this, or refactoring the regex would yield
+    //       further gains.
+    if (representation.length >= 7000) {
+      throw new BSONError('' + representation + ' not a valid Decimal128 string');
+    }
+
+    // Results
+    const stringMatch = representation.match(PARSE_STRING_REGEXP);
+    const infMatch = representation.match(PARSE_INF_REGEXP);
+    const nanMatch = representation.match(PARSE_NAN_REGEXP);
+
+    // Validate the string
+    if ((!stringMatch && !infMatch && !nanMatch) || representation.length === 0) {
+      throw new BSONError('' + representation + ' not a valid Decimal128 string');
+    }
+
+    if (stringMatch) {
+      // full_match = stringMatch[0]
+      // sign = stringMatch[1]
+
+      const unsignedNumber = stringMatch[2];
+      // stringMatch[3] is undefined if a whole number (ex "1", 12")
+      // but defined if a number w/ decimal in it (ex "1.0, 12.2")
+
+      const e = stringMatch[4];
+      const expSign = stringMatch[5];
+      const expNumber = stringMatch[6];
+
+      // they provided e, but didn't give an exponent number. for ex "1e"
+      if (e && expNumber === undefined) invalidErr(representation, 'missing exponent power');
+
+      // they provided e, but didn't give a number before it. for ex "e1"
+      if (e && unsignedNumber === undefined) invalidErr(representation, 'missing exponent base');
+
+      if (e === undefined && (expSign || expNumber)) {
+        invalidErr(representation, 'missing e before exponent');
+      }
+    }
+
+    // Get the negative or positive sign
+    if (representation[index] === '+' || representation[index] === '-') {
+      sawSign = true;
+      isNegative = representation[index++] === '-';
+    }
+
+    // Check if user passed Infinity or NaN
+    if (!isDigit(representation[index]) && representation[index] !== '.') {
+      if (representation[index] === 'i' || representation[index] === 'I') {
+        return new Decimal128(isNegative ? INF_NEGATIVE_BUFFER : INF_POSITIVE_BUFFER);
+      } else if (representation[index] === 'N') {
+        return new Decimal128(NAN_BUFFER);
+      }
+    }
+
+    // Read all the digits
+    while (isDigit(representation[index]) || representation[index] === '.') {
+      if (representation[index] === '.') {
+        if (sawRadix) invalidErr(representation, 'contains multiple periods');
+
+        sawRadix = true;
+        index = index + 1;
+        continue;
+      }
+
+      if (nDigitsStored < MAX_DIGITS) {
+        if (representation[index] !== '0' || foundNonZero) {
+          if (!foundNonZero) {
+            firstNonZero = nDigitsRead;
+          }
+
+          foundNonZero = true;
+
+          // Only store 34 digits
+          digits[digitsInsert++] = parseInt(representation[index], 10);
+          nDigitsStored = nDigitsStored + 1;
+        }
+      }
+
+      if (foundNonZero) nDigits = nDigits + 1;
+      if (sawRadix) radixPosition = radixPosition + 1;
+
+      nDigitsRead = nDigitsRead + 1;
+      index = index + 1;
+    }
+
+    if (sawRadix && !nDigitsRead)
+      throw new BSONError('' + representation + ' not a valid Decimal128 string');
+
+    // Read exponent if exists
+    if (representation[index] === 'e' || representation[index] === 'E') {
+      // Read exponent digits
+      const match = representation.substr(++index).match(EXPONENT_REGEX);
+
+      // No digits read
+      if (!match || !match[2]) return new Decimal128(NAN_BUFFER);
+
+      // Get exponent
+      exponent = parseInt(match[0], 10);
+
+      // Adjust the index
+      index = index + match[0].length;
+    }
+
+    // Return not a number
+    if (representation[index]) return new Decimal128(NAN_BUFFER);
+
+    // Done reading input
+    // Find first non-zero digit in digits
+    if (!nDigitsStored) {
+      digits[0] = 0;
+      nDigits = 1;
+      nDigitsStored = 1;
+      significantDigits = 0;
+    } else {
+      lastDigit = nDigitsStored - 1;
+      significantDigits = nDigits;
+      if (significantDigits !== 1) {
+        while (
+          representation[
+            firstNonZero + significantDigits - 1 + Number(sawSign) + Number(sawRadix)
+          ] === '0'
+        ) {
+          significantDigits = significantDigits - 1;
+        }
+      }
+    }
+
+    // Normalization of exponent
+    // Correct exponent based on radix position, and shift significand as needed
+    // to represent user input
+
+    // Overflow prevention
+    if (exponent <= radixPosition && radixPosition > exponent + (1 << 14)) {
+      exponent = EXPONENT_MIN;
+    } else {
+      exponent = exponent - radixPosition;
+    }
+
+    // Attempt to normalize the exponent
+    while (exponent > EXPONENT_MAX) {
+      // Shift exponent to significand and decrease
+      lastDigit = lastDigit + 1;
+      if (lastDigit >= MAX_DIGITS) {
+        // Check if we have a zero then just hard clamp, otherwise fail
+        if (significantDigits === 0) {
+          exponent = EXPONENT_MAX;
+          break;
+        }
+
+        invalidErr(representation, 'overflow');
+      }
+      exponent = exponent - 1;
+    }
+
+    if (options.allowRounding) {
+      while (exponent < EXPONENT_MIN || nDigitsStored < nDigits) {
+        // Shift last digit. can only do this if < significant digits than # stored.
+        if (lastDigit === 0 && significantDigits < nDigitsStored) {
+          exponent = EXPONENT_MIN;
+          significantDigits = 0;
+          break;
+        }
+
+        if (nDigitsStored < nDigits) {
+          // adjust to match digits not stored
+          nDigits = nDigits - 1;
+        } else {
+          // adjust to round
+          lastDigit = lastDigit - 1;
+        }
+
+        if (exponent < EXPONENT_MAX) {
+          exponent = exponent + 1;
+        } else {
+          // Check if we have a zero then just hard clamp, otherwise fail
+          const digitsString = digits.join('');
+          if (digitsString.match(/^0+$/)) {
+            exponent = EXPONENT_MAX;
+            break;
+          }
+          invalidErr(representation, 'overflow');
+        }
+      }
+
+      // Round
+      // We've normalized the exponent, but might still need to round.
+      if (lastDigit + 1 < significantDigits) {
+        let endOfString = nDigitsRead;
+
+        // If we have seen a radix point, 'string' is 1 longer than we have
+        // documented with ndigits_read, so inc the position of the first nonzero
+        // digit and the position that digits are read to.
+        if (sawRadix) {
+          firstNonZero = firstNonZero + 1;
+          endOfString = endOfString + 1;
+        }
+        // if negative, we need to increment again to account for - sign at start.
+        if (sawSign) {
+          firstNonZero = firstNonZero + 1;
+          endOfString = endOfString + 1;
+        }
+
+        const roundDigit = parseInt(representation[firstNonZero + lastDigit + 1], 10);
+        let roundBit = 0;
+
+        if (roundDigit >= 5) {
+          roundBit = 1;
+          if (roundDigit === 5) {
+            roundBit = digits[lastDigit] % 2 === 1 ? 1 : 0;
+            for (let i = firstNonZero + lastDigit + 2; i < endOfString; i++) {
+              if (parseInt(representation[i], 10)) {
+                roundBit = 1;
+                break;
+              }
+            }
+          }
+        }
+
+        if (roundBit) {
+          let dIdx = lastDigit;
+
+          for (; dIdx >= 0; dIdx--) {
+            if (++digits[dIdx] > 9) {
+              digits[dIdx] = 0;
+
+              // overflowed most significant digit
+              if (dIdx === 0) {
+                if (exponent < EXPONENT_MAX) {
+                  exponent = exponent + 1;
+                  digits[dIdx] = 1;
+                } else {
+                  return new Decimal128(isNegative ? INF_NEGATIVE_BUFFER : INF_POSITIVE_BUFFER);
+                }
+              }
+            } else {
+              break;
+            }
+          }
+        }
+      }
+    } else {
+      while (exponent < EXPONENT_MIN || nDigitsStored < nDigits) {
+        // Shift last digit. can only do this if < significant digits than # stored.
+        if (lastDigit === 0) {
+          if (significantDigits === 0) {
+            exponent = EXPONENT_MIN;
+            break;
+          }
+
+          invalidErr(representation, 'exponent underflow');
+        }
+
+        if (nDigitsStored < nDigits) {
+          if (
+            representation[nDigits - 1 + Number(sawSign) + Number(sawRadix)] !== '0' &&
+            significantDigits !== 0
+          ) {
+            invalidErr(representation, 'inexact rounding');
+          }
+          // adjust to match digits not stored
+          nDigits = nDigits - 1;
+        } else {
+          if (digits[lastDigit] !== 0) {
+            invalidErr(representation, 'inexact rounding');
+          }
+          // adjust to round
+          lastDigit = lastDigit - 1;
+        }
+
+        if (exponent < EXPONENT_MAX) {
+          exponent = exponent + 1;
+        } else {
+          invalidErr(representation, 'overflow');
+        }
+      }
+
+      // Round
+      // We've normalized the exponent, but might still need to round.
+      if (lastDigit + 1 < significantDigits) {
+        // If we have seen a radix point, 'string' is 1 longer than we have
+        // documented with ndigits_read, so inc the position of the first nonzero
+        // digit and the position that digits are read to.
+        if (sawRadix) {
+          firstNonZero = firstNonZero + 1;
+        }
+        // if saw sign, we need to increment again to account for - or + sign at start.
+        if (sawSign) {
+          firstNonZero = firstNonZero + 1;
+        }
+
+        const roundDigit = parseInt(representation[firstNonZero + lastDigit + 1], 10);
+
+        if (roundDigit !== 0) {
+          invalidErr(representation, 'inexact rounding');
+        }
+      }
+    }
+
+    // Encode significand
+    // The high 17 digits of the significand
+    significandHigh = Long.fromNumber(0);
+    // The low 17 digits of the significand
+    significandLow = Long.fromNumber(0);
+
+    // read a zero
+    if (significantDigits === 0) {
+      significandHigh = Long.fromNumber(0);
+      significandLow = Long.fromNumber(0);
+    } else if (lastDigit < 17) {
+      let dIdx = 0;
+      significandLow = Long.fromNumber(digits[dIdx++]);
+      significandHigh = new Long(0, 0);
+
+      for (; dIdx <= lastDigit; dIdx++) {
+        significandLow = significandLow.multiply(Long.fromNumber(10));
+        significandLow = significandLow.add(Long.fromNumber(digits[dIdx]));
+      }
+    } else {
+      let dIdx = 0;
+      significandHigh = Long.fromNumber(digits[dIdx++]);
+
+      for (; dIdx <= lastDigit - 17; dIdx++) {
+        significandHigh = significandHigh.multiply(Long.fromNumber(10));
+        significandHigh = significandHigh.add(Long.fromNumber(digits[dIdx]));
+      }
+
+      significandLow = Long.fromNumber(digits[dIdx++]);
+
+      for (; dIdx <= lastDigit; dIdx++) {
+        significandLow = significandLow.multiply(Long.fromNumber(10));
+        significandLow = significandLow.add(Long.fromNumber(digits[dIdx]));
+      }
+    }
+
+    const significand = multiply64x2(significandHigh, Long.fromString('100000000000000000'));
+    significand.low = significand.low.add(significandLow);
+
+    if (lessThan(significand.low, significandLow)) {
+      significand.high = significand.high.add(Long.fromNumber(1));
+    }
+
+    // Biased exponent
+    biasedExponent = exponent + EXPONENT_BIAS;
+    const dec = { low: Long.fromNumber(0), high: Long.fromNumber(0) };
+
+    // Encode combination, exponent, and significand.
+    if (
+      significand.high.shiftRightUnsigned(49).and(Long.fromNumber(1)).equals(Long.fromNumber(1))
+    ) {
+      // Encode '11' into bits 1 to 3
+      dec.high = dec.high.or(Long.fromNumber(0x3).shiftLeft(61));
+      dec.high = dec.high.or(
+        Long.fromNumber(biasedExponent).and(Long.fromNumber(0x3fff).shiftLeft(47))
+      );
+      dec.high = dec.high.or(significand.high.and(Long.fromNumber(0x7fffffffffff)));
+    } else {
+      dec.high = dec.high.or(Long.fromNumber(biasedExponent & 0x3fff).shiftLeft(49));
+      dec.high = dec.high.or(significand.high.and(Long.fromNumber(0x1ffffffffffff)));
+    }
+
+    dec.low = significand.low;
+
+    // Encode sign
+    if (isNegative) {
+      dec.high = dec.high.or(Long.fromString('9223372036854775808'));
+    }
+
+    // Encode into a buffer
+    const buffer = ByteUtils.allocateUnsafe(16);
+    index = 0;
+
+    // Encode the low 64 bits of the decimal
+    // Encode low bits
+    buffer[index++] = dec.low.low & 0xff;
+    buffer[index++] = (dec.low.low >> 8) & 0xff;
+    buffer[index++] = (dec.low.low >> 16) & 0xff;
+    buffer[index++] = (dec.low.low >> 24) & 0xff;
+    // Encode high bits
+    buffer[index++] = dec.low.high & 0xff;
+    buffer[index++] = (dec.low.high >> 8) & 0xff;
+    buffer[index++] = (dec.low.high >> 16) & 0xff;
+    buffer[index++] = (dec.low.high >> 24) & 0xff;
+
+    // Encode the high 64 bits of the decimal
+    // Encode low bits
+    buffer[index++] = dec.high.low & 0xff;
+    buffer[index++] = (dec.high.low >> 8) & 0xff;
+    buffer[index++] = (dec.high.low >> 16) & 0xff;
+    buffer[index++] = (dec.high.low >> 24) & 0xff;
+    // Encode high bits
+    buffer[index++] = dec.high.high & 0xff;
+    buffer[index++] = (dec.high.high >> 8) & 0xff;
+    buffer[index++] = (dec.high.high >> 16) & 0xff;
+    buffer[index++] = (dec.high.high >> 24) & 0xff;
+
+    // Return the new Decimal128
+    return new Decimal128(buffer);
+  }
+  /** Create a string representation of the raw Decimal128 value */
+  toString(): string {
+    // Note: bits in this routine are referred to starting at 0,
+    // from the sign bit, towards the coefficient.
+
+    // decoded biased exponent (14 bits)
+    let biased_exponent;
+    // the number of significand digits
+    let significand_digits = 0;
+    // the base-10 digits in the significand
+    const significand = new Array<number>(36);
+    for (let i = 0; i < significand.length; i++) significand[i] = 0;
+    // read pointer into significand
+    let index = 0;
+
+    // true if the number is zero
+    let is_zero = false;
+
+    // the most significant significand bits (50-46)
+    let significand_msb;
+    // temporary storage for significand decoding
+    let significand128: { parts: [number, number, number, number] } = { parts: [0, 0, 0, 0] };
+    // indexing variables
+    let j, k;
+
+    // Output string
+    const string: string[] = [];
+
+    // Unpack index
+    index = 0;
+
+    // Buffer reference
+    const buffer = this.bytes;
+
+    // Unpack the low 64bits into a long
+    // bits 96 - 127
+    const low =
+      buffer[index++] | (buffer[index++] << 8) | (buffer[index++] << 16) | (buffer[index++] << 24);
+    // bits 64 - 95
+    const midl =
+      buffer[index++] | (buffer[index++] << 8) | (buffer[index++] << 16) | (buffer[index++] << 24);
+
+    // Unpack the high 64bits into a long
+    // bits 32 - 63
+    const midh =
+      buffer[index++] | (buffer[index++] << 8) | (buffer[index++] << 16) | (buffer[index++] << 24);
+    // bits 0 - 31
+    const high =
+      buffer[index++] | (buffer[index++] << 8) | (buffer[index++] << 16) | (buffer[index++] << 24);
+
+    // Unpack index
+    index = 0;
+
+    // Create the state of the decimal
+    const dec = {
+      low: new Long(low, midl),
+      high: new Long(midh, high)
+    };
+
+    if (dec.high.lessThan(Long.ZERO)) {
+      string.push('-');
+    }
+
+    // Decode combination field and exponent
+    // bits 1 - 5
+    const combination = (high >> 26) & COMBINATION_MASK;
+
+    if (combination >> 3 === 3) {
+      // Check for 'special' values
+      if (combination === COMBINATION_INFINITY) {
+        return string.join('') + 'Infinity';
+      } else if (combination === COMBINATION_NAN) {
+        return 'NaN';
+      } else {
+        biased_exponent = (high >> 15) & EXPONENT_MASK;
+        significand_msb = 0x08 + ((high >> 14) & 0x01);
+      }
+    } else {
+      significand_msb = (high >> 14) & 0x07;
+      biased_exponent = (high >> 17) & EXPONENT_MASK;
+    }
+
+    // unbiased exponent
+    const exponent = biased_exponent - EXPONENT_BIAS;
+
+    // Create string of significand digits
+
+    // Convert the 114-bit binary number represented by
+    // (significand_high, significand_low) to at most 34 decimal
+    // digits through modulo and division.
+    significand128.parts[0] = (high & 0x3fff) + ((significand_msb & 0xf) << 14);
+    significand128.parts[1] = midh;
+    significand128.parts[2] = midl;
+    significand128.parts[3] = low;
+
+    if (
+      significand128.parts[0] === 0 &&
+      significand128.parts[1] === 0 &&
+      significand128.parts[2] === 0 &&
+      significand128.parts[3] === 0
+    ) {
+      is_zero = true;
+    } else {
+      for (k = 3; k >= 0; k--) {
+        let least_digits = 0;
+        // Perform the divide
+        const result = divideu128(significand128);
+        significand128 = result.quotient;
+        least_digits = result.rem.low;
+
+        // We now have the 9 least significant digits (in base 2).
+        // Convert and output to string.
+        if (!least_digits) continue;
+
+        for (j = 8; j >= 0; j--) {
+          // significand[k * 9 + j] = Math.round(least_digits % 10);
+          significand[k * 9 + j] = least_digits % 10;
+          // least_digits = Math.round(least_digits / 10);
+          least_digits = Math.floor(least_digits / 10);
+        }
+      }
+    }
+
+    // Output format options:
+    // Scientific - [-]d.dddE(+/-)dd or [-]dE(+/-)dd
+    // Regular    - ddd.ddd
+
+    if (is_zero) {
+      significand_digits = 1;
+      significand[index] = 0;
+    } else {
+      significand_digits = 36;
+      while (!significand[index]) {
+        significand_digits = significand_digits - 1;
+        index = index + 1;
+      }
+    }
+
+    // the exponent if scientific notation is used
+    const scientific_exponent = significand_digits - 1 + exponent;
+
+    // The scientific exponent checks are dictated by the string conversion
+    // specification and are somewhat arbitrary cutoffs.
+    //
+    // We must check exponent > 0, because if this is the case, the number
+    // has trailing zeros.  However, we *cannot* output these trailing zeros,
+    // because doing so would change the precision of the value, and would
+    // change stored data if the string converted number is round tripped.
+    if (scientific_exponent >= 34 || scientific_exponent <= -7 || exponent > 0) {
+      // Scientific format
+
+      // if there are too many significant digits, we should just be treating numbers
+      // as + or - 0 and using the non-scientific exponent (this is for the "invalid
+      // representation should be treated as 0/-0" spec cases in decimal128-1.json)
+      if (significand_digits > 34) {
+        string.push(`${0}`);
+        if (exponent > 0) string.push(`E+${exponent}`);
+        else if (exponent < 0) string.push(`E${exponent}`);
+        return string.join('');
+      }
+
+      string.push(`${significand[index++]}`);
+      significand_digits = significand_digits - 1;
+
+      if (significand_digits) {
+        string.push('.');
+      }
+
+      for (let i = 0; i < significand_digits; i++) {
+        string.push(`${significand[index++]}`);
+      }
+
+      // Exponent
+      string.push('E');
+      if (scientific_exponent > 0) {
+        string.push(`+${scientific_exponent}`);
+      } else {
+        string.push(`${scientific_exponent}`);
+      }
+    } else {
+      // Regular format with no decimal place
+      if (exponent >= 0) {
+        for (let i = 0; i < significand_digits; i++) {
+          string.push(`${significand[index++]}`);
+        }
+      } else {
+        let radix_position = significand_digits + exponent;
+
+        // non-zero digits before radix
+        if (radix_position > 0) {
+          for (let i = 0; i < radix_position; i++) {
+            string.push(`${significand[index++]}`);
+          }
+        } else {
+          string.push('0');
+        }
+
+        string.push('.');
+        // add leading zeros after radix
+        while (radix_position++ < 0) {
+          string.push('0');
+        }
+
+        for (let i = 0; i < significand_digits - Math.max(radix_position - 1, 0); i++) {
+          string.push(`${significand[index++]}`);
+        }
+      }
+    }
+
+    return string.join('');
+  }
+
+  toJSON(): Decimal128Extended {
+    return { $numberDecimal: this.toString() };
+  }
+
+  /** @internal */
+  toExtendedJSON(): Decimal128Extended {
+    return { $numberDecimal: this.toString() };
+  }
+
+  /** @internal */
+  static fromExtendedJSON(doc: Decimal128Extended): Decimal128 {
+    return Decimal128.fromString(doc.$numberDecimal);
+  }
+
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+    const d128string = inspect(this.toString(), options);
+    return `new Decimal128(${d128string})`;
+  }
+}

gateway/node_modules/bson/src/double.ts

@@ -0,0 +1,115 @@
+import { BSONValue } from './bson_value';
+import { BSONError } from './error';
+import type { EJSONOptions } from './extended_json';
+import { type InspectFn, defaultInspect } from './parser/utils';
+
+/** @public */
+export interface DoubleExtended {
+  $numberDouble: string;
+}
+
+/**
+ * A class representation of the BSON Double type.
+ * @public
+ * @category BSONType
+ */
+export class Double extends BSONValue {
+  get _bsontype(): 'Double' {
+    return 'Double';
+  }
+
+  value!: number;
+  /**
+   * Create a Double type
+   *
+   * @param value - the number we want to represent as a double.
+   */
+  constructor(value: number) {
+    super();
+    if ((value as unknown) instanceof Number) {
+      value = value.valueOf();
+    }
+
+    this.value = +value;
+  }
+
+  /**
+   * Attempt to create an double type from string.
+   *
+   * This method will throw a BSONError on any string input that is not representable as a IEEE-754 64-bit double.
+   * Notably, this method will also throw on the following string formats:
+   * - Strings in non-decimal and non-exponential formats (binary, hex, or octal digits)
+   * - Strings with characters other than numeric, floating point, or leading sign characters (Note: 'Infinity', '-Infinity', and 'NaN' input strings are still allowed)
+   * - Strings with leading and/or trailing whitespace
+   *
+   * Strings with leading zeros, however, are also allowed
+   *
+   * @param value - the string we want to represent as a double.
+   */
+  static fromString(value: string): Double {
+    const coercedValue = Number(value);
+
+    if (value === 'NaN') return new Double(NaN);
+    if (value === 'Infinity') return new Double(Infinity);
+    if (value === '-Infinity') return new Double(-Infinity);
+
+    if (!Number.isFinite(coercedValue)) {
+      throw new BSONError(`Input: ${value} is not representable as a Double`);
+    }
+    if (value.trim() !== value) {
+      throw new BSONError(`Input: '${value}' contains whitespace`);
+    }
+    if (value === '') {
+      throw new BSONError(`Input is an empty string`);
+    }
+    if (/[^-0-9.+eE]/.test(value)) {
+      throw new BSONError(`Input: '${value}' is not in decimal or exponential notation`);
+    }
+    return new Double(coercedValue);
+  }
+
+  /**
+   * Access the number value.
+   *
+   * @returns returns the wrapped double number.
+   */
+  valueOf(): number {
+    return this.value;
+  }
+
+  toJSON(): number {
+    return this.value;
+  }
+
+  toString(radix?: number): string {
+    return this.value.toString(radix);
+  }
+
+  /** @internal */
+  toExtendedJSON(options?: EJSONOptions): number | DoubleExtended {
+    if (options && (options.legacy || (options.relaxed && isFinite(this.value)))) {
+      return this.value;
+    }
+
+    if (Object.is(Math.sign(this.value), -0)) {
+      // NOTE: JavaScript has +0 and -0, apparently to model limit calculations. If a user
+      // explicitly provided `-0` then we need to ensure the sign makes it into the output
+      return { $numberDouble: '-0.0' };
+    }
+
+    return {
+      $numberDouble: Number.isInteger(this.value) ? this.value.toFixed(1) : this.value.toString()
+    };
+  }
+
+  /** @internal */
+  static fromExtendedJSON(doc: DoubleExtended, options?: EJSONOptions): number | Double {
+    const doubleValue = parseFloat(doc.$numberDouble);
+    return options && options.relaxed ? doubleValue : new Double(doubleValue);
+  }
+
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+    return `new Double(${inspect(this.value, options)})`;
+  }
+}

gateway/node_modules/bson/src/error.ts

@@ -0,0 +1,105 @@
+import { BSON_MAJOR_VERSION } from './constants';
+
+/**
+ * @public
+ * @category Error
+ *
+ * `BSONError` objects are thrown when BSON encounters an error.
+ *
+ * This is the parent class for all the other errors thrown by this library.
+ */
+export class BSONError extends Error {
+  /**
+   * @internal
+   * The underlying algorithm for isBSONError may change to improve how strict it is
+   * about determining if an input is a BSONError. But it must remain backwards compatible
+   * with previous minors & patches of the current major version.
+   */
+  protected get bsonError(): true {
+    return true;
+  }
+
+  override get name(): string {
+    return 'BSONError';
+  }
+
+  constructor(message: string, options?: { cause?: unknown }) {
+    super(message, options);
+  }
+
+  /**
+   * @public
+   *
+   * All errors thrown from the BSON library inherit from `BSONError`.
+   * This method can assist with determining if an error originates from the BSON library
+   * even if it does not pass an `instanceof` check against this class' constructor.
+   *
+   * @param value - any javascript value that needs type checking
+   */
+  public static isBSONError(value: unknown): value is BSONError {
+    return (
+      value != null &&
+      typeof value === 'object' &&
+      'bsonError' in value &&
+      value.bsonError === true &&
+      // Do not access the following properties, just check existence
+      'name' in value &&
+      'message' in value &&
+      'stack' in value
+    );
+  }
+}
+
+/**
+ * @public
+ * @category Error
+ */
+export class BSONVersionError extends BSONError {
+  get name(): 'BSONVersionError' {
+    return 'BSONVersionError';
+  }
+
+  constructor() {
+    super(`Unsupported BSON version, bson types must be from bson ${BSON_MAJOR_VERSION}.x.x`);
+  }
+}
+
+/**
+ * @public
+ * @category Error
+ *
+ * An error generated when BSON functions encounter an unexpected input
+ * or reaches an unexpected/invalid internal state
+ *
+ */
+export class BSONRuntimeError extends BSONError {
+  get name(): 'BSONRuntimeError' {
+    return 'BSONRuntimeError';
+  }
+
+  constructor(message: string) {
+    super(message);
+  }
+}
+
+/**
+ * @public
+ * @category Error
+ *
+ * @experimental
+ *
+ * An error generated when BSON bytes are invalid.
+ * Reports the offset the parser was able to reach before encountering the error.
+ */
+export class BSONOffsetError extends BSONError {
+  public get name(): 'BSONOffsetError' {
+    return 'BSONOffsetError';
+  }
+
+  public offset: number;
+
+  constructor(message: string, offset: number, options?: { cause?: unknown }) {
+    super(`${message}. offset: ${offset}`, options);
+    this.offset = offset;
+  }
+}

gateway/node_modules/bson/src/extended_json.ts

@@ -0,0 +1,557 @@
+import { Binary } from './binary';
+import type { Document } from './bson';
+import { Code } from './code';
+import {
+  BSON_INT32_MAX,
+  BSON_INT32_MIN,
+  BSON_INT64_MAX,
+  BSON_INT64_MIN,
+  BSON_MAJOR_VERSION,
+  BSON_VERSION_SYMBOL
+} from './constants';
+import { DBRef, isDBRefLike } from './db_ref';
+import { Decimal128 } from './decimal128';
+import { Double } from './double';
+import { BSONError, BSONRuntimeError, BSONVersionError } from './error';
+import { Int32 } from './int_32';
+import { Long } from './long';
+import { MaxKey } from './max_key';
+import { MinKey } from './min_key';
+import { ObjectId } from './objectid';
+import { isDate, isRegExp, isMap } from './parser/utils';
+import { BSONRegExp } from './regexp';
+import { BSONSymbol } from './symbol';
+import { Timestamp } from './timestamp';
+
+/** @public */
+export type EJSONOptionsBase = {
+  /**
+   * Output using the Extended JSON v1 spec
+   * @defaultValue `false`
+   */
+  legacy?: boolean;
+  /**
+   * Enable Extended JSON's `relaxed` mode, which attempts to return native JS types where possible, rather than BSON types
+   * @defaultValue `false`
+   */
+  relaxed?: boolean;
+};
+
+/** @public */
+export type EJSONSerializeOptions = EJSONOptionsBase & {
+  /**
+   * Omits undefined values from the output instead of converting them to null
+   * @defaultValue `false`
+   */
+  ignoreUndefined?: boolean;
+};
+
+/** @public */
+export type EJSONParseOptions = EJSONOptionsBase & {
+  /**
+   * Enable native bigint support
+   * @defaultValue `false`
+   */
+  useBigInt64?: boolean;
+};
+
+/** @public */
+export type EJSONOptions = EJSONSerializeOptions & EJSONParseOptions;
+
+/** @internal */
+type BSONType =
+  | Binary
+  | Code
+  | DBRef
+  | Decimal128
+  | Double
+  | Int32
+  | Long
+  | MaxKey
+  | MinKey
+  | ObjectId
+  | BSONRegExp
+  | BSONSymbol
+  | Timestamp;
+
+function isBSONType(value: unknown): value is BSONType {
+  return (
+    value != null &&
+    typeof value === 'object' &&
+    '_bsontype' in value &&
+    typeof value._bsontype === 'string'
+  );
+}
+
+// all the types where we don't need to do any special processing and can just pass the EJSON
+//straight to type.fromExtendedJSON
+const keysToCodecs = {
+  $oid: ObjectId,
+  $binary: Binary,
+  $uuid: Binary,
+  $symbol: BSONSymbol,
+  $numberInt: Int32,
+  $numberDecimal: Decimal128,
+  $numberDouble: Double,
+  $numberLong: Long,
+  $minKey: MinKey,
+  $maxKey: MaxKey,
+  $regex: BSONRegExp,
+  $regularExpression: BSONRegExp,
+  $timestamp: Timestamp
+} as const;
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function deserializeValue(value: any, options: EJSONOptions = {}) {
+  if (typeof value === 'number') {
+    // TODO(NODE-4377): EJSON js number handling diverges from BSON
+    const in32BitRange = value <= BSON_INT32_MAX && value >= BSON_INT32_MIN;
+    const in64BitRange = value <= BSON_INT64_MAX && value >= BSON_INT64_MIN;
+
+    if (options.relaxed || options.legacy) {
+      return value;
+    }
+
+    if (Number.isInteger(value) && !Object.is(value, -0)) {
+      // interpret as being of the smallest BSON integer type that can represent the number exactly
+      if (in32BitRange) {
+        return new Int32(value);
+      }
+      if (in64BitRange) {
+        if (options.useBigInt64) {
+          return BigInt(value);
+        }
+        return Long.fromNumber(value);
+      }
+    }
+
+    // If the number is a non-integer or out of integer range, should interpret as BSON Double.
+    return new Double(value);
+  }
+
+  // from here on out we're looking for bson types, so bail if its not an object
+  if (value == null || typeof value !== 'object') return value;
+
+  // upgrade deprecated undefined to null
+  if (value.$undefined) return null;
+
+  const keys = Object.keys(value).filter(
+    k => k.startsWith('$') && value[k] != null
+  ) as (keyof typeof keysToCodecs)[];
+  for (let i = 0; i < keys.length; i++) {
+    const c = keysToCodecs[keys[i]];
+    if (c) return c.fromExtendedJSON(value, options);
+  }
+
+  if (value.$date != null) {
+    const d = value.$date;
+    const date = new Date();
+
+    if (options.legacy) {
+      if (typeof d === 'number') date.setTime(d);
+      else if (typeof d === 'string') date.setTime(Date.parse(d));
+      else if (typeof d === 'bigint') date.setTime(Number(d));
+      else throw new BSONRuntimeError(`Unrecognized type for EJSON date: ${typeof d}`);
+    } else {
+      if (typeof d === 'string') date.setTime(Date.parse(d));
+      else if (Long.isLong(d)) date.setTime(d.toNumber());
+      else if (typeof d === 'number' && options.relaxed) date.setTime(d);
+      else if (typeof d === 'bigint') date.setTime(Number(d));
+      else throw new BSONRuntimeError(`Unrecognized type for EJSON date: ${typeof d}`);
+    }
+    return date;
+  }
+
+  if (value.$code != null) {
+    const copy = Object.assign({}, value);
+    if (value.$scope) {
+      copy.$scope = deserializeValue(value.$scope);
+    }
+
+    return Code.fromExtendedJSON(value);
+  }
+
+  if (isDBRefLike(value) || value.$dbPointer) {
+    const v = value.$ref ? value : value.$dbPointer;
+
+    // we run into this in a "degenerate EJSON" case (with $id and $ref order flipped)
+    // because of the order JSON.parse goes through the document
+    if (v instanceof DBRef) return v;
+
+    const dollarKeys = Object.keys(v).filter(k => k.startsWith('$'));
+    let valid = true;
+    dollarKeys.forEach(k => {
+      if (['$ref', '$id', '$db'].indexOf(k) === -1) valid = false;
+    });
+
+    // only make DBRef if $ keys are all valid
+    if (valid) return DBRef.fromExtendedJSON(v);
+  }
+
+  return value;
+}
+
+type EJSONSerializeInternalOptions = EJSONSerializeOptions & {
+  seenObjects: { obj: unknown; propertyName: string }[];
+};
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function serializeArray(array: any[], options: EJSONSerializeInternalOptions): any[] {
+  return array.map((v: unknown, index: number) => {
+    options.seenObjects.push({ propertyName: `index ${index}`, obj: null });
+    try {
+      return serializeValue(v, options);
+    } finally {
+      options.seenObjects.pop();
+    }
+  });
+}
+
+function getISOString(date: Date) {
+  const isoStr = date.toISOString();
+  // we should only show milliseconds in timestamp if they're non-zero
+  return date.getUTCMilliseconds() !== 0 ? isoStr : isoStr.slice(0, -5) + 'Z';
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function serializeValue(value: any, options: EJSONSerializeInternalOptions): any {
+  if (value instanceof Map || isMap(value)) {
+    const obj: Record<string, unknown> = Object.create(null);
+    for (const [k, v] of value) {
+      if (typeof k !== 'string') {
+        throw new BSONError('Can only serialize maps with string keys');
+      }
+      obj[k] = v;
+    }
+
+    return serializeValue(obj, options);
+  }
+
+  if ((typeof value === 'object' || typeof value === 'function') && value !== null) {
+    const index = options.seenObjects.findIndex(entry => entry.obj === value);
+    if (index !== -1) {
+      const props = options.seenObjects.map(entry => entry.propertyName);
+      const leadingPart = props
+        .slice(0, index)
+        .map(prop => `${prop} -> `)
+        .join('');
+      const alreadySeen = props[index];
+      const circularPart =
+        ' -> ' +
+        props
+          .slice(index + 1, props.length - 1)
+          .map(prop => `${prop} -> `)
+          .join('');
+      const current = props[props.length - 1];
+      const leadingSpace = ' '.repeat(leadingPart.length + alreadySeen.length / 2);
+      const dashes = '-'.repeat(
+        circularPart.length + (alreadySeen.length + current.length) / 2 - 1
+      );
+
+      throw new BSONError(
+        'Converting circular structure to EJSON:\n' +
+          `    ${leadingPart}${alreadySeen}${circularPart}${current}\n` +
+          `    ${leadingSpace}\\${dashes}/`
+      );
+    }
+    options.seenObjects[options.seenObjects.length - 1].obj = value;
+  }
+
+  if (Array.isArray(value)) return serializeArray(value, options);
+
+  if (value === undefined) return options.ignoreUndefined ? undefined : null;
+
+  if (value instanceof Date || isDate(value)) {
+    const dateNum = value.getTime(),
+      // is it in year range 1970-9999?
+      // 253402300800000 is the first instant of year 10000 (+010000-01-01T00:00:00Z).
+      // It is the exclusive upper bound: a relaxed date is emitted as an ISO 8601 string,
+      // which only has a 4-digit year, so year 10000 and later are kept as a numeric timestamp.
+      inRange = dateNum > -1 && dateNum < 253402300800000;
+
+    if (options.legacy) {
+      return options.relaxed && inRange
+        ? { $date: value.getTime() }
+        : { $date: getISOString(value) };
+    }
+    return options.relaxed && inRange
+      ? { $date: getISOString(value) }
+      : { $date: { $numberLong: value.getTime().toString() } };
+  }
+
+  if (typeof value === 'number' && (!options.relaxed || !isFinite(value))) {
+    if (Number.isInteger(value) && !Object.is(value, -0)) {
+      // interpret as being of the smallest BSON integer type that can represent the number exactly
+      if (value >= BSON_INT32_MIN && value <= BSON_INT32_MAX) {
+        return { $numberInt: value.toString() };
+      }
+      if (value >= BSON_INT64_MIN && value <= BSON_INT64_MAX) {
+        // TODO(NODE-4377): EJSON js number handling diverges from BSON
+        return { $numberLong: value.toString() };
+      }
+    }
+    return { $numberDouble: Object.is(value, -0) ? '-0.0' : value.toString() };
+  }
+
+  if (typeof value === 'bigint') {
+    if (!options.relaxed) {
+      return { $numberLong: BigInt.asIntN(64, value).toString() };
+    }
+    return Number(BigInt.asIntN(64, value));
+  }
+
+  if (value instanceof RegExp || isRegExp(value)) {
+    let flags = value.flags;
+    if (flags === undefined) {
+      const match = value.toString().match(/[gimuy]*$/);
+      if (match) {
+        flags = match[0];
+      }
+    }
+
+    const rx = new BSONRegExp(value.source, flags);
+    return rx.toExtendedJSON(options);
+  }
+
+  if (value != null && typeof value === 'object') return serializeDocument(value, options);
+  return value;
+}
+
+const BSON_TYPE_MAPPINGS = {
+  Binary: (o: Binary) => new Binary(o.value(), o.sub_type),
+  Code: (o: Code) => new Code(o.code, o.scope),
+  DBRef: (o: DBRef) => new DBRef(o.collection || o.namespace, o.oid, o.db, o.fields), // "namespace" for 1.x library backwards compat
+  Decimal128: (o: Decimal128) => new Decimal128(o.bytes),
+  Double: (o: Double) => new Double(o.value),
+  Int32: (o: Int32) => new Int32(o.value),
+  Long: (
+    o: Long & {
+      low_: number;
+      high_: number;
+      unsigned_: boolean | undefined;
+    }
+  ) =>
+    Long.fromBits(
+      // underscore variants for 1.x backwards compatibility
+      o.low != null ? o.low : o.low_,
+      o.low != null ? o.high : o.high_,
+      o.low != null ? o.unsigned : o.unsigned_
+    ),
+  MaxKey: () => new MaxKey(),
+  MinKey: () => new MinKey(),
+  ObjectId: (o: ObjectId) => new ObjectId(o),
+  BSONRegExp: (o: BSONRegExp) => new BSONRegExp(o.pattern, o.options),
+  BSONSymbol: (o: BSONSymbol) => new BSONSymbol(o.value),
+  Timestamp: (o: Timestamp) => Timestamp.fromBits(o.low, o.high)
+} as const;
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function serializeDocument(doc: any, options: EJSONSerializeInternalOptions) {
+  if (doc == null || typeof doc !== 'object') throw new BSONError('not an object instance');
+
+  const bsontype: BSONType['_bsontype'] = doc._bsontype;
+  if (typeof bsontype === 'undefined') {
+    // It's a regular object. Recursively serialize its property values.
+    const _doc: Document = {};
+    for (const name of Object.keys(doc)) {
+      options.seenObjects.push({ propertyName: name, obj: null });
+      try {
+        const value = serializeValue(doc[name], options);
+        if (name === '__proto__') {
+          Object.defineProperty(_doc, name, {
+            value,
+            writable: true,
+            enumerable: true,
+            configurable: true
+          });
+        } else {
+          _doc[name] = value;
+        }
+      } finally {
+        options.seenObjects.pop();
+      }
+    }
+    return _doc;
+  } else if (
+    doc != null &&
+    typeof doc === 'object' &&
+    typeof doc._bsontype === 'string' &&
+    doc[BSON_VERSION_SYMBOL] !== BSON_MAJOR_VERSION
+  ) {
+    throw new BSONVersionError();
+  } else if (isBSONType(doc)) {
+    // the "document" is really just a BSON type object
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let outDoc: any = doc;
+    if (typeof outDoc.toExtendedJSON !== 'function') {
+      // There's no EJSON serialization function on the object. It's probably an
+      // object created by a previous version of this library (or another library)
+      // that's duck-typing objects to look like they were generated by this library).
+      // Copy the object into this library's version of that type.
+      const mapper = BSON_TYPE_MAPPINGS[doc._bsontype];
+      if (!mapper) {
+        throw new BSONError('Unrecognized or invalid _bsontype: ' + doc._bsontype);
+      }
+      outDoc = mapper(outDoc);
+    }
+
+    // Two BSON types may have nested objects that may need to be serialized too
+    if (bsontype === 'Code' && outDoc.scope) {
+      outDoc = new Code(outDoc.code, serializeValue(outDoc.scope, options));
+    } else if (bsontype === 'DBRef' && outDoc.oid) {
+      outDoc = new DBRef(
+        serializeValue(outDoc.collection, options),
+        serializeValue(outDoc.oid, options),
+        serializeValue(outDoc.db, options),
+        serializeValue(outDoc.fields, options)
+      );
+    }
+
+    return outDoc.toExtendedJSON(options);
+  } else {
+    throw new BSONError('_bsontype must be a string, but was: ' + typeof bsontype);
+  }
+}
+
+/**
+ * Parse an Extended JSON string, constructing the JavaScript value or object described by that
+ * string.
+ *
+ * @example
+ * ```js
+ * const { EJSON } = require('bson');
+ * const text = '{ "int32": { "$numberInt": "10" } }';
+ *
+ * // prints { int32: { [String: '10'] _bsontype: 'Int32', value: '10' } }
+ * console.log(EJSON.parse(text, { relaxed: false }));
+ *
+ * // prints { int32: 10 }
+ * console.log(EJSON.parse(text));
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function parse(text: string, options?: EJSONParseOptions): any {
+  const ejsonOptions = {
+    useBigInt64: options?.useBigInt64 ?? false,
+    relaxed: options?.relaxed ?? true,
+    legacy: options?.legacy ?? false
+  };
+  return JSON.parse(text, (key, value) => {
+    if (key.indexOf('\x00') !== -1) {
+      throw new BSONError(
+        `BSON Document field names cannot contain null bytes, found: ${JSON.stringify(key)}`
+      );
+    }
+    return deserializeValue(value, ejsonOptions);
+  });
+}
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Converts a BSON document to an Extended JSON string, optionally replacing values if a replacer
+ * function is specified or optionally including only the specified properties if a replacer array
+ * is specified.
+ *
+ * @param value - The value to convert to extended JSON
+ * @param replacer - A function that alters the behavior of the stringification process, or an array of String and Number objects that serve as a whitelist for selecting/filtering the properties of the value object to be included in the JSON string. If this value is null or not provided, all properties of the object are included in the resulting JSON string
+ * @param space - A String or Number object that's used to insert white space into the output JSON string for readability purposes.
+ * @param options - Optional settings
+ *
+ * @example
+ * ```js
+ * const { EJSON } = require('bson');
+ * const Int32 = require('mongodb').Int32;
+ * const doc = { int32: new Int32(10) };
+ *
+ * // prints '{"int32":{"$numberInt":"10"}}'
+ * console.log(EJSON.stringify(doc, { relaxed: false }));
+ *
+ * // prints '{"int32":10}'
+ * console.log(EJSON.stringify(doc));
+ *
+ * // prints '{"int32":{"$numberInt":"10"}}' with 2 space indentation
+ * console.log(EJSON.stringify(doc, { relaxed: false }, 2));
+ * ```
+ */
+function stringify(
+  value: any,
+  replacer?: (number | string)[] | ((this: any, key: string, value: any) => any) | null,
+  space?: string | number,
+  options?: EJSONSerializeOptions
+): string;
+function stringify(
+  value: any,
+  replacer?: (number | string)[] | ((this: any, key: string, value: any) => any) | null,
+  options?: EJSONSerializeOptions
+): string;
+function stringify(value: any, options?: EJSONSerializeOptions, space?: string | number): string;
+function stringify(
+  value: any,
+  replacerOrOptions?:
+    | (number | string)[]
+    | ((this: any, key: string, value: any) => any)
+    | null
+    | EJSONSerializeOptions,
+  spaceOrOptions?: string | number | EJSONSerializeOptions,
+  options?: EJSONSerializeOptions
+): string {
+  /* eslint-enable @typescript-eslint/no-explicit-any */
+
+  if (spaceOrOptions != null && typeof spaceOrOptions === 'object') {
+    options = spaceOrOptions;
+    spaceOrOptions = undefined;
+  }
+  if (
+    replacerOrOptions != null &&
+    typeof replacerOrOptions === 'object' &&
+    !Array.isArray(replacerOrOptions)
+  ) {
+    options = replacerOrOptions;
+    replacerOrOptions = undefined;
+  }
+
+  const serializeOptions = Object.assign({ relaxed: true, legacy: false }, options, {
+    seenObjects: [{ propertyName: '(root)', obj: null }]
+  });
+
+  const doc = serializeValue(value, serializeOptions);
+  return JSON.stringify(doc, replacerOrOptions as Parameters<JSON['stringify']>[1], spaceOrOptions);
+}
+
+/**
+ * Serializes an object to an Extended JSON string, and reparse it as a JavaScript object.
+ *
+ * @param value - The object to serialize
+ * @param options - Optional settings passed to the `stringify` function
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function EJSONserialize(value: any, options?: EJSONSerializeOptions): Document {
+  options = options || {};
+  return JSON.parse(stringify(value, options));
+}
+
+/**
+ * Deserializes an Extended JSON object into a plain JavaScript object with native/BSON types
+ *
+ * @param ejson - The Extended JSON object to deserialize
+ * @param options - Optional settings passed to the parse method
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function EJSONdeserialize(ejson: Document, options?: EJSONParseOptions): any {
+  options = options || {};
+  return parse(JSON.stringify(ejson), options);
+}
+
+/** @public */
+const EJSON: {
+  parse: typeof parse;
+  stringify: typeof stringify;
+  serialize: typeof EJSONserialize;
+  deserialize: typeof EJSONdeserialize;
+} = Object.create(null);
+EJSON.parse = parse;
+EJSON.stringify = stringify;
+EJSON.serialize = EJSONserialize;
+EJSON.deserialize = EJSONdeserialize;
+Object.freeze(EJSON);
+export { EJSON };

gateway/node_modules/bson/src/index.ts

@@ -0,0 +1,19 @@
+import * as BSON from './bson';
+
+// Export all named properties from BSON to support
+// import { ObjectId, serialize } from 'bson';
+// const { ObjectId, serialize } = require('bson');
+export * from './bson';
+
+// Export BSON as a namespace to support:
+// import { BSON } from 'bson';
+// const { BSON } = require('bson');
+export { BSON };
+
+// BSON does **NOT** have a default export
+
+// The following will crash in es module environments
+// import BSON from 'bson';
+
+// The following will work as expected, BSON as a namespace of all the APIs (BSON.ObjectId, BSON.serialize)
+// const BSON = require('bson');

gateway/node_modules/bson/src/int_32.ts

@@ -0,0 +1,101 @@
+import { BSONValue } from './bson_value';
+import { BSON_INT32_MAX, BSON_INT32_MIN } from './constants';
+import { BSONError } from './error';
+import type { EJSONOptions } from './extended_json';
+import { type InspectFn, defaultInspect } from './parser/utils';
+import { removeLeadingZerosAndExplicitPlus } from './utils/string_utils';
+
+/** @public */
+export interface Int32Extended {
+  $numberInt: string;
+}
+
+/**
+ * A class representation of a BSON Int32 type.
+ * @public
+ * @category BSONType
+ */
+export class Int32 extends BSONValue {
+  get _bsontype(): 'Int32' {
+    return 'Int32';
+  }
+
+  value!: number;
+  /**
+   * Create an Int32 type
+   *
+   * @param value - the number we want to represent as an int32.
+   */
+  constructor(value: number | string) {
+    super();
+    if ((value as unknown) instanceof Number) {
+      value = value.valueOf();
+    }
+
+    this.value = +value | 0;
+  }
+
+  /**
+   * Attempt to create an Int32 type from string.
+   *
+   * This method will throw a BSONError on any string input that is not representable as an Int32.
+   * Notably, this method will also throw on the following string formats:
+   * - Strings in non-decimal formats (exponent notation, binary, hex, or octal digits)
+   * - Strings non-numeric and non-leading sign characters (ex: '2.0', '24,000')
+   * - Strings with leading and/or trailing whitespace
+   *
+   * Strings with leading zeros, however, are allowed.
+   *
+   * @param value - the string we want to represent as an int32.
+   */
+  static fromString(value: string): Int32 {
+    const cleanedValue = removeLeadingZerosAndExplicitPlus(value);
+
+    const coercedValue = Number(value);
+
+    if (BSON_INT32_MAX < coercedValue) {
+      throw new BSONError(`Input: '${value}' is larger than the maximum value for Int32`);
+    } else if (BSON_INT32_MIN > coercedValue) {
+      throw new BSONError(`Input: '${value}' is smaller than the minimum value for Int32`);
+    } else if (!Number.isSafeInteger(coercedValue)) {
+      throw new BSONError(`Input: '${value}' is not a safe integer`);
+    } else if (coercedValue.toString() !== cleanedValue) {
+      // catch all case
+      throw new BSONError(`Input: '${value}' is not a valid Int32 string`);
+    }
+    return new Int32(coercedValue);
+  }
+
+  /**
+   * Access the number value.
+   *
+   * @returns returns the wrapped int32 number.
+   */
+  valueOf(): number {
+    return this.value;
+  }
+
+  toString(radix?: number): string {
+    return this.value.toString(radix);
+  }
+
+  toJSON(): number {
+    return this.value;
+  }
+
+  /** @internal */
+  toExtendedJSON(options?: EJSONOptions): number | Int32Extended {
+    if (options && (options.relaxed || options.legacy)) return this.value;
+    return { $numberInt: this.value.toString() };
+  }
+
+  /** @internal */
+  static fromExtendedJSON(doc: Int32Extended, options?: EJSONOptions): number | Int32 {
+    return options && options.relaxed ? parseInt(doc.$numberInt, 10) : new Int32(doc.$numberInt);
+  }
+
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+    return `new Int32(${inspect(this.value, options)})`;
+  }
+}

gateway/node_modules/bson/src/long.ts

@@ -0,0 +1,1240 @@
+import { BSONValue } from './bson_value';
+import { BSONError } from './error';
+import type { EJSONOptions } from './extended_json';
+import { type InspectFn, defaultInspect } from './parser/utils';
+import type { Timestamp } from './timestamp';
+import * as StringUtils from './utils/string_utils';
+
+interface LongWASMHelpers {
+  /** Gets the high bits of the last operation performed */
+  get_high(this: void): number;
+  div_u(
+    this: void,
+    lowBits: number,
+    highBits: number,
+    lowBitsDivisor: number,
+    highBitsDivisor: number
+  ): number;
+  div_s(
+    this: void,
+    lowBits: number,
+    highBits: number,
+    lowBitsDivisor: number,
+    highBitsDivisor: number
+  ): number;
+  rem_u(
+    this: void,
+    lowBits: number,
+    highBits: number,
+    lowBitsDivisor: number,
+    highBitsDivisor: number
+  ): number;
+  rem_s(
+    this: void,
+    lowBits: number,
+    highBits: number,
+    lowBitsDivisor: number,
+    highBitsDivisor: number
+  ): number;
+  mul(
+    this: void,
+    lowBits: number,
+    highBits: number,
+    lowBitsMultiplier: number,
+    highBitsMultiplier: number
+  ): number;
+}
+
+/**
+ * wasm optimizations, to do native i64 multiplication and divide
+ */
+let wasm: LongWASMHelpers | undefined = undefined;
+
+/* We do not want to have to include DOM types just for this check */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+declare const WebAssembly: any;
+
+try {
+  wasm = new WebAssembly.Instance(
+    new WebAssembly.Module(
+      // prettier-ignore
+      new Uint8Array([0, 97, 115, 109, 1, 0, 0, 0, 1, 13, 2, 96, 0, 1, 127, 96, 4, 127, 127, 127, 127, 1, 127, 3, 7, 6, 0, 1, 1, 1, 1, 1, 6, 6, 1, 127, 1, 65, 0, 11, 7, 50, 6, 3, 109, 117, 108, 0, 1, 5, 100, 105, 118, 95, 115, 0, 2, 5, 100, 105, 118, 95, 117, 0, 3, 5, 114, 101, 109, 95, 115, 0, 4, 5, 114, 101, 109, 95, 117, 0, 5, 8, 103, 101, 116, 95, 104, 105, 103, 104, 0, 0, 10, 191, 1, 6, 4, 0, 35, 0, 11, 36, 1, 1, 126, 32, 0, 173, 32, 1, 173, 66, 32, 134, 132, 32, 2, 173, 32, 3, 173, 66, 32, 134, 132, 126, 34, 4, 66, 32, 135, 167, 36, 0, 32, 4, 167, 11, 36, 1, 1, 126, 32, 0, 173, 32, 1, 173, 66, 32, 134, 132, 32, 2, 173, 32, 3, 173, 66, 32, 134, 132, 127, 34, 4, 66, 32, 135, 167, 36, 0, 32, 4, 167, 11, 36, 1, 1, 126, 32, 0, 173, 32, 1, 173, 66, 32, 134, 132, 32, 2, 173, 32, 3, 173, 66, 32, 134, 132, 128, 34, 4, 66, 32, 135, 167, 36, 0, 32, 4, 167, 11, 36, 1, 1, 126, 32, 0, 173, 32, 1, 173, 66, 32, 134, 132, 32, 2, 173, 32, 3, 173, 66, 32, 134, 132, 129, 34, 4, 66, 32, 135, 167, 36, 0, 32, 4, 167, 11, 36, 1, 1, 126, 32, 0, 173, 32, 1, 173, 66, 32, 134, 132, 32, 2, 173, 32, 3, 173, 66, 32, 134, 132, 130, 34, 4, 66, 32, 135, 167, 36, 0, 32, 4, 167, 11])
+    ),
+    {}
+  ).exports as unknown as LongWASMHelpers;
+} catch {
+  // no wasm support
+}
+
+const TWO_PWR_16_DBL = 1 << 16;
+const TWO_PWR_24_DBL = 1 << 24;
+const TWO_PWR_32_DBL = TWO_PWR_16_DBL * TWO_PWR_16_DBL;
+const TWO_PWR_64_DBL = TWO_PWR_32_DBL * TWO_PWR_32_DBL;
+const TWO_PWR_63_DBL = TWO_PWR_64_DBL / 2;
+
+/** A cache of the Long representations of small integer values. */
+const INT_CACHE: { [key: number]: Long } = {};
+
+/** A cache of the Long representations of small unsigned integer values. */
+const UINT_CACHE: { [key: number]: Long } = {};
+
+const MAX_INT64_STRING_LENGTH = 20;
+
+const DECIMAL_REG_EX = /^(\+?0|(\+|-)?[1-9][0-9]*)$/;
+
+/** @public */
+export interface LongExtended {
+  $numberLong: string;
+}
+
+/**
+ * A class representing a 64-bit integer
+ * @public
+ * @category BSONType
+ * @remarks
+ * The internal representation of a long is the two given signed, 32-bit values.
+ * We use 32-bit pieces because these are the size of integers on which
+ * Javascript performs bit-operations.  For operations like addition and
+ * multiplication, we split each number into 16 bit pieces, which can easily be
+ * multiplied within Javascript's floating-point representation without overflow
+ * or change in sign.
+ * In the algorithms below, we frequently reduce the negative case to the
+ * positive case by negating the input(s) and then post-processing the result.
+ * Note that we must ALWAYS check specially whether those values are MIN_VALUE
+ * (-2^63) because -MIN_VALUE == MIN_VALUE (since 2^63 cannot be represented as
+ * a positive number, it overflows back into a negative).  Not handling this
+ * case would often result in infinite recursion.
+ * Common constant values ZERO, ONE, NEG_ONE, etc. are found as static properties on this class.
+ */
+export class Long extends BSONValue {
+  get _bsontype(): 'Long' {
+    return 'Long';
+  }
+
+  /** An indicator used to reliably determine if an object is a Long or not. */
+  get __isLong__(): boolean {
+    return true;
+  }
+
+  /**
+   * The high 32 bits as a signed value.
+   */
+  high: number;
+
+  /**
+   * The low 32 bits as a signed value.
+   */
+  low: number;
+
+  /**
+   * Whether unsigned or not.
+   */
+  unsigned: boolean;
+
+  /**
+   * Constructs a 64 bit two's-complement integer, given its low and high 32 bit values as *signed* integers.
+   *
+   * @param low - The low (signed) 32 bits of the long
+   * @param high - The high (signed) 32 bits of the long
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   */
+  constructor(low: number, high?: number, unsigned?: boolean);
+  /**
+   * Constructs a 64 bit two's-complement integer, given a bigint representation.
+   *
+   * @param value - BigInt representation of the long value
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   */
+  constructor(value: bigint, unsigned?: boolean);
+  /**
+   * Constructs a 64 bit two's-complement integer, given a string representation.
+   *
+   * @param value - String representation of the long value
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   */
+  constructor(value: string, unsigned?: boolean);
+  constructor(
+    lowOrValue: number | bigint | string = 0,
+    highOrUnsigned?: number | boolean,
+    unsigned?: boolean
+  ) {
+    super();
+    const unsignedBool = typeof highOrUnsigned === 'boolean' ? highOrUnsigned : Boolean(unsigned);
+    const high = typeof highOrUnsigned === 'number' ? highOrUnsigned : 0;
+    const res =
+      typeof lowOrValue === 'string'
+        ? Long.fromString(lowOrValue, unsignedBool)
+        : typeof lowOrValue === 'bigint'
+          ? Long.fromBigInt(lowOrValue, unsignedBool)
+          : { low: lowOrValue | 0, high: high | 0, unsigned: unsignedBool };
+    this.low = res.low;
+    this.high = res.high;
+    this.unsigned = res.unsigned;
+  }
+
+  static TWO_PWR_24 = Long.fromInt(TWO_PWR_24_DBL);
+
+  /** Maximum unsigned value. */
+  static MAX_UNSIGNED_VALUE = Long.fromBits(0xffffffff | 0, 0xffffffff | 0, true);
+  /** Signed zero */
+  static ZERO = Long.fromInt(0);
+  /** Unsigned zero. */
+  static UZERO = Long.fromInt(0, true);
+  /** Signed one. */
+  static ONE = Long.fromInt(1);
+  /** Unsigned one. */
+  static UONE = Long.fromInt(1, true);
+  /** Signed negative one. */
+  static NEG_ONE = Long.fromInt(-1);
+  /** Maximum signed value. */
+  static MAX_VALUE = Long.fromBits(0xffffffff | 0, 0x7fffffff | 0, false);
+  /** Minimum signed value. */
+  static MIN_VALUE = Long.fromBits(0, 0x80000000 | 0, false);
+
+  /**
+   * Returns a Long representing the 64 bit integer that comes by concatenating the given low and high bits.
+   * Each is assumed to use 32 bits.
+   * @param lowBits - The low 32 bits
+   * @param highBits - The high 32 bits
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @returns The corresponding Long value
+   */
+  static fromBits(lowBits: number, highBits: number, unsigned?: boolean): Long {
+    return new Long(lowBits, highBits, unsigned);
+  }
+
+  /**
+   * Returns a Long representing the given 32 bit integer value.
+   * @param value - The 32 bit integer in question
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @returns The corresponding Long value
+   */
+  static fromInt(value: number, unsigned?: boolean): Long {
+    let obj, cachedObj, cache;
+    if (unsigned) {
+      value >>>= 0;
+      if ((cache = 0 <= value && value < 256)) {
+        cachedObj = UINT_CACHE[value];
+        if (cachedObj) return cachedObj;
+      }
+      obj = Long.fromBits(value, (value | 0) < 0 ? -1 : 0, true);
+      if (cache) UINT_CACHE[value] = obj;
+      return obj;
+    } else {
+      value |= 0;
+      if ((cache = -128 <= value && value < 128)) {
+        cachedObj = INT_CACHE[value];
+        if (cachedObj) return cachedObj;
+      }
+      obj = Long.fromBits(value, value < 0 ? -1 : 0, false);
+      if (cache) INT_CACHE[value] = obj;
+      return obj;
+    }
+  }
+
+  /**
+   * Returns a Long representing the given value, provided that it is a finite number. Otherwise, zero is returned.
+   * @param value - The number in question
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @returns The corresponding Long value
+   */
+  static fromNumber(value: number, unsigned?: boolean): Long {
+    if (isNaN(value)) return unsigned ? Long.UZERO : Long.ZERO;
+    if (unsigned) {
+      if (value < 0) return Long.UZERO;
+      if (value >= TWO_PWR_64_DBL) return Long.MAX_UNSIGNED_VALUE;
+    } else {
+      if (value <= -TWO_PWR_63_DBL) return Long.MIN_VALUE;
+      if (value + 1 >= TWO_PWR_63_DBL) return Long.MAX_VALUE;
+    }
+    if (value < 0) return Long.fromNumber(-value, unsigned).neg();
+    return Long.fromBits((value % TWO_PWR_32_DBL) | 0, (value / TWO_PWR_32_DBL) | 0, unsigned);
+  }
+
+  /**
+   * Returns a Long representing the given value, provided that it is a finite number. Otherwise, zero is returned.
+   * @param value - The number in question
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @returns The corresponding Long value
+   */
+  static fromBigInt(value: bigint, unsigned?: boolean): Long {
+    const FROM_BIGINT_BIT_MASK = 0xffffffffn;
+    const FROM_BIGINT_BIT_SHIFT = 32n;
+    return new Long(
+      Number(value & FROM_BIGINT_BIT_MASK),
+      Number((value >> FROM_BIGINT_BIT_SHIFT) & FROM_BIGINT_BIT_MASK),
+      unsigned
+    );
+  }
+
+  /**
+   * @internal
+   * Returns a Long representation of the given string, written using the specified radix.
+   * Throws an error if `throwsError` is set to true and any of the following conditions are true:
+   *  - the string contains invalid characters for the given radix
+   *  - the string contains whitespace
+   * @param str - The textual representation of the Long
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @param radix - The radix in which the text is written (2-36), defaults to 10
+   * @returns The corresponding Long value
+   */
+  private static _fromString(str: string, unsigned: boolean, radix: number): Long {
+    if (str.length === 0) throw new BSONError('empty string');
+    if (radix < 2 || 36 < radix) throw new BSONError('radix');
+
+    let p;
+    if ((p = str.indexOf('-')) > 0) throw new BSONError('interior hyphen');
+    else if (p === 0) {
+      return Long._fromString(str.substring(1), unsigned, radix).neg();
+    }
+
+    // Do several (8) digits each time through the loop, so as to
+    // minimize the calls to the very expensive emulated div.
+    const radixToPower = Long.fromNumber(Math.pow(radix, 8));
+
+    let result = Long.ZERO;
+    for (let i = 0; i < str.length; i += 8) {
+      const size = Math.min(8, str.length - i),
+        value = parseInt(str.substring(i, i + size), radix);
+      if (size < 8) {
+        const power = Long.fromNumber(Math.pow(radix, size));
+        result = result.mul(power).add(Long.fromNumber(value));
+      } else {
+        result = result.mul(radixToPower);
+        result = result.add(Long.fromNumber(value));
+      }
+    }
+    result.unsigned = unsigned;
+    return result;
+  }
+
+  /**
+   * Returns a signed Long representation of the given string, written using radix 10.
+   * Will throw an error if the given text is not exactly representable as a Long.
+   * Throws an error if any of the following conditions are true:
+   * - the string contains invalid characters for the radix 10
+   * - the string contains whitespace
+   * - the value the string represents is too large or too small to be a Long
+   * Unlike Long.fromString, this method does not coerce '+/-Infinity' and 'NaN' to Long.Zero
+   * @param str - The textual representation of the Long
+   * @returns The corresponding Long value
+   */
+  static fromStringStrict(str: string): Long;
+  /**
+   * Returns a Long representation of the given string, written using the radix 10.
+   * Will throw an error if the given parameters are not exactly representable as a Long.
+   * Throws an error if any of the following conditions are true:
+   * - the string contains invalid characters for the given radix
+   * - the string contains whitespace
+   * - the value the string represents is too large or too small to be a Long
+   * Unlike Long.fromString, this method does not coerce '+/-Infinity' and 'NaN' to Long.Zero
+   * @param str - The textual representation of the Long
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @returns The corresponding Long value
+   */
+  static fromStringStrict(str: string, unsigned?: boolean): Long;
+  /**
+   * Returns a signed Long representation of the given string, written using the specified radix.
+   * Will throw an error if the given parameters are not exactly representable as a Long.
+   * Throws an error if any of the following conditions are true:
+   * - the string contains invalid characters for the given radix
+   * - the string contains whitespace
+   * - the value the string represents is too large or too small to be a Long
+   * Unlike Long.fromString, this method does not coerce '+/-Infinity' and 'NaN' to Long.Zero
+   * @param str - The textual representation of the Long
+   * @param radix - The radix in which the text is written (2-36), defaults to 10
+   * @returns The corresponding Long value
+   */
+  static fromStringStrict(str: string, radix?: boolean): Long;
+  /**
+   * Returns a Long representation of the given string, written using the specified radix.
+   * Will throw an error if the given parameters are not exactly representable as a Long.
+   * Throws an error if any of the following conditions are true:
+   * - the string contains invalid characters for the given radix
+   * - the string contains whitespace
+   * - the value the string represents is too large or too small to be a Long
+   * Unlike Long.fromString, this method does not coerce '+/-Infinity' and 'NaN' to Long.Zero
+   * @param str - The textual representation of the Long
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @param radix - The radix in which the text is written (2-36), defaults to 10
+   * @returns The corresponding Long value
+   */
+  static fromStringStrict(str: string, unsigned?: boolean, radix?: number): Long;
+  static fromStringStrict(str: string, unsignedOrRadix?: boolean | number, radix?: number): Long {
+    let unsigned = false;
+    if (typeof unsignedOrRadix === 'number') {
+      // For goog.math.long compatibility
+      ((radix = unsignedOrRadix), (unsignedOrRadix = false));
+    } else {
+      unsigned = !!unsignedOrRadix;
+    }
+    radix ??= 10;
+
+    if (str.trim() !== str) {
+      throw new BSONError(`Input: '${str}' contains leading and/or trailing whitespace`);
+    }
+    if (!StringUtils.validateStringCharacters(str, radix)) {
+      throw new BSONError(`Input: '${str}' contains invalid characters for radix: ${radix}`);
+    }
+
+    // remove leading zeros (for later string comparison and to make math faster)
+    const cleanedStr = StringUtils.removeLeadingZerosAndExplicitPlus(str);
+
+    // check roundtrip result
+    const result = Long._fromString(cleanedStr, unsigned, radix);
+    if (result.toString(radix).toLowerCase() !== cleanedStr.toLowerCase()) {
+      throw new BSONError(
+        `Input: ${str} is not representable as ${result.unsigned ? 'an unsigned' : 'a signed'} 64-bit Long ${radix != null ? `with radix: ${radix}` : ''}`
+      );
+    }
+    return result;
+  }
+
+  /**
+   * Returns a signed Long representation of the given string, written using radix 10.
+   *
+   * If the input string is empty, this function will throw a BSONError.
+   *
+   * If input string does not have valid signed 64-bit Long representation, this method will return a coerced value:
+   * - inputs that overflow 64-bit signed long will be coerced to Long.MAX_VALUE and Long.MIN_VALUE respectively
+   * - 'NaN' or '+/-Infinity' are coerced to Long.ZERO
+   * - other invalid characters sequences have variable behavior
+   *
+   * @param str - The textual representation of the Long
+   * @returns The corresponding Long value
+   */
+  static fromString(str: string): Long;
+  /**
+   * Returns a signed Long representation of the given string, written using the provided radix.
+   *
+   * If the input string is empty or a provided radix is not within (2-36), this function will throw a BSONError.
+   *
+   * If input parameters do not have valid signed 64-bit Long representation, this method will return a coerced value:
+   * - inputs that overflow 64-bit signed long will be coerced to Long.MAX_VALUE and Long.MIN_VALUE respectively
+   * - if the radix is less than 24, 'NaN' is coerced to Long.ZERO
+   * - if the radix is less than 35, '+/-Infinity' inputs are coerced to Long.ZERO
+   * - other invalid characters sequences have variable behavior
+   * @param str - The textual representation of the Long
+   * @param radix - The radix in which the text is written (2-36), defaults to 10
+   * @returns The corresponding Long value
+   */
+  static fromString(str: string, radix?: number): Long;
+  /**
+   * Returns a Long representation of the given string, written using radix 10.
+   *
+   * If the input string is empty, this function will throw a BSONError.
+   *
+   * If input parameters do not have a valid 64-bit Long representation, this method will return a coerced value:
+   * - inputs that overflow 64-bit long will be coerced to max or min (if signed) values
+   * - if the radix is less than 24, 'NaN' is coerced to Long.ZERO
+   * - if the radix is less than 35, '+/-Infinity' inputs are coerced to Long.ZERO
+   * - other invalid characters sequences have variable behavior
+   * @param str - The textual representation of the Long
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @returns The corresponding Long value
+   */
+  static fromString(str: string, unsigned?: boolean): Long;
+  /**
+   * Returns a Long representation of the given string, written using the specified radix.
+   *
+   * If the input string is empty or a provided radix is not within (2-36), this function will throw a BSONError.
+   *
+   * If input parameters do not have a valid 64-bit Long representation, this method will return a coerced value:
+   * - inputs that overflow 64-bit long will be coerced to max or min (if signed) values
+   * - if the radix is less than 24, 'NaN' is coerced to Long.ZERO
+   * - if the radix is less than 35, '+/-Infinity' inputs are coerced to Long.ZERO
+   * - other invalid characters sequences have variable behavior
+   * @param str - The textual representation of the Long
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @param radix - The radix in which the text is written (2-36), defaults to 10
+   * @returns The corresponding Long value
+   */
+  static fromString(str: string, unsigned?: boolean, radix?: number): Long;
+  static fromString(str: string, unsignedOrRadix?: boolean | number, radix?: number): Long {
+    let unsigned = false;
+    if (typeof unsignedOrRadix === 'number') {
+      // For goog.math.long compatibility
+      ((radix = unsignedOrRadix), (unsignedOrRadix = false));
+    } else {
+      unsigned = !!unsignedOrRadix;
+    }
+    radix ??= 10;
+    if (str === 'NaN' && radix < 24) {
+      // radix does not support n, so coerce to zero
+      return Long.ZERO;
+    } else if ((str === 'Infinity' || str === '+Infinity' || str === '-Infinity') && radix < 35) {
+      // radix does not support y, so coerce to zero
+      return Long.ZERO;
+    }
+    return Long._fromString(str, unsigned, radix);
+  }
+
+  /**
+   * Creates a Long from its byte representation.
+   * @param bytes - Byte representation
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @param le - Whether little or big endian, defaults to big endian
+   * @returns The corresponding Long value
+   */
+  static fromBytes(bytes: number[], unsigned?: boolean, le?: boolean): Long {
+    return le ? Long.fromBytesLE(bytes, unsigned) : Long.fromBytesBE(bytes, unsigned);
+  }
+
+  /**
+   * Creates a Long from its little endian byte representation.
+   * @param bytes - Little endian byte representation
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @returns The corresponding Long value
+   */
+  static fromBytesLE(bytes: number[], unsigned?: boolean): Long {
+    return new Long(
+      bytes[0] | (bytes[1] << 8) | (bytes[2] << 16) | (bytes[3] << 24),
+      bytes[4] | (bytes[5] << 8) | (bytes[6] << 16) | (bytes[7] << 24),
+      unsigned
+    );
+  }
+
+  /**
+   * Creates a Long from its big endian byte representation.
+   * @param bytes - Big endian byte representation
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   * @returns The corresponding Long value
+   */
+  static fromBytesBE(bytes: number[], unsigned?: boolean): Long {
+    return new Long(
+      (bytes[4] << 24) | (bytes[5] << 16) | (bytes[6] << 8) | bytes[7],
+      (bytes[0] << 24) | (bytes[1] << 16) | (bytes[2] << 8) | bytes[3],
+      unsigned
+    );
+  }
+
+  /**
+   * Tests if the specified object is a Long.
+   */
+  static isLong(value: unknown): value is Long {
+    return (
+      value != null &&
+      typeof value === 'object' &&
+      '__isLong__' in value &&
+      value.__isLong__ === true
+    );
+  }
+
+  /**
+   * Converts the specified value to a Long.
+   * @param unsigned - Whether unsigned or not, defaults to signed
+   */
+  static fromValue(
+    val: number | string | { low: number; high: number; unsigned?: boolean },
+    unsigned?: boolean
+  ): Long {
+    if (typeof val === 'number') return Long.fromNumber(val, unsigned);
+    if (typeof val === 'string') return Long.fromString(val, unsigned);
+    // Throws for non-objects, converts non-instanceof Long:
+    return Long.fromBits(
+      val.low,
+      val.high,
+      typeof unsigned === 'boolean' ? unsigned : val.unsigned
+    );
+  }
+
+  /** Returns the sum of this and the specified Long. */
+  add(addend: string | number | Long | Timestamp): Long {
+    if (!Long.isLong(addend)) addend = Long.fromValue(addend);
+
+    // Divide each number into 4 chunks of 16 bits, and then sum the chunks.
+
+    const a48 = this.high >>> 16;
+    const a32 = this.high & 0xffff;
+    const a16 = this.low >>> 16;
+    const a00 = this.low & 0xffff;
+
+    const b48 = addend.high >>> 16;
+    const b32 = addend.high & 0xffff;
+    const b16 = addend.low >>> 16;
+    const b00 = addend.low & 0xffff;
+
+    let c48 = 0,
+      c32 = 0,
+      c16 = 0,
+      c00 = 0;
+    c00 += a00 + b00;
+    c16 += c00 >>> 16;
+    c00 &= 0xffff;
+    c16 += a16 + b16;
+    c32 += c16 >>> 16;
+    c16 &= 0xffff;
+    c32 += a32 + b32;
+    c48 += c32 >>> 16;
+    c32 &= 0xffff;
+    c48 += a48 + b48;
+    c48 &= 0xffff;
+    return Long.fromBits((c16 << 16) | c00, (c48 << 16) | c32, this.unsigned);
+  }
+
+  /**
+   * Returns the sum of this and the specified Long.
+   * @returns Sum
+   */
+  and(other: string | number | Long | Timestamp): Long {
+    if (!Long.isLong(other)) other = Long.fromValue(other);
+    return Long.fromBits(this.low & other.low, this.high & other.high, this.unsigned);
+  }
+
+  /**
+   * Compares this Long's value with the specified's.
+   * @returns 0 if they are the same, 1 if the this is greater and -1 if the given one is greater
+   */
+  compare(other: string | number | Long | Timestamp): 0 | 1 | -1 {
+    if (!Long.isLong(other)) other = Long.fromValue(other);
+    if (this.eq(other)) return 0;
+    const thisNeg = this.isNegative(),
+      otherNeg = other.isNegative();
+    if (thisNeg && !otherNeg) return -1;
+    if (!thisNeg && otherNeg) return 1;
+    // At this point the sign bits are the same
+    if (!this.unsigned) return this.sub(other).isNegative() ? -1 : 1;
+    // Both are positive if at least one is unsigned
+    return other.high >>> 0 > this.high >>> 0 ||
+      (other.high === this.high && other.low >>> 0 > this.low >>> 0)
+      ? -1
+      : 1;
+  }
+
+  /** This is an alias of {@link Long.compare} */
+  comp(other: string | number | Long | Timestamp): 0 | 1 | -1 {
+    return this.compare(other);
+  }
+
+  /**
+   * Returns this Long divided by the specified. The result is signed if this Long is signed or unsigned if this Long is unsigned.
+   * @returns Quotient
+   */
+  divide(divisor: string | number | Long | Timestamp): Long {
+    if (!Long.isLong(divisor)) divisor = Long.fromValue(divisor);
+    if (divisor.isZero()) throw new BSONError('division by zero');
+
+    // use wasm support if present
+    if (wasm) {
+      // guard against signed division overflow: the largest
+      // negative number / -1 would be 1 larger than the largest
+      // positive number, due to two's complement.
+      if (
+        !this.unsigned &&
+        this.high === -0x80000000 &&
+        divisor.low === -1 &&
+        divisor.high === -1
+      ) {
+        // be consistent with non-wasm code path
+        return this;
+      }
+      const low = (this.unsigned ? wasm.div_u : wasm.div_s)(
+        this.low,
+        this.high,
+        divisor.low,
+        divisor.high
+      );
+      return Long.fromBits(low, wasm.get_high(), this.unsigned);
+    }
+
+    if (this.isZero()) return this.unsigned ? Long.UZERO : Long.ZERO;
+    let approx, rem, res;
+    if (!this.unsigned) {
+      // This section is only relevant for signed longs and is derived from the
+      // closure library as a whole.
+      if (this.eq(Long.MIN_VALUE)) {
+        if (divisor.eq(Long.ONE) || divisor.eq(Long.NEG_ONE)) return Long.MIN_VALUE;
+        // recall that -MIN_VALUE == MIN_VALUE
+        else if (divisor.eq(Long.MIN_VALUE)) return Long.ONE;
+        else {
+          // At this point, we have |other| >= 2, so |this/other| < |MIN_VALUE|.
+          const halfThis = this.shr(1);
+          approx = halfThis.div(divisor).shl(1);
+          if (approx.eq(Long.ZERO)) {
+            return divisor.isNegative() ? Long.ONE : Long.NEG_ONE;
+          } else {
+            rem = this.sub(divisor.mul(approx));
+            res = approx.add(rem.div(divisor));
+            return res;
+          }
+        }
+      } else if (divisor.eq(Long.MIN_VALUE)) return this.unsigned ? Long.UZERO : Long.ZERO;
+      if (this.isNegative()) {
+        if (divisor.isNegative()) return this.neg().div(divisor.neg());
+        return this.neg().div(divisor).neg();
+      } else if (divisor.isNegative()) return this.div(divisor.neg()).neg();
+      res = Long.ZERO;
+    } else {
+      // The algorithm below has not been made for unsigned longs. It's therefore
+      // required to take special care of the MSB prior to running it.
+      if (!divisor.unsigned) divisor = divisor.toUnsigned();
+      if (divisor.gt(this)) return Long.UZERO;
+      if (divisor.gt(this.shru(1)))
+        // 15 >>> 1 = 7 ; with divisor = 8 ; true
+        return Long.UONE;
+      res = Long.UZERO;
+    }
+
+    // Repeat the following until the remainder is less than other:  find a
+    // floating-point that approximates remainder / other *from below*, add this
+    // into the result, and subtract it from the remainder.  It is critical that
+    // the approximate value is less than or equal to the real value so that the
+    // remainder never becomes negative.
+    // eslint-disable-next-line @typescript-eslint/no-this-alias
+    rem = this;
+    while (rem.gte(divisor)) {
+      // Approximate the result of division. This may be a little greater or
+      // smaller than the actual value.
+      approx = Math.max(1, Math.floor(rem.toNumber() / divisor.toNumber()));
+
+      // We will tweak the approximate result by changing it in the 48-th digit or
+      // the smallest non-fractional digit, whichever is larger.
+      const log2 = Math.ceil(Math.log(approx) / Math.LN2);
+      const delta = log2 <= 48 ? 1 : Math.pow(2, log2 - 48);
+      // Decrease the approximation until it is smaller than the remainder.  Note
+      // that if it is too large, the product overflows and is negative.
+      let approxRes = Long.fromNumber(approx);
+      let approxRem = approxRes.mul(divisor);
+      while (approxRem.isNegative() || approxRem.gt(rem)) {
+        approx -= delta;
+        approxRes = Long.fromNumber(approx, this.unsigned);
+        approxRem = approxRes.mul(divisor);
+      }
+
+      // We know the answer can't be zero... and actually, zero would cause
+      // infinite recursion since we would make no progress.
+      if (approxRes.isZero()) approxRes = Long.ONE;
+
+      res = res.add(approxRes);
+      rem = rem.sub(approxRem);
+    }
+    return res;
+  }
+
+  /**This is an alias of {@link Long.divide} */
+  div(divisor: string | number | Long | Timestamp): Long {
+    return this.divide(divisor);
+  }
+
+  /**
+   * Tests if this Long's value equals the specified's.
+   * @param other - Other value
+   */
+  equals(other: string | number | Long | Timestamp): boolean {
+    if (!Long.isLong(other)) other = Long.fromValue(other);
+    if (this.unsigned !== other.unsigned && this.high >>> 31 === 1 && other.high >>> 31 === 1)
+      return false;
+    return this.high === other.high && this.low === other.low;
+  }
+
+  /** This is an alias of {@link Long.equals} */
+  eq(other: string | number | Long | Timestamp): boolean {
+    return this.equals(other);
+  }
+
+  /** Gets the high 32 bits as a signed integer. */
+  getHighBits(): number {
+    return this.high;
+  }
+
+  /** Gets the high 32 bits as an unsigned integer. */
+  getHighBitsUnsigned(): number {
+    return this.high >>> 0;
+  }
+
+  /** Gets the low 32 bits as a signed integer. */
+  getLowBits(): number {
+    return this.low;
+  }
+
+  /** Gets the low 32 bits as an unsigned integer. */
+  getLowBitsUnsigned(): number {
+    return this.low >>> 0;
+  }
+
+  /** Gets the number of bits needed to represent the absolute value of this Long. */
+  getNumBitsAbs(): number {
+    if (this.isNegative()) {
+      // Unsigned Longs are never negative
+      return this.eq(Long.MIN_VALUE) ? 64 : this.neg().getNumBitsAbs();
+    }
+    const val = this.high !== 0 ? this.high : this.low;
+    let bit: number;
+    for (bit = 31; bit > 0; bit--) if ((val & (1 << bit)) !== 0) break;
+    return this.high !== 0 ? bit + 33 : bit + 1;
+  }
+
+  /** Tests if this Long's value is greater than the specified's. */
+  greaterThan(other: string | number | Long | Timestamp): boolean {
+    return this.comp(other) > 0;
+  }
+
+  /** This is an alias of {@link Long.greaterThan} */
+  gt(other: string | number | Long | Timestamp): boolean {
+    return this.greaterThan(other);
+  }
+
+  /** Tests if this Long's value is greater than or equal the specified's. */
+  greaterThanOrEqual(other: string | number | Long | Timestamp): boolean {
+    return this.comp(other) >= 0;
+  }
+
+  /** This is an alias of {@link Long.greaterThanOrEqual} */
+  gte(other: string | number | Long | Timestamp): boolean {
+    return this.greaterThanOrEqual(other);
+  }
+  /** This is an alias of {@link Long.greaterThanOrEqual} */
+  ge(other: string | number | Long | Timestamp): boolean {
+    return this.greaterThanOrEqual(other);
+  }
+
+  /** Tests if this Long's value is even. */
+  isEven(): boolean {
+    return (this.low & 1) === 0;
+  }
+
+  /** Tests if this Long's value is negative. */
+  isNegative(): boolean {
+    return !this.unsigned && this.high < 0;
+  }
+
+  /** Tests if this Long's value is odd. */
+  isOdd(): boolean {
+    return (this.low & 1) === 1;
+  }
+
+  /** Tests if this Long's value is positive. */
+  isPositive(): boolean {
+    return this.unsigned || this.high >= 0;
+  }
+
+  /** Tests if this Long's value equals zero. */
+  isZero(): boolean {
+    return this.high === 0 && this.low === 0;
+  }
+
+  /** Tests if this Long's value is less than the specified's. */
+  lessThan(other: string | number | Long | Timestamp): boolean {
+    return this.comp(other) < 0;
+  }
+
+  /** This is an alias of {@link Long#lessThan}. */
+  lt(other: string | number | Long | Timestamp): boolean {
+    return this.lessThan(other);
+  }
+
+  /** Tests if this Long's value is less than or equal the specified's. */
+  lessThanOrEqual(other: string | number | Long | Timestamp): boolean {
+    return this.comp(other) <= 0;
+  }
+
+  /** This is an alias of {@link Long.lessThanOrEqual} */
+  lte(other: string | number | Long | Timestamp): boolean {
+    return this.lessThanOrEqual(other);
+  }
+
+  /** Returns this Long modulo the specified. */
+  modulo(divisor: string | number | Long | Timestamp): Long {
+    if (!Long.isLong(divisor)) divisor = Long.fromValue(divisor);
+
+    // use wasm support if present
+    if (wasm) {
+      const low = (this.unsigned ? wasm.rem_u : wasm.rem_s)(
+        this.low,
+        this.high,
+        divisor.low,
+        divisor.high
+      );
+      return Long.fromBits(low, wasm.get_high(), this.unsigned);
+    }
+
+    return this.sub(this.div(divisor).mul(divisor));
+  }
+
+  /** This is an alias of {@link Long.modulo} */
+  mod(divisor: string | number | Long | Timestamp): Long {
+    return this.modulo(divisor);
+  }
+  /** This is an alias of {@link Long.modulo} */
+  rem(divisor: string | number | Long | Timestamp): Long {
+    return this.modulo(divisor);
+  }
+
+  /**
+   * Returns the product of this and the specified Long.
+   * @param multiplier - Multiplier
+   * @returns Product
+   */
+  multiply(multiplier: string | number | Long | Timestamp): Long {
+    if (this.isZero()) return Long.ZERO;
+    if (!Long.isLong(multiplier)) multiplier = Long.fromValue(multiplier);
+
+    // use wasm support if present
+    if (wasm) {
+      const low = wasm.mul(this.low, this.high, multiplier.low, multiplier.high);
+      return Long.fromBits(low, wasm.get_high(), this.unsigned);
+    }
+
+    if (multiplier.isZero()) return Long.ZERO;
+    if (this.eq(Long.MIN_VALUE)) return multiplier.isOdd() ? Long.MIN_VALUE : Long.ZERO;
+    if (multiplier.eq(Long.MIN_VALUE)) return this.isOdd() ? Long.MIN_VALUE : Long.ZERO;
+
+    if (this.isNegative()) {
+      if (multiplier.isNegative()) return this.neg().mul(multiplier.neg());
+      else return this.neg().mul(multiplier).neg();
+    } else if (multiplier.isNegative()) return this.mul(multiplier.neg()).neg();
+
+    // If both longs are small, use float multiplication
+    if (this.lt(Long.TWO_PWR_24) && multiplier.lt(Long.TWO_PWR_24))
+      return Long.fromNumber(this.toNumber() * multiplier.toNumber(), this.unsigned);
+
+    // Divide each long into 4 chunks of 16 bits, and then add up 4x4 products.
+    // We can skip products that would overflow.
+
+    const a48 = this.high >>> 16;
+    const a32 = this.high & 0xffff;
+    const a16 = this.low >>> 16;
+    const a00 = this.low & 0xffff;
+
+    const b48 = multiplier.high >>> 16;
+    const b32 = multiplier.high & 0xffff;
+    const b16 = multiplier.low >>> 16;
+    const b00 = multiplier.low & 0xffff;
+
+    let c48 = 0,
+      c32 = 0,
+      c16 = 0,
+      c00 = 0;
+    c00 += a00 * b00;
+    c16 += c00 >>> 16;
+    c00 &= 0xffff;
+    c16 += a16 * b00;
+    c32 += c16 >>> 16;
+    c16 &= 0xffff;
+    c16 += a00 * b16;
+    c32 += c16 >>> 16;
+    c16 &= 0xffff;
+    c32 += a32 * b00;
+    c48 += c32 >>> 16;
+    c32 &= 0xffff;
+    c32 += a16 * b16;
+    c48 += c32 >>> 16;
+    c32 &= 0xffff;
+    c32 += a00 * b32;
+    c48 += c32 >>> 16;
+    c32 &= 0xffff;
+    c48 += a48 * b00 + a32 * b16 + a16 * b32 + a00 * b48;
+    c48 &= 0xffff;
+    return Long.fromBits((c16 << 16) | c00, (c48 << 16) | c32, this.unsigned);
+  }
+
+  /** This is an alias of {@link Long.multiply} */
+  mul(multiplier: string | number | Long | Timestamp): Long {
+    return this.multiply(multiplier);
+  }
+
+  /** Returns the Negation of this Long's value. */
+  negate(): Long {
+    if (!this.unsigned && this.eq(Long.MIN_VALUE)) return Long.MIN_VALUE;
+    return this.not().add(Long.ONE);
+  }
+
+  /** This is an alias of {@link Long.negate} */
+  neg(): Long {
+    return this.negate();
+  }
+
+  /** Returns the bitwise NOT of this Long. */
+  not(): Long {
+    return Long.fromBits(~this.low, ~this.high, this.unsigned);
+  }
+
+  /** Tests if this Long's value differs from the specified's. */
+  notEquals(other: string | number | Long | Timestamp): boolean {
+    return !this.equals(other);
+  }
+
+  /** This is an alias of {@link Long.notEquals} */
+  neq(other: string | number | Long | Timestamp): boolean {
+    return this.notEquals(other);
+  }
+  /** This is an alias of {@link Long.notEquals} */
+  ne(other: string | number | Long | Timestamp): boolean {
+    return this.notEquals(other);
+  }
+
+  /**
+   * Returns the bitwise OR of this Long and the specified.
+   */
+  or(other: number | string | Long): Long {
+    if (!Long.isLong(other)) other = Long.fromValue(other);
+    return Long.fromBits(this.low | other.low, this.high | other.high, this.unsigned);
+  }
+
+  /**
+   * Returns this Long with bits shifted to the left by the given amount.
+   * @param numBits - Number of bits
+   * @returns Shifted Long
+   */
+  shiftLeft(numBits: number | Long): Long {
+    if (Long.isLong(numBits)) numBits = numBits.toInt();
+    if ((numBits &= 63) === 0) return this;
+    else if (numBits < 32)
+      return Long.fromBits(
+        this.low << numBits,
+        (this.high << numBits) | (this.low >>> (32 - numBits)),
+        this.unsigned
+      );
+    else return Long.fromBits(0, this.low << (numBits - 32), this.unsigned);
+  }
+
+  /** This is an alias of {@link Long.shiftLeft} */
+  shl(numBits: number | Long): Long {
+    return this.shiftLeft(numBits);
+  }
+
+  /**
+   * Returns this Long with bits arithmetically shifted to the right by the given amount.
+   * @param numBits - Number of bits
+   * @returns Shifted Long
+   */
+  shiftRight(numBits: number | Long): Long {
+    if (Long.isLong(numBits)) numBits = numBits.toInt();
+    if ((numBits &= 63) === 0) return this;
+    else if (numBits < 32)
+      return Long.fromBits(
+        (this.low >>> numBits) | (this.high << (32 - numBits)),
+        this.high >> numBits,
+        this.unsigned
+      );
+    else return Long.fromBits(this.high >> (numBits - 32), this.high >= 0 ? 0 : -1, this.unsigned);
+  }
+
+  /** This is an alias of {@link Long.shiftRight} */
+  shr(numBits: number | Long): Long {
+    return this.shiftRight(numBits);
+  }
+
+  /**
+   * Returns this Long with bits logically shifted to the right by the given amount.
+   * @param numBits - Number of bits
+   * @returns Shifted Long
+   */
+  shiftRightUnsigned(numBits: Long | number): Long {
+    if (Long.isLong(numBits)) numBits = numBits.toInt();
+    numBits &= 63;
+    if (numBits === 0) return this;
+    else {
+      const high = this.high;
+      if (numBits < 32) {
+        const low = this.low;
+        return Long.fromBits(
+          (low >>> numBits) | (high << (32 - numBits)),
+          high >>> numBits,
+          this.unsigned
+        );
+      } else if (numBits === 32) return Long.fromBits(high, 0, this.unsigned);
+      else return Long.fromBits(high >>> (numBits - 32), 0, this.unsigned);
+    }
+  }
+
+  /** This is an alias of {@link Long.shiftRightUnsigned} */
+  shr_u(numBits: number | Long): Long {
+    return this.shiftRightUnsigned(numBits);
+  }
+  /** This is an alias of {@link Long.shiftRightUnsigned} */
+  shru(numBits: number | Long): Long {
+    return this.shiftRightUnsigned(numBits);
+  }
+
+  /**
+   * Returns the difference of this and the specified Long.
+   * @param subtrahend - Subtrahend
+   * @returns Difference
+   */
+  subtract(subtrahend: string | number | Long | Timestamp): Long {
+    if (!Long.isLong(subtrahend)) subtrahend = Long.fromValue(subtrahend);
+    return this.add(subtrahend.neg());
+  }
+
+  /** This is an alias of {@link Long.subtract} */
+  sub(subtrahend: string | number | Long | Timestamp): Long {
+    return this.subtract(subtrahend);
+  }
+
+  /** Converts the Long to a 32 bit integer, assuming it is a 32 bit integer. */
+  toInt(): number {
+    return this.unsigned ? this.low >>> 0 : this.low;
+  }
+
+  /** Converts the Long to a the nearest floating-point representation of this value (double, 53 bit mantissa). */
+  toNumber(): number {
+    if (this.unsigned) return (this.high >>> 0) * TWO_PWR_32_DBL + (this.low >>> 0);
+    return this.high * TWO_PWR_32_DBL + (this.low >>> 0);
+  }
+
+  /** Converts the Long to a BigInt (arbitrary precision). */
+  toBigInt(): bigint {
+    return BigInt(this.toString());
+  }
+
+  /**
+   * Converts this Long to its byte representation.
+   * @param le - Whether little or big endian, defaults to big endian
+   * @returns Byte representation
+   */
+  toBytes(le?: boolean): number[] {
+    return le ? this.toBytesLE() : this.toBytesBE();
+  }
+
+  /**
+   * Converts this Long to its little endian byte representation.
+   * @returns Little endian byte representation
+   */
+  toBytesLE(): number[] {
+    const hi = this.high,
+      lo = this.low;
+    return [
+      lo & 0xff,
+      (lo >>> 8) & 0xff,
+      (lo >>> 16) & 0xff,
+      lo >>> 24,
+      hi & 0xff,
+      (hi >>> 8) & 0xff,
+      (hi >>> 16) & 0xff,
+      hi >>> 24
+    ];
+  }
+
+  /**
+   * Converts this Long to its big endian byte representation.
+   * @returns Big endian byte representation
+   */
+  toBytesBE(): number[] {
+    const hi = this.high,
+      lo = this.low;
+    return [
+      hi >>> 24,
+      (hi >>> 16) & 0xff,
+      (hi >>> 8) & 0xff,
+      hi & 0xff,
+      lo >>> 24,
+      (lo >>> 16) & 0xff,
+      (lo >>> 8) & 0xff,
+      lo & 0xff
+    ];
+  }
+
+  /**
+   * Converts this Long to signed.
+   */
+  toSigned(): Long {
+    if (!this.unsigned) return this;
+    return Long.fromBits(this.low, this.high, false);
+  }
+
+  /**
+   * Converts the Long to a string written in the specified radix.
+   * @param radix - Radix (2-36), defaults to 10
+   * @throws RangeError If `radix` is out of range
+   */
+  toString(radix?: number): string {
+    radix = radix || 10;
+    if (radix < 2 || 36 < radix) throw new BSONError('radix');
+    if (this.isZero()) return '0';
+    if (this.isNegative()) {
+      // Unsigned Longs are never negative
+      if (this.eq(Long.MIN_VALUE)) {
+        // We need to change the Long value before it can be negated, so we remove
+        // the bottom-most digit in this base and then recurse to do the rest.
+        const radixLong = Long.fromNumber(radix),
+          div = this.div(radixLong),
+          rem1 = div.mul(radixLong).sub(this);
+        return div.toString(radix) + rem1.toInt().toString(radix);
+      } else return '-' + this.neg().toString(radix);
+    }
+
+    // Do several (6) digits each time through the loop, so as to
+    // minimize the calls to the very expensive emulated div.
+    const radixToPower = Long.fromNumber(Math.pow(radix, 6), this.unsigned);
+    // eslint-disable-next-line @typescript-eslint/no-this-alias
+    let rem: Long = this;
+    let result = '';
+    while (true) {
+      const remDiv = rem.div(radixToPower);
+      const intval = rem.sub(remDiv.mul(radixToPower)).toInt() >>> 0;
+      let digits = intval.toString(radix);
+      rem = remDiv;
+      if (rem.isZero()) {
+        return digits + result;
+      } else {
+        while (digits.length < 6) digits = '0' + digits;
+        result = '' + digits + result;
+      }
+    }
+  }
+
+  /** Converts this Long to unsigned. */
+  toUnsigned(): Long {
+    if (this.unsigned) return this;
+    return Long.fromBits(this.low, this.high, true);
+  }
+
+  /** Returns the bitwise XOR of this Long and the given one. */
+  xor(other: Long | number | string): Long {
+    if (!Long.isLong(other)) other = Long.fromValue(other);
+    return Long.fromBits(this.low ^ other.low, this.high ^ other.high, this.unsigned);
+  }
+
+  /** This is an alias of {@link Long.isZero} */
+  eqz(): boolean {
+    return this.isZero();
+  }
+
+  /** This is an alias of {@link Long.lessThanOrEqual} */
+  le(other: string | number | Long | Timestamp): boolean {
+    return this.lessThanOrEqual(other);
+  }
+
+  /*
+   ****************************************************************
+   *                  BSON SPECIFIC ADDITIONS                     *
+   ****************************************************************
+   */
+  toExtendedJSON(options?: EJSONOptions): number | LongExtended {
+    if (options && options.relaxed) return this.toNumber();
+    return { $numberLong: this.toString() };
+  }
+  static fromExtendedJSON(
+    doc: { $numberLong: string },
+    options?: EJSONOptions
+  ): number | Long | bigint {
+    const { useBigInt64 = false, relaxed = true } = { ...options };
+
+    if (doc.$numberLong.length > MAX_INT64_STRING_LENGTH) {
+      throw new BSONError('$numberLong string is too long');
+    }
+
+    if (!DECIMAL_REG_EX.test(doc.$numberLong)) {
+      throw new BSONError(`$numberLong string "${doc.$numberLong}" is in an invalid format`);
+    }
+
+    if (useBigInt64) {
+      const bigIntResult = BigInt(doc.$numberLong);
+      return BigInt.asIntN(64, bigIntResult);
+    }
+
+    const longResult = Long.fromString(doc.$numberLong);
+    if (relaxed) {
+      return longResult.toNumber();
+    }
+    return longResult;
+  }
+
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+    const longVal = inspect(this.toString(), options);
+    const unsignedVal = this.unsigned ? `, ${inspect(this.unsigned, options)}` : '';
+    return `new Long(${longVal}${unsignedVal})`;
+  }
+}

gateway/node_modules/bson/src/max_key.ts

@@ -0,0 +1,31 @@
+import { BSONValue } from './bson_value';
+
+/** @public */
+export interface MaxKeyExtended {
+  $maxKey: 1;
+}
+
+/**
+ * A class representation of the BSON MaxKey type.
+ * @public
+ * @category BSONType
+ */
+export class MaxKey extends BSONValue {
+  get _bsontype(): 'MaxKey' {
+    return 'MaxKey';
+  }
+
+  /** @internal */
+  toExtendedJSON(): MaxKeyExtended {
+    return { $maxKey: 1 };
+  }
+
+  /** @internal */
+  static fromExtendedJSON(): MaxKey {
+    return new MaxKey();
+  }
+
+  inspect(): string {
+    return 'new MaxKey()';
+  }
+}

gateway/node_modules/bson/src/min_key.ts

@@ -0,0 +1,31 @@
+import { BSONValue } from './bson_value';
+
+/** @public */
+export interface MinKeyExtended {
+  $minKey: 1;
+}
+
+/**
+ * A class representation of the BSON MinKey type.
+ * @public
+ * @category BSONType
+ */
+export class MinKey extends BSONValue {
+  get _bsontype(): 'MinKey' {
+    return 'MinKey';
+  }
+
+  /** @internal */
+  toExtendedJSON(): MinKeyExtended {
+    return { $minKey: 1 };
+  }
+
+  /** @internal */
+  static fromExtendedJSON(): MinKey {
+    return new MinKey();
+  }
+
+  inspect(): string {
+    return 'new MinKey()';
+  }
+}

gateway/node_modules/bson/src/objectid.ts

@@ -0,0 +1,546 @@
+import { BSONValue } from './bson_value';
+import { BSONError } from './error';
+import { type InspectFn, defaultInspect } from './parser/utils';
+import { ByteUtils } from './utils/byte_utils';
+import { NumberUtils } from './utils/number_utils';
+
+/** ObjectId hexString cache @internal */
+const __idCache = new WeakMap(); // TODO(NODE-6549): convert this to #__id private field when target updated to ES2022
+
+/** byte (0-255): its 2-character lowercase hex pair @internal */
+const byteToHex: string[] = [];
+for (let n = 0; n < 256; n++) byteToHex.push(n.toString(16).padStart(2, '0'));
+
+/** hex char code: nibble (0-15); indices are the codes of 0-9, a-f, A-F @internal */
+const hexCharCodeToNibble = new Int8Array(103);
+for (let c = 48; c <= 57; c++) hexCharCodeToNibble[c] = c - 48; // '0'-'9'
+for (let c = 65; c <= 70; c++) hexCharCodeToNibble[c] = c - 55; // 'A'-'F'
+for (let c = 97; c <= 102; c++) hexCharCodeToNibble[c] = c - 87; // 'a'-'f'
+
+/** @public */
+export interface ObjectIdLike {
+  id: string | Uint8Array;
+  __id?: string;
+  toHexString(): string;
+}
+
+/** @public */
+export interface ObjectIdExtended {
+  $oid: string;
+}
+
+/**
+ * A class representation of the BSON ObjectId type.
+ * @public
+ * @category BSONType
+ */
+export class ObjectId extends BSONValue {
+  get _bsontype(): 'ObjectId' {
+    return 'ObjectId';
+  }
+
+  /** @internal */
+  private static index = 0;
+
+  /** Unique sequence for the current process (initialized on first use)
+   * @internal
+   */
+  private static PROCESS_UNIQUE: Uint8Array | null = null;
+
+  /** @internal */
+  private static resetState = (): void => {
+    this.index = Math.floor(Math.random() * 0x1000000);
+    // PROCESS_UNIQUE is (re)generated lazily on first use rather than here, so that merely loading
+    // BSON never calls secure random at module-evaluation time. Runtimes such as Cloudflare Workers
+    // forbid generating random values in the global scope.
+    this.PROCESS_UNIQUE = null;
+  };
+
+  static {
+    this.resetState();
+    // https://nodejs.org/api/v8.html#startup-snapshot-api
+    // @ts-expect-error Node.js types not present since this is an optional API
+    const { startupSnapshot } = globalThis?.process?.getBuiltinModule?.('v8') ?? {};
+    if (startupSnapshot?.isBuildingSnapshot?.()) {
+      startupSnapshot?.addDeserializeCallback?.(this.resetState);
+    }
+  }
+
+  static cacheHexString: boolean;
+
+  /**
+   * The 12 ObjectId bytes packed as four 24-bit integers (bytes 0-2, 3-5, 6-8, 9-11).
+   * The 24-bit width keeps each value inside V8's small-integer (Smi) range so it stays stored
+   * inline, which keeps the object small. The fields are enumerable own properties, so two
+   * ObjectIds with the same bytes stay equal under structural comparison such as deepStrictEqual.
+   * @internal
+   */
+  private i0!: number;
+  /** @internal */
+  private i1!: number;
+  /** @internal */
+  private i2!: number;
+  /** @internal */
+  private i3!: number;
+
+  /** Pack 12 bytes into the four integer fields. @internal */
+  private setFromBytes(b: Uint8Array, offset = 0): void {
+    this.i0 = (b[offset] << 16) | (b[offset + 1] << 8) | b[offset + 2];
+    this.i1 = (b[offset + 3] << 16) | (b[offset + 4] << 8) | b[offset + 5];
+    this.i2 = (b[offset + 6] << 16) | (b[offset + 7] << 8) | b[offset + 8];
+    this.i3 = (b[offset + 9] << 16) | (b[offset + 10] << 8) | b[offset + 11];
+  }
+
+  /**
+   * Pack a validated 24-character hex string into the four integer fields. The caller must have
+   * already validated the string; every character is assumed to be a hex digit.
+   * @internal
+   */
+  private setFromHex(s: string): void {
+    const t = hexCharCodeToNibble;
+    this.i0 =
+      (t[s.charCodeAt(0)] << 20) |
+      (t[s.charCodeAt(1)] << 16) |
+      (t[s.charCodeAt(2)] << 12) |
+      (t[s.charCodeAt(3)] << 8) |
+      (t[s.charCodeAt(4)] << 4) |
+      t[s.charCodeAt(5)];
+    this.i1 =
+      (t[s.charCodeAt(6)] << 20) |
+      (t[s.charCodeAt(7)] << 16) |
+      (t[s.charCodeAt(8)] << 12) |
+      (t[s.charCodeAt(9)] << 8) |
+      (t[s.charCodeAt(10)] << 4) |
+      t[s.charCodeAt(11)];
+    this.i2 =
+      (t[s.charCodeAt(12)] << 20) |
+      (t[s.charCodeAt(13)] << 16) |
+      (t[s.charCodeAt(14)] << 12) |
+      (t[s.charCodeAt(15)] << 8) |
+      (t[s.charCodeAt(16)] << 4) |
+      t[s.charCodeAt(17)];
+    this.i3 =
+      (t[s.charCodeAt(18)] << 20) |
+      (t[s.charCodeAt(19)] << 16) |
+      (t[s.charCodeAt(20)] << 12) |
+      (t[s.charCodeAt(21)] << 8) |
+      (t[s.charCodeAt(22)] << 4) |
+      t[s.charCodeAt(23)];
+  }
+
+  /** To generate a new ObjectId, use ObjectId() with no argument. */
+  constructor();
+  /**
+   * Create ObjectId from a 24 character hex string.
+   *
+   * @param inputId - A 24 character hex string.
+   */
+  constructor(inputId: string);
+  /**
+   * Create ObjectId from the BSON ObjectId type.
+   *
+   * @param inputId - The BSON ObjectId type.
+   */
+  constructor(inputId: ObjectId);
+  /**
+   * Create ObjectId from the object type that has the toHexString method.
+   *
+   * @param inputId - The ObjectIdLike type.
+   */
+  constructor(inputId: ObjectIdLike);
+  /**
+   * Create ObjectId from a 12 byte binary Buffer.
+   *
+   * @param inputId - A 12 byte binary Buffer.
+   */
+  constructor(inputId: Uint8Array);
+  /**
+   * Implementation overload.
+   *
+   * @param inputId - All input types that are used in the constructor implementation.
+   */
+  constructor(inputId?: string | ObjectId | ObjectIdLike | Uint8Array);
+  /**
+   * Read 12 bytes from `source` starting at `offset` directly into the packed fields.
+   * Used by the deserializer on a hot path.
+   * @internal
+   */
+  constructor(source: Uint8Array, offset: number);
+  /**
+   * Create a new ObjectId.
+   *
+   * @param inputId - An input value to create a new ObjectId from.
+   */
+  constructor(inputId?: string | ObjectId | ObjectIdLike | Uint8Array, offset?: number) {
+    super();
+    if (typeof offset === 'number') {
+      // Fast path used by the deserializer: read the 12 bytes directly from source at offset.
+      this.setFromBytes(inputId as Uint8Array, offset);
+      return;
+    }
+    // workingId is set based on type of input and whether valid id exists for the input
+    let workingId;
+    if (typeof inputId === 'object' && inputId && 'id' in inputId) {
+      if (
+        ObjectId.is(inputId) &&
+        typeof inputId.i0 === 'number' &&
+        typeof inputId.i1 === 'number' &&
+        typeof inputId.i2 === 'number' &&
+        typeof inputId.i3 === 'number'
+      ) {
+        // Same-build ObjectId: copy the packed fields directly. The general path below would
+        // hit the id getter (which allocates) and then re-decode a hex round trip.
+        this.i0 = inputId.i0;
+        this.i1 = inputId.i1;
+        this.i2 = inputId.i2;
+        this.i3 = inputId.i3;
+        return;
+      }
+      if (typeof inputId.id !== 'string' && !ArrayBuffer.isView(inputId.id)) {
+        throw new BSONError('Argument passed in must have an id that is of type string or Buffer');
+      }
+      if ('toHexString' in inputId && typeof inputId.toHexString === 'function') {
+        workingId = ByteUtils.fromHex(inputId.toHexString());
+      } else {
+        workingId = inputId.id;
+      }
+    } else {
+      workingId = inputId;
+    }
+
+    // The following cases use workingId to construct an ObjectId
+    if (workingId == null) {
+      // The most common use case (blank id, new objectId instance):
+      // generate a new id directly into the packed fields.
+      const time = Math.floor(Date.now() / 1000);
+      const inc = ObjectId.getInc();
+      const pu = (ObjectId.PROCESS_UNIQUE ??= ByteUtils.randomBytes(5));
+      this.i0 = (time >>> 8) & 0xffffff;
+      this.i1 = ((time & 0xff) << 16) | (pu[0] << 8) | pu[1];
+      this.i2 = (pu[2] << 16) | (pu[3] << 8) | pu[4];
+      this.i3 = inc & 0xffffff;
+    } else if (ArrayBuffer.isView(workingId) && workingId.byteLength === 12) {
+      // Normalize a non-Uint8Array view (DataView, Int8Array, ...) to a byte buffer so its
+      // bytes are read correctly.
+      this.setFromBytes(
+        workingId instanceof Uint8Array ? workingId : ByteUtils.toLocalBufferType(workingId)
+      );
+    } else if (typeof workingId === 'string') {
+      if (ObjectId.validateHexString(workingId)) {
+        this.setFromHex(workingId);
+        // If we are caching the hex string
+        if (ObjectId.cacheHexString) {
+          __idCache.set(this, workingId);
+        }
+      } else {
+        throw new BSONError(
+          'input must be a 24 character hex string, 12 byte Uint8Array, or an integer'
+        );
+      }
+    } else {
+      throw new BSONError('Argument passed in does not match the accepted types');
+    }
+  }
+
+  /**
+   * The ObjectId bytes, rebuilt from the packed integer fields on each access. Every read
+   * returns a freshly allocated 12-byte buffer.
+   * @readonly
+   */
+  get id(): Uint8Array {
+    const b = ByteUtils.allocateUnsafe(12);
+    b[0] = (this.i0 >>> 16) & 0xff;
+    b[1] = (this.i0 >>> 8) & 0xff;
+    b[2] = this.i0 & 0xff;
+    b[3] = (this.i1 >>> 16) & 0xff;
+    b[4] = (this.i1 >>> 8) & 0xff;
+    b[5] = this.i1 & 0xff;
+    b[6] = (this.i2 >>> 16) & 0xff;
+    b[7] = (this.i2 >>> 8) & 0xff;
+    b[8] = this.i2 & 0xff;
+    b[9] = (this.i3 >>> 16) & 0xff;
+    b[10] = (this.i3 >>> 8) & 0xff;
+    b[11] = this.i3 & 0xff;
+    return b;
+  }
+
+  set id(value: Uint8Array) {
+    const bytes = value instanceof Uint8Array ? value : ByteUtils.toLocalBufferType(value);
+    this.setFromBytes(bytes);
+    if (ObjectId.cacheHexString) {
+      __idCache.set(this, ByteUtils.toHex(bytes));
+    }
+  }
+
+  /**
+   * @internal
+   * Validates the input string is a valid hex representation of an ObjectId.
+   */
+  private static validateHexString(string: string): boolean {
+    if (string?.length !== 24) return false;
+    for (let i = 0; i < 24; i++) {
+      const char = string.charCodeAt(i);
+      if (
+        // Check for ASCII 0-9
+        (char >= 48 && char <= 57) ||
+        // Check for ASCII a-f
+        (char >= 97 && char <= 102) ||
+        // Check for ASCII A-F
+        (char >= 65 && char <= 70)
+      ) {
+        continue;
+      }
+      return false;
+    }
+    return true;
+  }
+
+  /** Returns the ObjectId id as a 24 lowercase character hex string representation */
+  toHexString(): string {
+    if (ObjectId.cacheHexString) {
+      const __id = __idCache.get(this);
+      if (__id) return __id;
+    }
+
+    // Encode the four packed integers to hex via a byte->pair lookup table.
+    const i0 = this.i0;
+    const i1 = this.i1;
+    const i2 = this.i2;
+    const i3 = this.i3;
+    const hexString =
+      byteToHex[(i0 >>> 16) & 0xff] +
+      byteToHex[(i0 >>> 8) & 0xff] +
+      byteToHex[i0 & 0xff] +
+      byteToHex[(i1 >>> 16) & 0xff] +
+      byteToHex[(i1 >>> 8) & 0xff] +
+      byteToHex[i1 & 0xff] +
+      byteToHex[(i2 >>> 16) & 0xff] +
+      byteToHex[(i2 >>> 8) & 0xff] +
+      byteToHex[i2 & 0xff] +
+      byteToHex[(i3 >>> 16) & 0xff] +
+      byteToHex[(i3 >>> 8) & 0xff] +
+      byteToHex[i3 & 0xff];
+
+    if (ObjectId.cacheHexString) {
+      __idCache.set(this, hexString);
+    }
+
+    return hexString;
+  }
+
+  /**
+   * Update the ObjectId index
+   * @internal
+   */
+  private static getInc(): number {
+    return (ObjectId.index = (ObjectId.index + 1) % 0x1000000);
+  }
+
+  /**
+   * Generate a 12 byte id buffer used in ObjectId's
+   *
+   * @param time - pass in a second based timestamp.
+   */
+  static generate(time?: number): Uint8Array {
+    if ('number' !== typeof time) {
+      time = Math.floor(Date.now() / 1000);
+    }
+
+    const inc = ObjectId.getInc();
+    const buffer = ByteUtils.allocateUnsafe(12);
+
+    // 4-byte timestamp
+    NumberUtils.setInt32BE(buffer, 0, time);
+
+    // 5-byte process unique (generated lazily on first use, see NODE-7667)
+    const PROCESS_UNIQUE = (this.PROCESS_UNIQUE ??= ByteUtils.randomBytes(5));
+    buffer[4] = PROCESS_UNIQUE[0];
+    buffer[5] = PROCESS_UNIQUE[1];
+    buffer[6] = PROCESS_UNIQUE[2];
+    buffer[7] = PROCESS_UNIQUE[3];
+    buffer[8] = PROCESS_UNIQUE[4];
+
+    // 3-byte counter
+    buffer[11] = inc & 0xff;
+    buffer[10] = (inc >>> 8) & 0xff;
+    buffer[9] = (inc >>> 16) & 0xff;
+
+    return buffer;
+  }
+
+  /**
+   * Converts the id into a 24 character hex string for printing, unless encoding is provided.
+   * @param encoding - hex or base64
+   */
+  toString(encoding?: 'hex' | 'base64'): string {
+    if (encoding === 'base64') return ByteUtils.toBase64(this.id);
+    if (encoding === 'hex') return this.toHexString();
+    return this.toHexString();
+  }
+
+  /** Converts to its JSON the 24 character hex string representation. */
+  toJSON(): string {
+    return this.toHexString();
+  }
+
+  /** @internal */
+  private static is(variable: unknown): variable is ObjectId {
+    return (
+      variable != null &&
+      typeof variable === 'object' &&
+      '_bsontype' in variable &&
+      variable._bsontype === 'ObjectId'
+    );
+  }
+
+  /**
+   * Compares the equality of this ObjectId with `otherID`.
+   *
+   * @param otherId - ObjectId instance to compare against.
+   */
+  equals(otherId: string | ObjectId | ObjectIdLike | undefined | null): boolean {
+    if (otherId === undefined || otherId === null) {
+      return false;
+    }
+
+    if (
+      ObjectId.is(otherId) &&
+      typeof otherId.i0 === 'number' &&
+      typeof otherId.i1 === 'number' &&
+      typeof otherId.i2 === 'number' &&
+      typeof otherId.i3 === 'number'
+    ) {
+      // Same-build ObjectId (all four packed fields present): compare them directly. i3 (the
+      // counter / low bytes) differs most often between two ids, so checking it first fails fast.
+      return (
+        this.i3 === otherId.i3 &&
+        this.i0 === otherId.i0 &&
+        this.i1 === otherId.i1 &&
+        this.i2 === otherId.i2
+      );
+    }
+
+    if (typeof otherId === 'string') {
+      return otherId.toLowerCase() === this.toHexString();
+    }
+
+    if (typeof otherId === 'object' && typeof otherId.toHexString === 'function') {
+      // ObjectId-like values, and ObjectIds from a different bson build, compare by their
+      // public hex representation.
+      const otherIdString = otherId.toHexString();
+      const thisIdString = this.toHexString();
+      return typeof otherIdString === 'string' && otherIdString.toLowerCase() === thisIdString;
+    }
+
+    return false;
+  }
+
+  /** Returns the generation date (accurate up to the second) that this ID was generated. */
+  getTimestamp(): Date {
+    const timestamp = new Date();
+    // Bytes 0-3 (the big-endian timestamp) are i0's three bytes followed by i1's top byte.
+    const time = this.i0 * 0x100 + (this.i1 >>> 16);
+    timestamp.setTime(time * 1000);
+    return timestamp;
+  }
+
+  /** @internal */
+  static createPk(): ObjectId {
+    return new ObjectId();
+  }
+
+  /** @internal */
+  serializeInto(uint8array: Uint8Array, index: number): 12 {
+    uint8array[index] = (this.i0 >>> 16) & 0xff;
+    uint8array[index + 1] = (this.i0 >>> 8) & 0xff;
+    uint8array[index + 2] = this.i0 & 0xff;
+    uint8array[index + 3] = (this.i1 >>> 16) & 0xff;
+    uint8array[index + 4] = (this.i1 >>> 8) & 0xff;
+    uint8array[index + 5] = this.i1 & 0xff;
+    uint8array[index + 6] = (this.i2 >>> 16) & 0xff;
+    uint8array[index + 7] = (this.i2 >>> 8) & 0xff;
+    uint8array[index + 8] = this.i2 & 0xff;
+    uint8array[index + 9] = (this.i3 >>> 16) & 0xff;
+    uint8array[index + 10] = (this.i3 >>> 8) & 0xff;
+    uint8array[index + 11] = this.i3 & 0xff;
+    return 12;
+  }
+
+  /**
+   * Creates an ObjectId from a second based number, with the rest of the ObjectId zeroed out. Used for comparisons or sorting the ObjectId.
+   *
+   * @param time - an integer number representing a number of seconds.
+   */
+  static createFromTime(time: number): ObjectId {
+    const buffer = ByteUtils.allocate(12);
+    for (let i = 11; i >= 4; i--) buffer[i] = 0;
+    // Encode time into first 4 bytes
+    NumberUtils.setInt32BE(buffer, 0, time);
+    // Return the new objectId
+    return new ObjectId(buffer);
+  }
+
+  /**
+   * Creates an ObjectId from a hex string representation of an ObjectId.
+   *
+   * @param hexString - create a ObjectId from a passed in 24 character hexstring.
+   */
+  static createFromHexString(hexString: string): ObjectId {
+    if (hexString?.length !== 24) {
+      throw new BSONError('hex string must be 24 characters');
+    }
+
+    return new ObjectId(ByteUtils.fromHex(hexString));
+  }
+
+  /** Creates an ObjectId instance from a base64 string */
+  static createFromBase64(base64: string): ObjectId {
+    if (base64?.length !== 16) {
+      throw new BSONError('base64 string must be 16 characters');
+    }
+
+    return new ObjectId(ByteUtils.fromBase64(base64));
+  }
+
+  /**
+   * Checks if a value can be used to create a valid bson ObjectId
+   * @param id - any JS value
+   */
+  static isValid(id: string | ObjectId | ObjectIdLike | Uint8Array): boolean {
+    if (id == null) return false;
+    if (typeof id === 'string') return ObjectId.validateHexString(id);
+
+    try {
+      new ObjectId(id);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /** @internal */
+  toExtendedJSON(): ObjectIdExtended {
+    if (this.toHexString) return { $oid: this.toHexString() };
+    return { $oid: this.toString('hex') };
+  }
+
+  /** @internal */
+  static fromExtendedJSON(doc: ObjectIdExtended): ObjectId {
+    return new ObjectId(doc.$oid);
+  }
+
+  /** @internal */
+  private isCached(): boolean {
+    return ObjectId.cacheHexString && __idCache.has(this);
+  }
+
+  /**
+   * Converts to a string representation of this Id.
+   *
+   * @returns return the 24 character hex string representation.
+   */
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    inspect ??= defaultInspect;
+    return `new ObjectId(${inspect(this.toHexString(), options)})`;
+  }
+}

gateway/node_modules/bson/src/parse_utf8.ts

@@ -0,0 +1,35 @@
+import { BSONError } from './error';
+
+type TextDecoder = {
+  readonly encoding: string;
+  readonly fatal: boolean;
+  readonly ignoreBOM: boolean;
+  decode(input?: Uint8Array): string;
+};
+type TextDecoderConstructor = {
+  new (label: 'utf8', options: { fatal: boolean; ignoreBOM?: boolean }): TextDecoder;
+};
+
+// parse utf8 globals
+declare const TextDecoder: TextDecoderConstructor;
+let TextDecoderFatal: TextDecoder;
+let TextDecoderNonFatal: TextDecoder;
+
+/**
+ * Determines if the passed in bytes are valid utf8
+ * @param bytes - An array of 8-bit bytes. Must be indexable and have length property
+ * @param start - The index to start validating
+ * @param end - The index to end validating
+ */
+export function parseUtf8(buffer: Uint8Array, start: number, end: number, fatal: boolean): string {
+  if (fatal) {
+    TextDecoderFatal ??= new TextDecoder('utf8', { fatal: true });
+    try {
+      return TextDecoderFatal.decode(buffer.subarray(start, end));
+    } catch (cause) {
+      throw new BSONError('Invalid UTF-8 string in BSON document', { cause });
+    }
+  }
+  TextDecoderNonFatal ??= new TextDecoder('utf8', { fatal: false });
+  return TextDecoderNonFatal.decode(buffer.subarray(start, end));
+}

gateway/node_modules/bson/src/parser/calculate_size.ts

@@ -0,0 +1,239 @@
+import { Binary } from '../binary';
+import type { Document } from '../bson';
+import { BSONError, BSONVersionError } from '../error';
+import * as constants from '../constants';
+import { ByteUtils } from '../utils/byte_utils';
+import { isAnyArrayBuffer, isDate, isMap, isRegExp } from './utils';
+
+export function internalCalculateObjectSize(
+  object: Document,
+  serializeFunctions?: boolean,
+  ignoreUndefined?: boolean
+): number {
+  // Each stack entry carries its own ignoreUndefined so DBRef fields can force ignoreUndefined=true
+  // regardless of the caller's setting, matching the behavior of serializeInto.
+  const objectStack: Array<{ obj: Document; ignoreUndefined: boolean }> = [
+    { obj: object, ignoreUndefined: ignoreUndefined ?? false }
+  ];
+  let total = 0;
+
+  while (objectStack.length > 0) {
+    const { obj, ignoreUndefined: frameIgnoreUndefined } = objectStack.pop()!;
+    total += 5; // 4-byte size field + null terminator
+
+    const isObjArray = Array.isArray(obj);
+    const isObjMap = !isObjArray && (obj instanceof Map || isMap(obj));
+    let target = obj;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (!isObjArray && !isObjMap && typeof (obj as any)?.toBSON === 'function') {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      target = (obj as any).toBSON();
+    }
+
+    if (isObjArray) {
+      const array = target as unknown[];
+      for (let i = 0; i < array.length; i++) {
+        total += calculateElementSize(
+          i.toString(),
+          array[i],
+          serializeFunctions,
+          true,
+          frameIgnoreUndefined,
+          objectStack
+        );
+      }
+    } else if (isObjMap) {
+      for (const [key, value] of target as Map<string, unknown>) {
+        total += calculateElementSize(
+          key,
+          value,
+          serializeFunctions,
+          false,
+          frameIgnoreUndefined,
+          objectStack
+        );
+      }
+    } else {
+      for (const key of Object.keys(target)) {
+        total += calculateElementSize(
+          key,
+          target[key],
+          serializeFunctions,
+          false,
+          frameIgnoreUndefined,
+          objectStack
+        );
+      }
+    }
+  }
+
+  return total;
+}
+
+/** @internal */
+function calculateElementSize(
+  name: string,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  value: any,
+  serializeFunctions = false,
+  isArray = false,
+  ignoreUndefined = false,
+  objectStack: Array<{ obj: Document; ignoreUndefined: boolean }>
+): number {
+  // If we have toBSON defined, override the current object
+  if (typeof value?.toBSON === 'function') {
+    value = value.toBSON();
+  }
+
+  switch (typeof value) {
+    case 'string':
+      return 1 + ByteUtils.utf8ByteLength(name) + 1 + 4 + ByteUtils.utf8ByteLength(value) + 1;
+    case 'number':
+      if (
+        Math.floor(value) === value &&
+        value >= constants.JS_INT_MIN &&
+        value <= constants.JS_INT_MAX
+      ) {
+        if (value >= constants.BSON_INT32_MIN && value <= constants.BSON_INT32_MAX) {
+          // 32 bit
+          return ByteUtils.utf8ByteLength(name) + 1 + (4 + 1);
+        } else {
+          return ByteUtils.utf8ByteLength(name) + 1 + (8 + 1);
+        }
+      } else {
+        // 64 bit
+        return ByteUtils.utf8ByteLength(name) + 1 + (8 + 1);
+      }
+    case 'undefined':
+      if (isArray || !ignoreUndefined) return ByteUtils.utf8ByteLength(name) + 1 + 1;
+      return 0;
+    case 'boolean':
+      return ByteUtils.utf8ByteLength(name) + 1 + (1 + 1);
+    case 'object':
+      if (
+        value != null &&
+        typeof value._bsontype === 'string' &&
+        value[constants.BSON_VERSION_SYMBOL] !== constants.BSON_MAJOR_VERSION
+      ) {
+        throw new BSONVersionError();
+      } else if (value == null || value._bsontype === 'MinKey' || value._bsontype === 'MaxKey') {
+        return ByteUtils.utf8ByteLength(name) + 1 + 1;
+      } else if (value._bsontype === 'ObjectId') {
+        return ByteUtils.utf8ByteLength(name) + 1 + (12 + 1);
+      } else if (value instanceof Date || isDate(value)) {
+        return ByteUtils.utf8ByteLength(name) + 1 + (8 + 1);
+      } else if (
+        ArrayBuffer.isView(value) ||
+        value instanceof ArrayBuffer ||
+        isAnyArrayBuffer(value)
+      ) {
+        return ByteUtils.utf8ByteLength(name) + 1 + (1 + 4 + 1) + value.byteLength;
+      } else if (
+        value._bsontype === 'Long' ||
+        value._bsontype === 'Double' ||
+        value._bsontype === 'Timestamp'
+      ) {
+        return ByteUtils.utf8ByteLength(name) + 1 + (8 + 1);
+      } else if (value._bsontype === 'Decimal128') {
+        return ByteUtils.utf8ByteLength(name) + 1 + (16 + 1);
+      } else if (value._bsontype === 'Int32') {
+        return ByteUtils.utf8ByteLength(name) + 1 + (4 + 1);
+      } else if (value._bsontype === 'Code') {
+        // Calculate size depending on the availability of a scope
+        if (value.scope != null && Object.keys(value.scope).length > 0) {
+          objectStack.push({ obj: value.scope, ignoreUndefined });
+          return (
+            ByteUtils.utf8ByteLength(name) +
+            1 +
+            1 +
+            4 +
+            4 +
+            ByteUtils.utf8ByteLength(value.code.toString()) +
+            1
+          );
+        } else {
+          return (
+            ByteUtils.utf8ByteLength(name) +
+            1 +
+            1 +
+            4 +
+            ByteUtils.utf8ByteLength(value.code.toString()) +
+            1
+          );
+        }
+      } else if (value._bsontype === 'Binary') {
+        const binary: Binary = value;
+        // Check what kind of subtype we have
+        if (binary.sub_type === Binary.SUBTYPE_BYTE_ARRAY) {
+          return ByteUtils.utf8ByteLength(name) + 1 + (binary.position + 1 + 4 + 1 + 4);
+        } else {
+          return ByteUtils.utf8ByteLength(name) + 1 + (binary.position + 1 + 4 + 1);
+        }
+      } else if (value._bsontype === 'BSONSymbol') {
+        return (
+          ByteUtils.utf8ByteLength(name) + 1 + ByteUtils.utf8ByteLength(value.value) + 4 + 1 + 1
+        );
+      } else if (value._bsontype === 'DBRef') {
+        // Set up correct object for serialization
+        const ordered_values = Object.assign(
+          {
+            $ref: value.collection,
+            $id: value.oid
+          },
+          value.fields
+        );
+
+        // Add db reference if it exists
+        if (value.db != null) {
+          ordered_values['$db'] = value.db;
+        }
+
+        // DBRef fields always use ignoreUndefined=true to match serializeInto behavior.
+        objectStack.push({ obj: ordered_values, ignoreUndefined: true });
+        return ByteUtils.utf8ByteLength(name) + 1 + 1;
+      } else if (value instanceof RegExp || isRegExp(value)) {
+        return (
+          ByteUtils.utf8ByteLength(name) +
+          1 +
+          1 +
+          ByteUtils.utf8ByteLength(value.source) +
+          1 +
+          (value.global ? 1 : 0) +
+          (value.ignoreCase ? 1 : 0) +
+          (value.multiline ? 1 : 0) +
+          1
+        );
+      } else if (value._bsontype === 'BSONRegExp') {
+        return (
+          ByteUtils.utf8ByteLength(name) +
+          1 +
+          1 +
+          ByteUtils.utf8ByteLength(value.pattern) +
+          1 +
+          ByteUtils.utf8ByteLength(value.options) +
+          1
+        );
+      } else {
+        objectStack.push({ obj: value, ignoreUndefined });
+        return ByteUtils.utf8ByteLength(name) + 1 + 1;
+      }
+    case 'function':
+      if (serializeFunctions) {
+        return (
+          ByteUtils.utf8ByteLength(name) +
+          1 +
+          1 +
+          4 +
+          ByteUtils.utf8ByteLength(value.toString()) +
+          1
+        );
+      }
+      return 0;
+    case 'bigint':
+      return ByteUtils.utf8ByteLength(name) + 1 + (8 + 1);
+    case 'symbol':
+      return 0;
+    default:
+      throw new BSONError(`Unrecognized JS type: ${typeof value}`);
+  }
+}

gateway/node_modules/bson/src/parser/deserializer.ts

@@ -0,0 +1,793 @@
+import { Binary, UUID } from '../binary';
+import type { Document } from '../bson';
+import { Code } from '../code';
+import * as constants from '../constants';
+import { DBRef, isDBRefLike } from '../db_ref';
+import { Decimal128 } from '../decimal128';
+import { Double } from '../double';
+import { BSONError } from '../error';
+import { Int32 } from '../int_32';
+import { Long } from '../long';
+import { MaxKey } from '../max_key';
+import { MinKey } from '../min_key';
+import { ObjectId } from '../objectid';
+import { BSONRegExp } from '../regexp';
+import { BSONSymbol } from '../symbol';
+import { Timestamp } from '../timestamp';
+import { ByteUtils } from '../utils/byte_utils';
+import { NumberUtils } from '../utils/number_utils';
+
+/** @public */
+export interface DeserializeOptions {
+  /**
+   * when deserializing a Long return as a BigInt.
+   * @defaultValue `false`
+   */
+  useBigInt64?: boolean;
+  /**
+   * when deserializing a Long will fit it into a Number if it's smaller than 53 bits.
+   * @defaultValue `true`
+   */
+  promoteLongs?: boolean;
+  /**
+   * when deserializing a Binary will return it as a node.js Buffer instance.
+   * @defaultValue `false`
+   */
+  promoteBuffers?: boolean;
+  /**
+   * when deserializing will promote BSON values to their Node.js closest equivalent types.
+   * @defaultValue `true`
+   */
+  promoteValues?: boolean;
+  /**
+   * allow to specify if there what fields we wish to return as unserialized raw buffer.
+   * @defaultValue `null`
+   */
+  fieldsAsRaw?: Document;
+  /**
+   * return BSON regular expressions as BSONRegExp instances.
+   * @defaultValue `false`
+   */
+  bsonRegExp?: boolean;
+  /**
+   * allows the buffer to be larger than the parsed BSON object.
+   * @defaultValue `false`
+   */
+  allowObjectSmallerThanBufferSize?: boolean;
+  /**
+   * Offset into buffer to begin reading document from
+   * @defaultValue `0`
+   */
+  index?: number;
+
+  raw?: boolean;
+  /** Allows for opt-out utf-8 validation for all keys or
+   * specified keys. Must be all true or all false.
+   *
+   * @example
+   * ```js
+   * // disables validation on all keys
+   *  validation: { utf8: false }
+   *
+   * // enables validation only on specified keys a, b, and c
+   *  validation: { utf8: { a: true, b: true, c: true } }
+   *
+   *  // disables validation only on specified keys a, b
+   *  validation: { utf8: { a: false, b: false } }
+   * ```
+   */
+  validation?: { utf8: boolean | Record<string, true> | Record<string, false> };
+}
+
+// Internal long versions
+const JS_INT_MAX_LONG = Long.fromNumber(constants.JS_INT_MAX);
+const JS_INT_MIN_LONG = Long.fromNumber(constants.JS_INT_MIN);
+
+export function internalDeserialize(
+  buffer: Uint8Array,
+  options: DeserializeOptions,
+  isArray?: boolean
+): Document {
+  options = options == null ? {} : options;
+  const index = options && options.index ? options.index : 0;
+  // Read the document size
+  const size = NumberUtils.getInt32LE(buffer, index);
+
+  if (size < 5) {
+    throw new BSONError(`bson size must be >= 5, is ${size}`);
+  }
+
+  if (options.allowObjectSmallerThanBufferSize && buffer.length < size) {
+    throw new BSONError(`buffer length ${buffer.length} must be >= bson size ${size}`);
+  }
+
+  if (!options.allowObjectSmallerThanBufferSize && buffer.length !== size) {
+    throw new BSONError(`buffer length ${buffer.length} must === bson size ${size}`);
+  }
+
+  if (size + index > buffer.byteLength) {
+    throw new BSONError(
+      `(bson size ${size} + options.index ${index} must be <= buffer length ${buffer.byteLength})`
+    );
+  }
+
+  // Illegal end value
+  if (buffer[index + size - 1] !== 0) {
+    throw new BSONError(
+      "One object, sized correctly, with a spot for an EOO, but the EOO isn't 0x00"
+    );
+  }
+
+  // Start deserialization
+  return deserializeObject(buffer, index, options, isArray);
+}
+
+interface NestedParsingFrame {
+  // One of 3 supported types:
+  // - constants.BSON_DATA_OBJECT
+  // - constants.BSON_DATA_ARRAY
+  // - constants.BSON_DATA_CODE_W_SCOPE
+  elementType:
+    | typeof constants.BSON_DATA_OBJECT
+    | typeof constants.BSON_DATA_ARRAY
+    | typeof constants.BSON_DATA_CODE_W_SCOPE;
+  // Document that we will fill out as we parse the nested object
+  holdingDocument: Document;
+  // The name of the key we will set the parsed object on once we finish parsing the nested object, this is used in the onComplete callback to know where to set the parsed nested object in the parent document
+  propertyName: string | number;
+  // The index in the buffer where the current object ends, used to know when we are done parsing the current object and can pop the stack
+  lastIndex: number;
+  // Whether the current frame is parsing an array, used to know whether to interpret keys as strings or array indices
+  isArray: boolean;
+  // The next array index to use if this frame is parsing an array, used to assign numeric keys to array elements without having to utf-8 decode the key from the buffer
+  arrayIndex: number;
+  // When true, all objects in this frame will be returned as raw bson buffers without parsing.
+  // This is used when the fieldsAsRaw option is used on a parent object, and is inherited by nested frames.
+  // It can also be set to true if the global raw option is set, but it cannot be set to true for a frame if the global raw option is false.
+  raw: boolean;
+  // When true, this frame may be a DBRef. This is set to false if we encounter a key that is not valid for a DBRef, and is left as null for arrays since they cannot be DBRefs.
+  isPossibleDBRef: boolean | null;
+  // The utf-8 validation setting for this frame, used to determine whether to utf-8 validate keys in this frame. This is determined based on the global utf-8 validation setting and the specific keys specified in the validation option.
+  validationSetting: boolean;
+  functionString: string | null; // only used for Code with Scope
+  // The enclosing frame, or null at the top level. The parsing stack is a linked list threaded
+  // through this field rather than a separate array, which avoids array push/pop churn per frame.
+  prev: NestedParsingFrame | null;
+}
+
+const allowedDBRefKeys = /^\$ref$|^\$id$|^\$db$/;
+
+// Assigns a parsed value into the destination document, guarding the __proto__ key to avoid
+// prototype pollution.
+function assignValue(dest: Document, name: string | number, value: unknown): void {
+  if (name === '__proto__') {
+    Object.defineProperty(dest, name, {
+      value,
+      writable: true,
+      enumerable: true,
+      configurable: true
+    });
+  } else {
+    dest[name] = value;
+  }
+}
+
+// Promotes a plain document to a DBRef instance when it has the DBRef shape ($ref/$id[/$db]).
+function toPotentialDbRef(doc: Document): DBRef | Document {
+  if (isDBRefLike(doc)) {
+    const { $ref, $id, $db, ...fields } = doc;
+    return new DBRef($ref, $id, $db, fields);
+  }
+  return doc;
+}
+
+function deserializeObject(
+  buffer: Uint8Array,
+  index: number,
+  options: DeserializeOptions,
+  isArray = false
+) {
+  // Settings configured from options parameter
+
+  // Strips prototype chain so inherited properties don't affect option reads.
+  options = { ...options };
+
+  // Used to track fields that should be returned as raw bson buffers without parsing, this is set based on the fieldsAsRaw option and is inherited by nested frames when parsing nested objects
+  const fieldsAsRaw = options['fieldsAsRaw'] == null ? null : options['fieldsAsRaw'];
+
+  // Return raw bson buffer instead of parsing it
+  const raw = options['raw'] == null ? false : options['raw'];
+
+  // Return BSONRegExp objects instead of native regular expressions
+  const bsonRegExp = typeof options['bsonRegExp'] === 'boolean' ? options['bsonRegExp'] : false;
+
+  // Controls the promotion of values vs wrapper classes
+  const promoteBuffers = options.promoteBuffers ?? false;
+  const promoteLongs = options.promoteLongs ?? true;
+  const promoteValues = options.promoteValues ?? true;
+  const useBigInt64 = options.useBigInt64 ?? false;
+
+  // Validate bigint and long promotion settings
+  if (useBigInt64 && !promoteValues) {
+    throw new BSONError('Must either request bigint or Long for int64 deserialization');
+  }
+  if (useBigInt64 && !promoteLongs) {
+    throw new BSONError('Must either request bigint or Long for int64 deserialization');
+  }
+
+  // Ensures default validation option if none given
+  const validation = options.validation == null ? { utf8: true } : options.validation;
+
+  // Shows if global utf-8 validation is enabled or disabled
+  let globalUTFValidation = true;
+  // Reflects utf-8 validation setting regardless of global or specific key validation
+  let validationSetting: boolean;
+  // Set of keys either to enable or disable validation on
+  let utf8KeysSet;
+
+  // Check for boolean uniformity and empty validation option
+  const utf8ValidatedKeys = validation.utf8;
+  if (typeof utf8ValidatedKeys === 'boolean') {
+    validationSetting = utf8ValidatedKeys;
+  } else {
+    globalUTFValidation = false;
+    const utf8ValidationValues = Object.keys(utf8ValidatedKeys).map(function (key) {
+      return utf8ValidatedKeys[key];
+    });
+    if (utf8ValidationValues.length === 0) {
+      throw new BSONError('UTF-8 validation setting cannot be empty');
+    }
+    if (typeof utf8ValidationValues[0] !== 'boolean') {
+      throw new BSONError('Invalid UTF-8 validation option, must specify boolean values');
+    }
+    validationSetting = utf8ValidationValues[0];
+    // Ensures boolean uniformity in utf-8 validation (all true or all false)
+    if (!utf8ValidationValues.every(item => item === validationSetting)) {
+      throw new BSONError('Invalid UTF-8 validation option - keys must be all true or all false');
+    }
+  }
+
+  // Add keys to set that will either be validated or not based on validationSetting
+  if (!globalUTFValidation) {
+    utf8KeysSet = new Set();
+
+    for (const key of Object.keys(utf8ValidatedKeys)) {
+      utf8KeysSet.add(key);
+    }
+  }
+
+  // Begin parsing the document
+
+  // Set the start index
+  const startIndex = index;
+
+  // Validate that we have at least 4 bytes of buffer
+  if (buffer.length < 5) throw new BSONError('corrupt bson message < 5 bytes long');
+
+  // Read the document size
+  const size = NumberUtils.getInt32LE(buffer, index);
+  // Skip past the size field
+  index += 4;
+
+  // Ensure buffer is valid size
+  if (size < 5 || size > buffer.length) throw new BSONError('corrupt bson message');
+
+  // Create holding object
+  const rootObject: Document = isArray ? [] : {};
+  // Used for arrays to skip having to perform utf8 decoding
+  let arrayIndex = 0;
+
+  let isPossibleDBRef = isArray ? false : null;
+
+  // Top of the parsing stack (a linked list via each frame's `prev`), or null at the top level.
+  let currentFrame: NestedParsingFrame | null = null;
+  // Destination object for the current frame (the parent's holdingDocument, or rootObject at the
+  // top level). Maintained alongside currentFrame so per-field assignment never recomputes it.
+  let currentDest: Document = rootObject;
+  // Whether the current frame is an array. Maintained alongside currentFrame so the per-field key
+  // logic does not branch on currentFrame every iteration.
+  let currentIsArray = isArray;
+
+  // While we have more left data left keep parsing
+  while (true) {
+    // Read the type
+    const elementType = buffer[index++];
+
+    // If we get a zero it's the last byte, exit
+    if (elementType === 0) {
+      // 0 byte marks end of document.
+      if (currentFrame) {
+        // If we're in a frame, that means the end of the current nested document
+        if (index === currentFrame.lastIndex) {
+          // Snapshot the completed frame before updating currentFrame to the parent.
+          const completedFrame: NestedParsingFrame = currentFrame;
+          currentFrame = completedFrame.prev;
+          if (currentFrame === null) {
+            currentDest = rootObject;
+            currentIsArray = isArray;
+          } else {
+            currentDest = currentFrame.holdingDocument;
+            currentIsArray = currentFrame.isArray;
+          }
+          // finish the frame
+          let result: Document = completedFrame.holdingDocument;
+          switch (completedFrame.elementType) {
+            case constants.BSON_DATA_OBJECT:
+              // if this is a DBRef, we need to construct a DBRef object instead of a plain object
+              if (completedFrame.isPossibleDBRef) {
+                result = toPotentialDbRef(result);
+              }
+              break;
+            case constants.BSON_DATA_ARRAY:
+              // nothing to do, the holding document is already an array and the keys were set as numeric indices
+              break;
+            case constants.BSON_DATA_CODE_W_SCOPE:
+              // the holding document is the scope, we need to construct a Code object with the function string and scope
+              result = new Code(completedFrame.functionString!, completedFrame.holdingDocument);
+              break;
+            default:
+              throw new BSONError('Unexpected element type in frame stack');
+          }
+          // set the value in the parent document (currentDest now points to the parent's document)
+          assignValue(currentDest, completedFrame.propertyName, result);
+          continue;
+        } else {
+          // Current index does not match the last index of the frame, the document is malformed
+          if (currentFrame.elementType === constants.BSON_DATA_ARRAY) {
+            throw new BSONError('corrupted array bson');
+          }
+          throw new BSONError('Bad BSON Document: object not properly terminated');
+        }
+      } else {
+        // If we're not in a frame, that means the end of the root document, so we break out of the loop and return the object
+        break;
+      }
+    }
+
+    // Get the start search index
+    let i = index;
+    // Locate the end of the c string
+    while (buffer[i] !== 0x00 && i < buffer.length) {
+      i++;
+    }
+
+    // If are at the end of the buffer there is a problem with the document
+    if (i >= buffer.byteLength) throw new BSONError('Bad BSON Document: illegal CString');
+
+    // Represents the key
+    const name = currentIsArray
+      ? currentFrame !== null
+        ? currentFrame.arrayIndex++
+        : arrayIndex++
+      : ByteUtils.toUTF8(buffer, index, i, false);
+
+    // shouldValidateKey is true if the key should be validated, false otherwise.
+    // Within a nested frame the original code passed a collapsed boolean validation option,
+    // so all keys in the frame are validated uniformly using the frame's setting.
+    let shouldValidateKey: boolean;
+    if (currentFrame !== null) {
+      shouldValidateKey = currentFrame.validationSetting;
+    } else if (globalUTFValidation || utf8KeysSet?.has(name)) {
+      shouldValidateKey = validationSetting;
+    } else {
+      shouldValidateKey = !validationSetting;
+    }
+
+    // Route DBRef key tracking to the current frame; the root variable handles the root doc.
+    if (currentFrame !== null) {
+      if (currentFrame.isPossibleDBRef !== false && typeof name === 'string' && name[0] === '$') {
+        currentFrame.isPossibleDBRef = allowedDBRefKeys.test(name);
+      }
+    } else if (isPossibleDBRef !== false && (name as string)[0] === '$') {
+      isPossibleDBRef = allowedDBRefKeys.test(name as string);
+    }
+    let value;
+    let isDeferredValue = false;
+
+    index = i + 1;
+
+    if (elementType === constants.BSON_DATA_STRING) {
+      const stringSize = NumberUtils.getInt32LE(buffer, index);
+      index += 4;
+      if (
+        stringSize <= 0 ||
+        stringSize > buffer.length - index ||
+        buffer[index + stringSize - 1] !== 0
+      ) {
+        throw new BSONError('bad string length in bson');
+      }
+      value = ByteUtils.toUTF8(buffer, index, index + stringSize - 1, shouldValidateKey);
+      index = index + stringSize;
+    } else if (elementType === constants.BSON_DATA_OID) {
+      // ObjectId reads these 12 bytes from the wire buffer at this offset into its own fields
+      // and keeps no reference to the source, so the buffer can be passed directly.
+      value = new ObjectId(buffer, index);
+      index = index + 12;
+    } else if (elementType === constants.BSON_DATA_INT && promoteValues === false) {
+      value = new Int32(NumberUtils.getInt32LE(buffer, index));
+      index += 4;
+    } else if (elementType === constants.BSON_DATA_INT) {
+      value = NumberUtils.getInt32LE(buffer, index);
+      index += 4;
+    } else if (elementType === constants.BSON_DATA_NUMBER) {
+      value = NumberUtils.getFloat64LE(buffer, index);
+      index += 8;
+      if (promoteValues === false) value = new Double(value);
+    } else if (elementType === constants.BSON_DATA_DATE) {
+      const lowBits = NumberUtils.getInt32LE(buffer, index);
+      const highBits = NumberUtils.getInt32LE(buffer, index + 4);
+      index += 8;
+
+      value = new Date(new Long(lowBits, highBits).toNumber());
+    } else if (elementType === constants.BSON_DATA_BOOLEAN) {
+      if (buffer[index] !== 0 && buffer[index] !== 1)
+        throw new BSONError('illegal boolean type value');
+      value = buffer[index++] === 1;
+    } else if (elementType === constants.BSON_DATA_OBJECT) {
+      const objectSize = NumberUtils.getInt32LE(buffer, index);
+
+      if (objectSize < 5 || objectSize > buffer.length - index)
+        throw new BSONError('bad embedded document length in bson');
+
+      // We have a raw value: either the global raw option, or the parent frame requested raw elements.
+      if (raw || (currentFrame?.raw ?? false)) {
+        value = buffer.subarray(index, index + objectSize);
+        index = index + objectSize;
+      } else {
+        isDeferredValue = true;
+        const objectFrame: NestedParsingFrame = {
+          holdingDocument: {},
+          elementType: constants.BSON_DATA_OBJECT,
+          propertyName: name,
+          functionString: null,
+          lastIndex: index + objectSize,
+          isArray: false,
+          arrayIndex: 0,
+          raw: false,
+          isPossibleDBRef: null, // we don't know if this is a DBRef until we parse the keys, so we start with null and set to false if we encounter a key that is not valid for a DBRef
+          validationSetting: shouldValidateKey,
+          prev: currentFrame
+        };
+        currentFrame = objectFrame;
+        currentDest = objectFrame.holdingDocument;
+        currentIsArray = false;
+        index = index + 4;
+      }
+    } else if (elementType === constants.BSON_DATA_ARRAY) {
+      const objectSize = NumberUtils.getInt32LE(buffer, index);
+
+      if (objectSize < 5 || objectSize > buffer.length - index)
+        throw new BSONError('bad embedded array length in bson');
+
+      // Stop index
+      const stopIndex = index + objectSize;
+
+      // fieldsAsRaw match: push with raw=true so embedded objects inside come back as raw bytes.
+      // Also propagate raw from the parent frame (nested arrays inside a raw array stay raw).
+      const arrayRaw = !!(fieldsAsRaw && fieldsAsRaw[name]) || (currentFrame?.raw ?? false);
+      isDeferredValue = true;
+      const arrayFrame: NestedParsingFrame = {
+        holdingDocument: [],
+        elementType: constants.BSON_DATA_ARRAY,
+        propertyName: name,
+        functionString: null,
+        lastIndex: stopIndex,
+        isArray: true,
+        arrayIndex: 0,
+        raw: arrayRaw,
+        isPossibleDBRef: false,
+        validationSetting: shouldValidateKey,
+        prev: currentFrame
+      };
+      currentFrame = arrayFrame;
+      currentDest = arrayFrame.holdingDocument;
+      currentIsArray = true;
+      index = index + 4;
+    } else if (elementType === constants.BSON_DATA_UNDEFINED) {
+      value = undefined;
+    } else if (elementType === constants.BSON_DATA_NULL) {
+      value = null;
+    } else if (elementType === constants.BSON_DATA_LONG) {
+      if (useBigInt64) {
+        value = NumberUtils.getBigInt64LE(buffer, index);
+        index += 8;
+      } else {
+        // Unpack the low and high bits
+        const lowBits = NumberUtils.getInt32LE(buffer, index);
+        const highBits = NumberUtils.getInt32LE(buffer, index + 4);
+        index += 8;
+
+        const long = new Long(lowBits, highBits);
+        // Promote the long if possible
+        if (promoteLongs && promoteValues === true) {
+          value =
+            long.lessThanOrEqual(JS_INT_MAX_LONG) && long.greaterThanOrEqual(JS_INT_MIN_LONG)
+              ? long.toNumber()
+              : long;
+        } else {
+          value = long;
+        }
+      }
+    } else if (elementType === constants.BSON_DATA_DECIMAL128) {
+      // Buffer to contain the decimal bytes
+      const bytes = ByteUtils.allocateUnsafe(16);
+      // Copy the next 16 bytes into the bytes buffer
+      for (let i = 0; i < 16; i++) bytes[i] = buffer[index + i];
+      // Update index
+      index = index + 16;
+      // Assign the new Decimal128 value
+      value = new Decimal128(bytes);
+    } else if (elementType === constants.BSON_DATA_BINARY) {
+      let binarySize = NumberUtils.getInt32LE(buffer, index);
+      index += 4;
+      const totalBinarySize = binarySize;
+      const subType = buffer[index++];
+
+      // Did we have a negative binary size, throw
+      if (binarySize < 0) throw new BSONError('Negative binary type element size found');
+
+      // Is the length longer than the document
+      if (binarySize > buffer.byteLength)
+        throw new BSONError('Binary type size larger than document size');
+
+      // If we have subtype 2 skip the 4 bytes for the size
+      if (subType === Binary.SUBTYPE_BYTE_ARRAY) {
+        binarySize = NumberUtils.getInt32LE(buffer, index);
+        index += 4;
+        if (binarySize < 0)
+          throw new BSONError('Negative binary type element size found for subtype 0x02');
+        if (binarySize > totalBinarySize - 4)
+          throw new BSONError('Binary type with subtype 0x02 contains too long binary size');
+        if (binarySize < totalBinarySize - 4)
+          throw new BSONError('Binary type with subtype 0x02 contains too short binary size');
+      }
+
+      if (promoteBuffers && promoteValues) {
+        value = ByteUtils.toLocalBufferType(buffer.subarray(index, index + binarySize));
+      } else {
+        value = new Binary(buffer.subarray(index, index + binarySize), subType);
+        if (subType === constants.BSON_BINARY_SUBTYPE_UUID_NEW && UUID.isValid(value)) {
+          value = value.toUUID();
+        }
+      }
+
+      // Update the index
+      index = index + binarySize;
+    } else if (elementType === constants.BSON_DATA_REGEXP && bsonRegExp === false) {
+      // Get the start search index
+      i = index;
+      // Locate the end of the c string
+      while (buffer[i] !== 0x00 && i < buffer.length) {
+        i++;
+      }
+      // If are at the end of the buffer there is a problem with the document
+      if (i >= buffer.length) throw new BSONError('Bad BSON Document: illegal CString');
+      // Return the C string
+      const source = ByteUtils.toUTF8(buffer, index, i, false);
+      // Create the regexp
+      index = i + 1;
+
+      // Get the start search index
+      i = index;
+      // Locate the end of the c string
+      while (buffer[i] !== 0x00 && i < buffer.length) {
+        i++;
+      }
+      // If are at the end of the buffer there is a problem with the document
+      if (i >= buffer.length) throw new BSONError('Bad BSON Document: illegal CString');
+      // Return the C string
+      const regExpOptions = ByteUtils.toUTF8(buffer, index, i, false);
+      index = i + 1;
+
+      // For each option add the corresponding one for javascript
+      const optionsArray = new Array(regExpOptions.length);
+
+      // Parse options
+      for (i = 0; i < regExpOptions.length; i++) {
+        switch (regExpOptions[i]) {
+          case 'm':
+            optionsArray[i] = 'm';
+            break;
+          case 's':
+            optionsArray[i] = 'g';
+            break;
+          case 'i':
+            optionsArray[i] = 'i';
+            break;
+        }
+      }
+
+      value = new RegExp(source, optionsArray.join(''));
+    } else if (elementType === constants.BSON_DATA_REGEXP && bsonRegExp === true) {
+      // Get the start search index
+      i = index;
+      // Locate the end of the c string
+      while (buffer[i] !== 0x00 && i < buffer.length) {
+        i++;
+      }
+      // If are at the end of the buffer there is a problem with the document
+      if (i >= buffer.length) throw new BSONError('Bad BSON Document: illegal CString');
+      // Return the C string
+      const source = ByteUtils.toUTF8(buffer, index, i, false);
+      index = i + 1;
+
+      // Get the start search index
+      i = index;
+      // Locate the end of the c string
+      while (buffer[i] !== 0x00 && i < buffer.length) {
+        i++;
+      }
+      // If are at the end of the buffer there is a problem with the document
+      if (i >= buffer.length) throw new BSONError('Bad BSON Document: illegal CString');
+      // Return the C string
+      const regExpOptions = ByteUtils.toUTF8(buffer, index, i, false);
+      index = i + 1;
+
+      // Set the object
+      value = new BSONRegExp(source, regExpOptions);
+    } else if (elementType === constants.BSON_DATA_SYMBOL) {
+      const stringSize = NumberUtils.getInt32LE(buffer, index);
+      index += 4;
+      if (
+        stringSize <= 0 ||
+        stringSize > buffer.length - index ||
+        buffer[index + stringSize - 1] !== 0
+      ) {
+        throw new BSONError('bad string length in bson');
+      }
+      const symbol = ByteUtils.toUTF8(buffer, index, index + stringSize - 1, shouldValidateKey);
+      value = promoteValues ? symbol : new BSONSymbol(symbol);
+      index = index + stringSize;
+    } else if (elementType === constants.BSON_DATA_TIMESTAMP) {
+      value = new Timestamp({
+        i: NumberUtils.getUint32LE(buffer, index),
+        t: NumberUtils.getUint32LE(buffer, index + 4)
+      });
+      index += 8;
+    } else if (elementType === constants.BSON_DATA_MIN_KEY) {
+      value = new MinKey();
+    } else if (elementType === constants.BSON_DATA_MAX_KEY) {
+      value = new MaxKey();
+    } else if (elementType === constants.BSON_DATA_CODE) {
+      const stringSize = NumberUtils.getInt32LE(buffer, index);
+      index += 4;
+      if (
+        stringSize <= 0 ||
+        stringSize > buffer.length - index ||
+        buffer[index + stringSize - 1] !== 0
+      ) {
+        throw new BSONError('bad string length in bson');
+      }
+      const functionString = ByteUtils.toUTF8(
+        buffer,
+        index,
+        index + stringSize - 1,
+        shouldValidateKey
+      );
+
+      value = new Code(functionString);
+
+      // Update parse index position
+      index = index + stringSize;
+    } else if (elementType === constants.BSON_DATA_CODE_W_SCOPE) {
+      const totalSize = NumberUtils.getInt32LE(buffer, index);
+      index += 4;
+
+      // Element cannot be shorter than totalSize + stringSize + documentSize + terminator
+      if (totalSize < 4 + 4 + 4 + 1) {
+        throw new BSONError('code_w_scope total size shorter minimum expected length');
+      }
+
+      // Get the code string size
+      const stringSize = NumberUtils.getInt32LE(buffer, index);
+      index += 4;
+      // Check if we have a valid string
+      if (
+        stringSize <= 0 ||
+        stringSize > buffer.length - index ||
+        buffer[index + stringSize - 1] !== 0
+      ) {
+        throw new BSONError('bad string length in bson');
+      }
+
+      // Javascript function
+      const functionString = ByteUtils.toUTF8(
+        buffer,
+        index,
+        index + stringSize - 1,
+        shouldValidateKey
+      );
+      // Update parse index position
+      index = index + stringSize;
+      // Parse the element
+      const _index = index;
+      // Decode the size of the object document
+      const objectSize = NumberUtils.getInt32LE(buffer, index);
+
+      if (objectSize < 5 || objectSize > buffer.length - index)
+        throw new BSONError('bad scope document size in code_w_scope');
+
+      // Check if field length is too short
+      if (totalSize < 4 + 4 + objectSize + stringSize) {
+        throw new BSONError('code_w_scope total size is too short, truncating scope');
+      }
+
+      // Check if totalSize field is too long
+      if (totalSize > 4 + 4 + objectSize + stringSize) {
+        throw new BSONError('code_w_scope total size is too long, clips outer document');
+      }
+
+      isDeferredValue = true;
+      const scopeFrame: NestedParsingFrame = {
+        holdingDocument: {},
+        elementType: constants.BSON_DATA_CODE_W_SCOPE,
+        propertyName: name,
+        functionString: functionString,
+        lastIndex: _index + objectSize,
+        isArray: false,
+        arrayIndex: 0,
+        raw: false,
+        isPossibleDBRef: null,
+        validationSetting: shouldValidateKey,
+        prev: currentFrame
+      };
+      currentFrame = scopeFrame;
+      currentDest = scopeFrame.holdingDocument;
+      currentIsArray = false;
+      index = index + 4; // move index past the size of the object, the rest of the object will be parsed in subsequent iterations of this loop
+    } else if (elementType === constants.BSON_DATA_DBPOINTER) {
+      // Get the code string size
+      const stringSize = NumberUtils.getInt32LE(buffer, index);
+      index += 4;
+      // Check if we have a valid string
+      if (
+        stringSize <= 0 ||
+        stringSize > buffer.length - index ||
+        buffer[index + stringSize - 1] !== 0
+      )
+        throw new BSONError('bad string length in bson');
+      // Namespace
+      const namespace = ByteUtils.toUTF8(buffer, index, index + stringSize - 1, shouldValidateKey);
+      // Update parse index position
+      index = index + stringSize;
+
+      // Read the oid
+      const oidBuffer = ByteUtils.allocateUnsafe(12);
+      for (let i = 0; i < 12; i++) oidBuffer[i] = buffer[index + i];
+      const oid = new ObjectId(oidBuffer);
+
+      // Update the index
+      index = index + 12;
+
+      // Upgrade to DBRef type
+      value = new DBRef(namespace, oid);
+    } else {
+      throw new BSONError(
+        `Detected unknown BSON type ${elementType.toString(16)} for fieldname "${name}"`
+      );
+    }
+
+    // If we have the value, set it on the target object
+    if (!isDeferredValue) {
+      assignValue(currentDest, name, value);
+    }
+  }
+
+  // Check if we have any frames left on the stack, if we do then we had a malformed document
+  if (currentFrame !== null) {
+    throw new BSONError('corrupted bson, more objects expected based on the current document size');
+  }
+  const object = rootObject;
+
+  // Check if the deserialization was against a valid array/object
+  if (size !== index - startIndex) {
+    if (isArray) throw new BSONError('corrupt array bson');
+    throw new BSONError('corrupt object bson');
+  }
+
+  // if we did not find "$ref", "$id", "$db", or found an extraneous $key, don't make a DBRef
+  if (!isPossibleDBRef) return object;
+
+  // If the object is DBRef-like, create a new DBRef instance
+  return toPotentialDbRef(object);
+}

gateway/node_modules/bson/src/parser/on_demand/index.ts

@@ -0,0 +1,32 @@
+import { ByteUtils } from '../../utils/byte_utils';
+import { NumberUtils } from '../../utils/number_utils';
+import { type BSONElement, parseToElements } from './parse_to_elements';
+/**
+ * @experimental
+ * @public
+ *
+ * A new set of BSON APIs that are currently experimental and not intended for production use.
+ */
+export type OnDemand = {
+  parseToElements: (this: void, bytes: Uint8Array, startOffset?: number) => Iterable<BSONElement>;
+  // Types
+  BSONElement: BSONElement;
+
+  // Utils
+  ByteUtils: ByteUtils;
+  NumberUtils: NumberUtils;
+};
+
+/**
+ * @experimental
+ * @public
+ */
+const onDemand: OnDemand = Object.create(null);
+
+onDemand.parseToElements = parseToElements;
+onDemand.ByteUtils = ByteUtils;
+onDemand.NumberUtils = NumberUtils;
+
+Object.freeze(onDemand);
+
+export { onDemand };

gateway/node_modules/bson/src/parser/on_demand/parse_to_elements.ts

@@ -0,0 +1,190 @@
+import { BSONOffsetError } from '../../error';
+import { NumberUtils } from '../../utils/number_utils';
+
+/**
+ * @internal
+ *
+ * @remarks
+ * - This enum is const so the code we produce will inline the numbers
+ * - `minKey` is set to 255 so unsigned comparisons succeed
+ * - Modify with caution, double check the bundle contains literals
+ */
+const BSONElementType = {
+  double: 1,
+  string: 2,
+  object: 3,
+  array: 4,
+  binData: 5,
+  undefined: 6,
+  objectId: 7,
+  bool: 8,
+  date: 9,
+  null: 10,
+  regex: 11,
+  dbPointer: 12,
+  javascript: 13,
+  symbol: 14,
+  javascriptWithScope: 15,
+  int: 16,
+  timestamp: 17,
+  long: 18,
+  decimal: 19,
+  minKey: 255,
+  maxKey: 127
+} as const;
+
+type BSONElementType = (typeof BSONElementType)[keyof typeof BSONElementType];
+
+/**
+ * @public
+ * @experimental
+ */
+export type BSONElement = [
+  type: number,
+  nameOffset: number,
+  nameLength: number,
+  offset: number,
+  length: number
+];
+
+function getSize(source: Uint8Array, offset: number) {
+  try {
+    return NumberUtils.getNonnegativeInt32LE(source, offset);
+  } catch (cause) {
+    throw new BSONOffsetError('BSON size cannot be negative', offset, { cause });
+  }
+}
+
+/**
+ * Searches for null terminator of a BSON element's value (Never the document null terminator)
+ * **Does not** bounds check since this should **ONLY** be used within parseToElements which has asserted that `bytes` ends with a `0x00`.
+ * So this will at most iterate to the document's terminator and error if that is the offset reached.
+ */
+function findNull(bytes: Uint8Array, offset: number): number {
+  let nullTerminatorOffset = offset;
+
+  for (; bytes[nullTerminatorOffset] !== 0x00; nullTerminatorOffset++);
+
+  if (nullTerminatorOffset === bytes.length - 1) {
+    // We reached the null terminator of the document, not a value's
+    throw new BSONOffsetError('Null terminator not found', offset);
+  }
+
+  return nullTerminatorOffset;
+}
+
+/**
+ * @public
+ * @experimental
+ */
+export function parseToElements(
+  bytes: Uint8Array,
+  startOffset: number | null = 0
+): Iterable<BSONElement> {
+  startOffset ??= 0;
+
+  if (bytes.length < 5) {
+    throw new BSONOffsetError(
+      `Input must be at least 5 bytes, got ${bytes.length} bytes`,
+      startOffset
+    );
+  }
+
+  const documentSize = getSize(bytes, startOffset);
+
+  if (documentSize > bytes.length - startOffset) {
+    throw new BSONOffsetError(
+      `Parsed documentSize (${documentSize} bytes) does not match input length (${bytes.length} bytes)`,
+      startOffset
+    );
+  }
+
+  if (bytes[startOffset + documentSize - 1] !== 0x00) {
+    throw new BSONOffsetError('BSON documents must end in 0x00', startOffset + documentSize);
+  }
+
+  const elements: BSONElement[] = [];
+  let offset = startOffset + 4;
+
+  while (offset <= documentSize + startOffset) {
+    const type = bytes[offset];
+    offset += 1;
+
+    if (type === 0) {
+      if (offset - startOffset !== documentSize) {
+        throw new BSONOffsetError(`Invalid 0x00 type byte`, offset);
+      }
+      break;
+    }
+
+    const nameOffset = offset;
+    const nameLength = findNull(bytes, offset) - nameOffset;
+    offset += nameLength + 1;
+
+    let length: number;
+
+    if (
+      type === BSONElementType.double ||
+      type === BSONElementType.long ||
+      type === BSONElementType.date ||
+      type === BSONElementType.timestamp
+    ) {
+      length = 8;
+    } else if (type === BSONElementType.int) {
+      length = 4;
+    } else if (type === BSONElementType.objectId) {
+      length = 12;
+    } else if (type === BSONElementType.decimal) {
+      length = 16;
+    } else if (type === BSONElementType.bool) {
+      length = 1;
+    } else if (
+      type === BSONElementType.null ||
+      type === BSONElementType.undefined ||
+      type === BSONElementType.maxKey ||
+      type === BSONElementType.minKey
+    ) {
+      length = 0;
+    }
+    // Needs a size calculation
+    else if (type === BSONElementType.regex) {
+      length = findNull(bytes, findNull(bytes, offset) + 1) + 1 - offset;
+    } else if (
+      type === BSONElementType.object ||
+      type === BSONElementType.array ||
+      type === BSONElementType.javascriptWithScope
+    ) {
+      length = getSize(bytes, offset);
+    } else if (
+      type === BSONElementType.string ||
+      type === BSONElementType.binData ||
+      type === BSONElementType.dbPointer ||
+      type === BSONElementType.javascript ||
+      type === BSONElementType.symbol
+    ) {
+      length = getSize(bytes, offset) + 4;
+      if (type === BSONElementType.binData) {
+        // binary subtype
+        length += 1;
+      }
+      if (type === BSONElementType.dbPointer) {
+        // dbPointer's objectId
+        length += 12;
+      }
+    } else {
+      throw new BSONOffsetError(
+        `Invalid 0x${type.toString(16).padStart(2, '0')} type byte`,
+        offset
+      );
+    }
+
+    if (length > documentSize) {
+      throw new BSONOffsetError('value reports length larger than document', offset);
+    }
+
+    elements.push([type, nameOffset, nameLength, offset, length]);
+    offset += length;
+  }
+
+  return elements;
+}

gateway/node_modules/bson/src/parser/serializer.ts

@@ -0,0 +1,748 @@
+import { Binary, validateBinaryVector } from '../binary';
+import type { BSONSymbol, DBRef, Document, MaxKey } from '../bson';
+import { bsonType } from '../bson_value';
+import type { Code } from '../code';
+import * as constants from '../constants';
+import type { Decimal128 } from '../decimal128';
+import type { Double } from '../double';
+import { BSONError, BSONVersionError } from '../error';
+import type { Int32 } from '../int_32';
+import { Long } from '../long';
+import type { MinKey } from '../min_key';
+import type { ObjectId } from '../objectid';
+import type { BSONRegExp } from '../regexp';
+import { ByteUtils } from '../utils/byte_utils';
+import { NumberUtils } from '../utils/number_utils';
+import { isAnyArrayBuffer, isDate, isMap, isRegExp, isUint8Array } from './utils';
+
+/** @public */
+export interface SerializeOptions {
+  /**
+   * the serializer will check if keys are valid.
+   * @defaultValue `false`
+   */
+  checkKeys?: boolean;
+  /**
+   * serialize the javascript functions
+   * @defaultValue `false`
+   */
+  serializeFunctions?: boolean;
+  /**
+   * serialize will not emit undefined fields
+   * note that the driver sets this to `false`
+   * @defaultValue `true`
+   */
+  ignoreUndefined?: boolean;
+  /** @internal Resize internal buffer */
+  minInternalBufferSize?: number;
+  /**
+   * the index in the buffer where we wish to start serializing into
+   * @defaultValue `0`
+   */
+  index?: number;
+}
+
+const regexp = /\x00/; // eslint-disable-line no-control-regex
+const ignoreKeys = new Set(['$db', '$ref', '$id', '$clusterTime']);
+
+function serializeString(buffer: Uint8Array, key: string, value: string, index: number) {
+  // Encode String type
+  buffer[index++] = constants.BSON_DATA_STRING;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes + 1;
+  buffer[index - 1] = 0;
+  // Write the string
+  const size = ByteUtils.encodeUTF8Into(buffer, value, index + 4);
+  // Write the size of the string to buffer
+  NumberUtils.setInt32LE(buffer, index, size + 1);
+  // Update index
+  index = index + 4 + size;
+  // Write zero
+  buffer[index++] = 0;
+  return index;
+}
+
+function serializeNumber(buffer: Uint8Array, key: string, value: number, index: number) {
+  const isNegativeZero = Object.is(value, -0);
+
+  const type =
+    !isNegativeZero &&
+    Number.isSafeInteger(value) &&
+    value <= constants.BSON_INT32_MAX &&
+    value >= constants.BSON_INT32_MIN
+      ? constants.BSON_DATA_INT
+      : constants.BSON_DATA_NUMBER;
+
+  buffer[index++] = type;
+
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0x00;
+
+  if (type === constants.BSON_DATA_INT) {
+    index += NumberUtils.setInt32LE(buffer, index, value);
+  } else {
+    index += NumberUtils.setFloat64LE(buffer, index, value);
+  }
+
+  return index;
+}
+
+function serializeBigInt(buffer: Uint8Array, key: string, value: bigint, index: number) {
+  buffer[index++] = constants.BSON_DATA_LONG;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index += numberOfWrittenBytes;
+  buffer[index++] = 0;
+
+  index += NumberUtils.setBigInt64LE(buffer, index, value);
+
+  return index;
+}
+
+function serializeNull(buffer: Uint8Array, key: string, _: unknown, index: number) {
+  // Set long type
+  buffer[index++] = constants.BSON_DATA_NULL;
+
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  return index;
+}
+
+function serializeBoolean(buffer: Uint8Array, key: string, value: boolean, index: number) {
+  // Write the type
+  buffer[index++] = constants.BSON_DATA_BOOLEAN;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  // Encode the boolean value
+  buffer[index++] = value ? 1 : 0;
+  return index;
+}
+
+function serializeDate(buffer: Uint8Array, key: string, value: Date, index: number) {
+  // Write the type
+  buffer[index++] = constants.BSON_DATA_DATE;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+
+  // Write the date
+  const dateInMilis = Long.fromNumber(value.getTime());
+  const lowBits = dateInMilis.getLowBits();
+  const highBits = dateInMilis.getHighBits();
+  // Encode low bits
+  index += NumberUtils.setInt32LE(buffer, index, lowBits);
+  // Encode high bits
+  index += NumberUtils.setInt32LE(buffer, index, highBits);
+  return index;
+}
+
+function serializeRegExp(buffer: Uint8Array, key: string, value: RegExp, index: number) {
+  // Write the type
+  buffer[index++] = constants.BSON_DATA_REGEXP;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  if (value.source && value.source.match(regexp) != null) {
+    throw new BSONError('value ' + value.source + ' must not contain null bytes');
+  }
+  // Adjust the index
+  index = index + ByteUtils.encodeUTF8Into(buffer, value.source, index);
+  // Write zero
+  buffer[index++] = 0x00;
+  // Write the parameters
+  if (value.ignoreCase) buffer[index++] = 0x69; // i
+  if (value.global) buffer[index++] = 0x73; // s
+  if (value.multiline) buffer[index++] = 0x6d; // m
+
+  // Add ending zero
+  buffer[index++] = 0x00;
+  return index;
+}
+
+function serializeBSONRegExp(buffer: Uint8Array, key: string, value: BSONRegExp, index: number) {
+  // Write the type
+  buffer[index++] = constants.BSON_DATA_REGEXP;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+
+  // Check the pattern for 0 bytes
+  if (value.pattern.match(regexp) != null) {
+    // The BSON spec doesn't allow keys with null bytes because keys are
+    // null-terminated.
+    throw new BSONError('pattern ' + value.pattern + ' must not contain null bytes');
+  }
+
+  // Adjust the index
+  index = index + ByteUtils.encodeUTF8Into(buffer, value.pattern, index);
+  // Write zero
+  buffer[index++] = 0x00;
+  // Write the options
+  const sortedOptions = value.options.split('').sort().join('');
+  index = index + ByteUtils.encodeUTF8Into(buffer, sortedOptions, index);
+  // Add ending zero
+  buffer[index++] = 0x00;
+  return index;
+}
+
+function serializeMinMax(buffer: Uint8Array, key: string, value: MinKey | MaxKey, index: number) {
+  // Write the type of either min or max key
+  if (value === null) {
+    buffer[index++] = constants.BSON_DATA_NULL;
+  } else if (value[bsonType] === 'MinKey') {
+    buffer[index++] = constants.BSON_DATA_MIN_KEY;
+  } else {
+    buffer[index++] = constants.BSON_DATA_MAX_KEY;
+  }
+
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  return index;
+}
+
+function serializeObjectId(buffer: Uint8Array, key: string, value: ObjectId, index: number) {
+  // Write the type
+  buffer[index++] = constants.BSON_DATA_OID;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+
+  index += value.serializeInto(buffer, index);
+
+  // Adjust index
+  return index;
+}
+
+function serializeBuffer(buffer: Uint8Array, key: string, value: Uint8Array, index: number) {
+  // Write the type
+  buffer[index++] = constants.BSON_DATA_BINARY;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  // Get size of the buffer (current write point)
+  const size = value.length;
+  // Write the size of the string to buffer
+  index += NumberUtils.setInt32LE(buffer, index, size);
+  // Write the default subtype
+  buffer[index++] = constants.BSON_BINARY_SUBTYPE_DEFAULT;
+  // Copy the content form the binary field to the buffer
+  if (size <= 16) {
+    for (let i = 0; i < size; i++) buffer[index + i] = value[i];
+  } else {
+    buffer.set(value, index);
+  }
+  // Adjust the index
+  index = index + size;
+  return index;
+}
+
+function serializeDecimal128(buffer: Uint8Array, key: string, value: Decimal128, index: number) {
+  buffer[index++] = constants.BSON_DATA_DECIMAL128;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  // Write the data from the value
+  for (let i = 0; i < 16; i++) buffer[index + i] = value.bytes[i];
+  return index + 16;
+}
+
+function serializeLong(buffer: Uint8Array, key: string, value: Long, index: number) {
+  // Write the type
+  buffer[index++] =
+    value[bsonType] === 'Long' ? constants.BSON_DATA_LONG : constants.BSON_DATA_TIMESTAMP;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  // Write the date
+  const lowBits = value.getLowBits();
+  const highBits = value.getHighBits();
+  // Encode low bits
+  index += NumberUtils.setInt32LE(buffer, index, lowBits);
+  // Encode high bits
+  index += NumberUtils.setInt32LE(buffer, index, highBits);
+  return index;
+}
+
+function serializeInt32(buffer: Uint8Array, key: string, value: Int32 | number, index: number) {
+  value = value.valueOf();
+  // Set int type 32 bits or less
+  buffer[index++] = constants.BSON_DATA_INT;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  // Write the int value
+  index += NumberUtils.setInt32LE(buffer, index, value);
+  return index;
+}
+
+function serializeDouble(buffer: Uint8Array, key: string, value: Double, index: number) {
+  // Encode as double
+  buffer[index++] = constants.BSON_DATA_NUMBER;
+
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+
+  // Write float
+  index += NumberUtils.setFloat64LE(buffer, index, value.value);
+
+  return index;
+}
+
+function serializeFunction(buffer: Uint8Array, key: string, value: Function, index: number) {
+  buffer[index++] = constants.BSON_DATA_CODE;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  // Function string
+  const functionString = value.toString();
+
+  // Write the string
+  const size = ByteUtils.encodeUTF8Into(buffer, functionString, index + 4) + 1;
+  // Write the size of the string to buffer
+  NumberUtils.setInt32LE(buffer, index, size);
+  // Update index
+  index = index + 4 + size - 1;
+  // Write zero
+  buffer[index++] = 0;
+  return index;
+}
+
+function serializeBinary(buffer: Uint8Array, key: string, value: Binary, index: number) {
+  // Write the type
+  buffer[index++] = constants.BSON_DATA_BINARY;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  // Extract the buffer
+  const data = value.buffer;
+  // Calculate size
+  let size = value.position;
+  // Add the deprecated 02 type 4 bytes of size to total
+  if (value.sub_type === Binary.SUBTYPE_BYTE_ARRAY) size = size + 4;
+  // Write the size of the string to buffer
+  index += NumberUtils.setInt32LE(buffer, index, size);
+  // Write the subtype to the buffer
+  buffer[index++] = value.sub_type;
+
+  // If we have binary type 2 the 4 first bytes are the size
+  if (value.sub_type === Binary.SUBTYPE_BYTE_ARRAY) {
+    size = size - 4;
+    index += NumberUtils.setInt32LE(buffer, index, size);
+  }
+
+  if (value.sub_type === Binary.SUBTYPE_VECTOR) {
+    validateBinaryVector(value);
+  }
+
+  if (size <= 16) {
+    for (let i = 0; i < size; i++) buffer[index + i] = data[i];
+  } else {
+    buffer.set(data, index);
+  }
+  // Adjust the index
+  index = index + value.position;
+  return index;
+}
+
+function serializeSymbol(buffer: Uint8Array, key: string, value: BSONSymbol, index: number) {
+  // Write the type
+  buffer[index++] = constants.BSON_DATA_SYMBOL;
+  // Number of written bytes
+  const numberOfWrittenBytes = ByteUtils.encodeUTF8Into(buffer, key, index);
+  // Encode the name
+  index = index + numberOfWrittenBytes;
+  buffer[index++] = 0;
+  // Write the string
+  const size = ByteUtils.encodeUTF8Into(buffer, value.value, index + 4) + 1;
+  // Write the size of the string to buffer
+  NumberUtils.setInt32LE(buffer, index, size);
+  // Update index
+  index = index + 4 + size - 1;
+  // Write zero
+  buffer[index++] = 0;
+  return index;
+}
+
+interface SerializationFrame {
+  /** Original object passed to this frame — used for cycle-detection (path.delete). */
+  sourceObject: Document;
+  /** True when serializing a BSON array; affects key format and type byte. */
+  isArray: boolean;
+  /** Buffer offset where this object's 4-byte size field will be written. */
+  objectSizeIndex: number;
+  /** Buffer offset for code-with-scope wrapper size, or null if not applicable. */
+  codeSizeIndex: number | null;
+  /**
+   * Object being iterated. For plain objects this may be the toBSON() result of
+   * sourceObject; for arrays and Maps it equals sourceObject.
+   */
+  iterTarget: Document;
+  /**
+   * Pre-computed Object.keys() of iterTarget for plain objects.
+   * Null for arrays (use keyIndex as numeric index) and Maps (use mapIterator).
+   */
+  keys: string[] | null;
+  /** Next index into keys[] for plain objects, or next array index for arrays. */
+  keyIndex: number;
+  /** Active iterator for Map objects; null for arrays and plain objects. */
+  mapIterator: IterableIterator<[unknown, unknown]> | null;
+  /** The enclosing frame, or null at the root. The stack is a linked list via this field. */
+  prev: SerializationFrame | null;
+  /** Whether to validate keys for this frame's document (may differ from caller, e.g. DBRef uses false). */
+  checkKeys: boolean;
+  /** Whether undefined values are skipped (may differ from caller, e.g. DBRef uses true). */
+  ignoreUndefined: boolean;
+}
+
+function makeFrame(
+  sourceObject: Document,
+  objectSizeIndex: number,
+  codeSizeIndex: number | null,
+  prev: SerializationFrame | null,
+  checkKeys: boolean,
+  ignoreUndefined: boolean
+): SerializationFrame {
+  if (Array.isArray(sourceObject)) {
+    return {
+      sourceObject,
+      isArray: true,
+      objectSizeIndex,
+      codeSizeIndex,
+      iterTarget: sourceObject,
+      keys: null,
+      keyIndex: 0,
+      mapIterator: null,
+      prev,
+      checkKeys,
+      ignoreUndefined
+    };
+  }
+  if (sourceObject instanceof Map || isMap(sourceObject)) {
+    return {
+      sourceObject,
+      isArray: false,
+      objectSizeIndex,
+      codeSizeIndex,
+      iterTarget: sourceObject,
+      keys: null,
+      keyIndex: 0,
+      mapIterator: (sourceObject as Map<unknown, unknown>).entries(),
+      prev,
+      checkKeys,
+      ignoreUndefined
+    };
+  }
+  // Plain object: call toBSON() if defined to obtain the object to iterate.
+  let target: Document = sourceObject;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  if (typeof (target as any)?.toBSON === 'function') {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    target = (target as any).toBSON() as Document;
+    if (target != null && typeof target !== 'object') {
+      throw new BSONError('toBSON function did not return an object');
+    }
+  }
+  return {
+    sourceObject,
+    isArray: false,
+    objectSizeIndex,
+    codeSizeIndex,
+    iterTarget: target,
+    keys: Object.keys(target as object),
+    keyIndex: 0,
+    mapIterator: null,
+    prev,
+    checkKeys,
+    ignoreUndefined
+  };
+}
+
+export function serializeInto(
+  buffer: Uint8Array,
+  object: Document,
+  checkKeys: boolean,
+  startingIndex: number,
+  serializeFunctions: boolean,
+  ignoreUndefined: boolean,
+  path: Set<Document> | null
+): number {
+  if (path == null) {
+    // We are at the root input
+    if (object == null) {
+      // ONLY the root should turn into an empty document
+      // BSON Empty document has a size of 5 (LE)
+      buffer[0] = 0x05;
+      buffer[1] = 0x00;
+      buffer[2] = 0x00;
+      buffer[3] = 0x00;
+      // All documents end with null terminator
+      buffer[4] = 0x00;
+      return 5;
+    }
+
+    if (Array.isArray(object)) {
+      throw new BSONError('serialize does not support an array as the root input');
+    }
+    if (typeof object !== 'object') {
+      throw new BSONError('serialize does not support non-object as the root input');
+    } else if ('_bsontype' in object && typeof object._bsontype === 'string') {
+      throw new BSONError(`BSON types cannot be serialized as a document`);
+    } else if (
+      isDate(object) ||
+      isRegExp(object) ||
+      isUint8Array(object) ||
+      isAnyArrayBuffer(object)
+    ) {
+      throw new BSONError(`date, regexp, typedarray, and arraybuffer cannot be BSON documents`);
+    }
+
+    path = new Set();
+  }
+
+  path.add(object);
+
+  let currentFrame: SerializationFrame | null = makeFrame(
+    object,
+    startingIndex,
+    null,
+    null,
+    checkKeys,
+    ignoreUndefined
+  );
+  let index = startingIndex + 4;
+
+  while (currentFrame !== null) {
+    const frame: SerializationFrame = currentFrame;
+
+    // Advance to the next key-value pair, or finalize the frame if exhausted.
+    let key: string;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let value: any;
+    if (frame.mapIterator !== null) {
+      const next = frame.mapIterator.next();
+      if (next.done) {
+        buffer[index++] = 0x00;
+        NumberUtils.setInt32LE(buffer, frame.objectSizeIndex, index - frame.objectSizeIndex);
+        if (frame.codeSizeIndex !== null) {
+          NumberUtils.setInt32LE(buffer, frame.codeSizeIndex, index - frame.codeSizeIndex);
+        }
+        path.delete(frame.sourceObject);
+        currentFrame = frame.prev;
+        continue;
+      }
+      key = next.value[0] as string;
+      value = next.value[1];
+    } else if (frame.keys !== null) {
+      if (frame.keyIndex >= frame.keys.length) {
+        buffer[index++] = 0x00;
+        NumberUtils.setInt32LE(buffer, frame.objectSizeIndex, index - frame.objectSizeIndex);
+        if (frame.codeSizeIndex !== null) {
+          NumberUtils.setInt32LE(buffer, frame.codeSizeIndex, index - frame.codeSizeIndex);
+        }
+        path.delete(frame.sourceObject);
+        currentFrame = frame.prev;
+        continue;
+      }
+      key = frame.keys[frame.keyIndex++];
+      value = (frame.iterTarget as Record<string, unknown>)[key];
+    } else {
+      // Array: use keyIndex as the numeric index.
+      const arr = frame.iterTarget as unknown[];
+      if (frame.keyIndex >= arr.length) {
+        buffer[index++] = 0x00;
+        NumberUtils.setInt32LE(buffer, frame.objectSizeIndex, index - frame.objectSizeIndex);
+        if (frame.codeSizeIndex !== null) {
+          NumberUtils.setInt32LE(buffer, frame.codeSizeIndex, index - frame.codeSizeIndex);
+        }
+        path.delete(frame.sourceObject);
+        currentFrame = frame.prev;
+        continue;
+      }
+      const i = frame.keyIndex++;
+      key = String(i);
+      value = arr[i];
+    }
+
+    if (typeof value?.toBSON === 'function') {
+      value = value.toBSON();
+    }
+
+    if (!frame.isArray && typeof key === 'string' && !(key[0] === '$' && ignoreKeys.has(key))) {
+      if (regexp.test(key)) {
+        throw new BSONError('key ' + key + ' must not contain null bytes');
+      }
+      if (frame.checkKeys) {
+        if ('$' === key[0]) {
+          throw new BSONError('key ' + key + " must not start with '$'");
+        } else if (key.includes('.')) {
+          throw new BSONError('key ' + key + " must not contain '.'");
+        }
+      }
+    }
+
+    const type = typeof value;
+
+    if (value === undefined) {
+      if (frame.isArray || frame.ignoreUndefined === false) {
+        index = serializeNull(buffer, key, value, index);
+      }
+    } else if (value === null) {
+      index = serializeNull(buffer, key, value, index);
+    } else if (type === 'string') {
+      index = serializeString(buffer, key, value, index);
+    } else if (type === 'number') {
+      index = serializeNumber(buffer, key, value, index);
+    } else if (type === 'bigint') {
+      index = serializeBigInt(buffer, key, value, index);
+    } else if (type === 'boolean') {
+      index = serializeBoolean(buffer, key, value, index);
+    } else if (type === 'object' && value._bsontype == null) {
+      if (value instanceof Date || isDate(value)) {
+        index = serializeDate(buffer, key, value, index);
+      } else if (value instanceof Uint8Array || isUint8Array(value)) {
+        index = serializeBuffer(buffer, key, value, index);
+      } else if (value instanceof RegExp || isRegExp(value)) {
+        index = serializeRegExp(buffer, key, value, index);
+      } else {
+        if (path.has(value)) {
+          throw new BSONError('Cannot convert circular structure to BSON');
+        }
+        const nestedIsArray = Array.isArray(value);
+        buffer[index++] = nestedIsArray ? constants.BSON_DATA_ARRAY : constants.BSON_DATA_OBJECT;
+        index += ByteUtils.encodeUTF8Into(buffer, key, index);
+        buffer[index++] = 0x00;
+        const nestedStartIndex = index;
+        path.add(value);
+        currentFrame = makeFrame(
+          value,
+          nestedStartIndex,
+          null,
+          frame,
+          frame.checkKeys,
+          frame.ignoreUndefined
+        );
+        index += 4;
+      }
+    } else if (type === 'object') {
+      if (value[constants.BSON_VERSION_SYMBOL] !== constants.BSON_MAJOR_VERSION) {
+        throw new BSONVersionError();
+      }
+      const tag = value[bsonType];
+      if (tag === 'ObjectId') {
+        index = serializeObjectId(buffer, key, value, index);
+      } else if (tag === 'Decimal128') {
+        index = serializeDecimal128(buffer, key, value, index);
+      } else if (tag === 'Long' || tag === 'Timestamp') {
+        index = serializeLong(buffer, key, value, index);
+      } else if (tag === 'Double') {
+        index = serializeDouble(buffer, key, value, index);
+      } else if (tag === 'Code') {
+        const codeValue = value as Code;
+        if (codeValue.scope && typeof codeValue.scope === 'object') {
+          buffer[index++] = constants.BSON_DATA_CODE_W_SCOPE;
+          index += ByteUtils.encodeUTF8Into(buffer, key, index);
+          buffer[index++] = 0x00;
+          const codeTotalSizeIndex = index;
+          index += 4;
+          const functionString = codeValue.code;
+          const codeSize = ByteUtils.encodeUTF8Into(buffer, functionString, index + 4) + 1;
+          NumberUtils.setInt32LE(buffer, index, codeSize);
+          buffer[index + 4 + codeSize - 1] = 0;
+          index = index + codeSize + 4;
+          const scope = codeValue.scope;
+          if (path.has(scope)) {
+            throw new BSONError('Cannot convert circular structure to BSON');
+          }
+          path.add(scope);
+          currentFrame = makeFrame(
+            scope,
+            index,
+            codeTotalSizeIndex,
+            frame,
+            frame.checkKeys,
+            frame.ignoreUndefined
+          );
+          index += 4;
+        } else {
+          buffer[index++] = constants.BSON_DATA_CODE;
+          index += ByteUtils.encodeUTF8Into(buffer, key, index);
+          buffer[index++] = 0x00;
+          const functionString = codeValue.code.toString();
+          const size = ByteUtils.encodeUTF8Into(buffer, functionString, index + 4) + 1;
+          NumberUtils.setInt32LE(buffer, index, size);
+          index = index + 4 + size - 1;
+          buffer[index++] = 0;
+        }
+      } else if (tag === 'Binary') {
+        index = serializeBinary(buffer, key, value, index);
+      } else if (tag === 'BSONSymbol') {
+        index = serializeSymbol(buffer, key, value, index);
+      } else if (tag === 'DBRef') {
+        const dbref = value as DBRef;
+        const orderedValues: Document = Object.assign(
+          { $ref: dbref.collection, $id: dbref.oid },
+          dbref.db != null ? { $db: dbref.db } : null,
+          dbref.fields
+        );
+        buffer[index++] = constants.BSON_DATA_OBJECT;
+        index += ByteUtils.encodeUTF8Into(buffer, key, index);
+        buffer[index++] = 0x00;
+        path.add(orderedValues);
+        currentFrame = makeFrame(orderedValues, index, null, frame, false, true);
+        index += 4;
+      } else if (tag === 'BSONRegExp') {
+        index = serializeBSONRegExp(buffer, key, value, index);
+      } else if (tag === 'Int32') {
+        index = serializeInt32(buffer, key, value, index);
+      } else if (tag === 'MinKey' || tag === 'MaxKey') {
+        index = serializeMinMax(buffer, key, value, index);
+      } else if (typeof value._bsontype !== 'undefined') {
+        throw new BSONError(`Unrecognized or invalid _bsontype: ${String(value._bsontype)}`);
+      }
+    } else if (type === 'function' && serializeFunctions) {
+      index = serializeFunction(buffer, key, value, index);
+    }
+  }
+
+  return index;
+}

gateway/node_modules/bson/src/parser/utils.ts

@@ -0,0 +1,69 @@
+const TypedArrayPrototypeGetSymbolToStringTag = (() => {
+  // Type check system lovingly referenced from:
+  // https://github.com/nodejs/node/blob/7450332339ed40481f470df2a3014e2ec355d8d8/lib/internal/util/types.js#L13-L15
+  // eslint-disable-next-line @typescript-eslint/unbound-method -- the intention is to call this method with a bound value
+  const g = Object.getOwnPropertyDescriptor(
+    Object.getPrototypeOf(Uint8Array.prototype),
+    Symbol.toStringTag
+  )!.get!;
+
+  return (value: unknown) => g.call(value);
+})();
+
+export function isUint8Array(value: unknown): value is Uint8Array {
+  return TypedArrayPrototypeGetSymbolToStringTag(value) === 'Uint8Array';
+}
+
+export function isAnyArrayBuffer(value: unknown): value is ArrayBuffer {
+  return (
+    typeof value === 'object' &&
+    value != null &&
+    Symbol.toStringTag in value &&
+    (value[Symbol.toStringTag] === 'ArrayBuffer' ||
+      value[Symbol.toStringTag] === 'SharedArrayBuffer')
+  );
+}
+
+export function isRegExp(regexp: unknown): regexp is RegExp {
+  return regexp instanceof RegExp || Object.prototype.toString.call(regexp) === '[object RegExp]';
+}
+
+export function isMap(value: unknown): value is Map<unknown, unknown> {
+  return (
+    typeof value === 'object' &&
+    value != null &&
+    Symbol.toStringTag in value &&
+    value[Symbol.toStringTag] === 'Map'
+  );
+}
+
+export function isDate(date: unknown): date is Date {
+  return date instanceof Date || Object.prototype.toString.call(date) === '[object Date]';
+}
+
+export type InspectFn = (x: unknown, options?: unknown) => string;
+export function defaultInspect(x: unknown, _options?: unknown): string {
+  return JSON.stringify(x, (k: string, v: unknown) => {
+    if (typeof v === 'bigint') {
+      return { $numberLong: `${v}` };
+    } else if (isMap(v)) {
+      return Object.fromEntries(v);
+    }
+    return v;
+  });
+}
+
+/** @internal */
+type StylizeFunction = (x: string, style: string) => string;
+/** @internal */
+export function getStylizeFunction(options?: unknown): StylizeFunction | undefined {
+  const stylizeExists =
+    options != null &&
+    typeof options === 'object' &&
+    'stylize' in options &&
+    typeof options.stylize === 'function';
+
+  if (stylizeExists) {
+    return options.stylize as StylizeFunction;
+  }
+}

gateway/node_modules/bson/src/regexp.ts

@@ -0,0 +1,114 @@
+import { BSONValue } from './bson_value';
+import { BSONError } from './error';
+import type { EJSONOptions } from './extended_json';
+import { type InspectFn, defaultInspect, getStylizeFunction } from './parser/utils';
+
+function alphabetize(str: string): string {
+  return str.split('').sort().join('');
+}
+
+/** @public */
+export interface BSONRegExpExtendedLegacy {
+  $regex: string | BSONRegExp;
+  $options: string;
+}
+
+/** @public */
+export interface BSONRegExpExtended {
+  $regularExpression: {
+    pattern: string;
+    options: string;
+  };
+}
+
+/**
+ * A class representation of the BSON RegExp type.
+ * @public
+ * @category BSONType
+ */
+export class BSONRegExp extends BSONValue {
+  get _bsontype(): 'BSONRegExp' {
+    return 'BSONRegExp';
+  }
+
+  pattern!: string;
+  options!: string;
+  /**
+   * @param pattern - The regular expression pattern to match
+   * @param options - The regular expression options
+   */
+  constructor(pattern: string, options?: string) {
+    super();
+    this.pattern = pattern;
+    this.options = alphabetize(options ?? '');
+
+    if (this.pattern.indexOf('\x00') !== -1) {
+      throw new BSONError(
+        `BSON Regex patterns cannot contain null bytes, found: ${JSON.stringify(this.pattern)}`
+      );
+    }
+    if (this.options.indexOf('\x00') !== -1) {
+      throw new BSONError(
+        `BSON Regex options cannot contain null bytes, found: ${JSON.stringify(this.options)}`
+      );
+    }
+
+    // Validate options
+    for (let i = 0; i < this.options.length; i++) {
+      if (
+        !(
+          this.options[i] === 'i' ||
+          this.options[i] === 'm' ||
+          this.options[i] === 'x' ||
+          this.options[i] === 'l' ||
+          this.options[i] === 's' ||
+          this.options[i] === 'u'
+        )
+      ) {
+        throw new BSONError(`The regular expression option [${this.options[i]}] is not supported`);
+      }
+    }
+  }
+
+  static parseOptions(options?: string): string {
+    return options ? options.split('').sort().join('') : '';
+  }
+
+  /** @internal */
+  toExtendedJSON(options?: EJSONOptions): BSONRegExpExtendedLegacy | BSONRegExpExtended {
+    options = options || {};
+    if (options.legacy) {
+      return { $regex: this.pattern, $options: this.options };
+    }
+    return { $regularExpression: { pattern: this.pattern, options: this.options } };
+  }
+
+  /** @internal */
+  static fromExtendedJSON(doc: BSONRegExpExtendedLegacy | BSONRegExpExtended): BSONRegExp {
+    if ('$regex' in doc) {
+      if (typeof doc.$regex !== 'string') {
+        // This is for $regex query operators that have extended json values.
+        if (doc.$regex._bsontype === 'BSONRegExp') {
+          return doc as unknown as BSONRegExp;
+        }
+      } else {
+        return new BSONRegExp(doc.$regex, BSONRegExp.parseOptions(doc.$options));
+      }
+    }
+    if ('$regularExpression' in doc) {
+      return new BSONRegExp(
+        doc.$regularExpression.pattern,
+        BSONRegExp.parseOptions(doc.$regularExpression.options)
+      );
+    }
+    throw new BSONError(`Unexpected BSONRegExp EJSON object form: ${JSON.stringify(doc)}`);
+  }
+
+  inspect(depth?: number, options?: unknown, inspect?: InspectFn): string {
+    const stylize = getStylizeFunction(options) ?? (v => v);
+    inspect ??= defaultInspect;
+    const pattern = stylize(inspect(this.pattern), 'regexp');
+    const flags = stylize(inspect(this.options), 'regexp');
+    return `new BSONRegExp(${pattern}, ${flags})`;
+  }
+}