@gravito/dark-matter 1.1.1 → 1.1.2

package/README.md

@@ -35,18 +35,30 @@ const users = await Mongo.collection('users')
 await Mongo.disconnect()
 ```
 
-## Features
-
-- 🚀 **Bun Native** - Optimized for Bun runtime
-- 🎯 **Laravel-style API** - Familiar fluent interface
-- 🔍 **Query Builder** - Type-safe query building
-- 📊 **Aggregation Pipeline** - Fluent aggregation API
-- 🔌 **Multi-connection** - Named connections support
-- 🛡️ **Transactions** - ACID transactions with convenient API
-- 🗑️ **Soft Deletes** - Built-in soft delete support with restore capability
-- 📦 **GridFS** - Handle large file uploads/downloads
-- ⚡ **Change Streams** - Real-time database event listening
-- ✅ **Schema Validation** - Type-safe Schema Builder API for MongoDB validation
+## ✨ Features
+
+- 🚀 **Bun Native Performance**: Optimized for the Bun runtime with zero-copy data handling.
+- 🌌 **Galaxy-Ready Persistence**: Native integration with PlanetCore for universal NoSQL data management.
+- 🎯 **Laravel-style API**: Familiar, fluent interface for MongoDB collections and aggregation pipelines.
+- 🛡️ **Distributed Document State**: ACID transactions and robust multi-connection management across the Galaxy.
+- 🗑️ **Soft Deletes**: Built-in logic for logical record deletion with restoration support.
+- 📦 **GridFS & Streams**: Specialized support for large-scale file storage and real-time change listening.
+
+## 🌌 Role in Galaxy Architecture
+
+In the **Gravito Galaxy Architecture**, Dark Matter acts as the **MongoDB Gravity Core (NoSQL Persistence)**.
+
+- **Document Focus**: Provides an alternative gravity core for Satellites that require schema-less flexibility or massive-scale document storage.
+- **Micro-State Bridge**: Enables real-time reactive logic via MongoDB Change Streams, allowing one Satellite to react instantly to data changes in another.
+- **File Distribution**: Leverages GridFS to provide a distributed file storage layer that works alongside `@gravito/nebula`.
+
+```mermaid
+graph TD
+    S1[Satellite: Analytics] -- "Save" --> DM{Dark Matter}
+    S2[Satellite: Logs] -- "Query" --> DM
+    DM -->|Native Driver| MongoDB[(MongoDB Atlas)]
+    DM -.->|Watch| Realtime[Real-time Events]
+```
 
 ## API Reference
 

package/dist/index.cjs

@@ -1,4 +1,3 @@
-"use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -1146,17 +1145,27 @@ var MongoClient = class {
     if (this.config.socketTimeoutMS) {
       options.socketTimeoutMS = this.config.socketTimeoutMS;
     }
-    this.client = new this.mongodb.MongoClient(uri, options);
     let lastError = null;
     for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+      const client = new this.mongodb.MongoClient(uri, options);
+      this.client = client;
       try {
-        await this.client.connect();
+        await client.connect();
         const dbName = this.config.database ?? "test";
-        this.db = this.client.db(dbName);
+        this.db = client.db(dbName);
         this.connected = true;
         return;
       } catch (error) {
         lastError = error;
+        this.connected = false;
+        this.db = null;
+        try {
+          await client.close();
+        } catch {
+        }
+        if (this.client === client) {
+          this.client = null;
+        }
         if (attempt < config.maxRetries) {
           const delay = config.retryDelayMs * config.backoffMultiplier ** attempt;
           await new Promise((resolve) => setTimeout(resolve, delay));

package/dist/index.d.cts

@@ -1035,7 +1035,7 @@ declare class MongoQueryBuilder<T = Document> implements MongoCollectionContract
     private limitCount;
     private skipCount;
     private softDeleteMode;
-    constructor(nativeCollection: MongoNativeCollection, collectionName: string, session?: unknown | undefined);
+    constructor(nativeCollection: MongoNativeCollection, collectionName: string, session?: unknown);
     /**
      * Adds a basic WHERE clause to the query.
      *

package/dist/index.d.ts

@@ -1035,7 +1035,7 @@ declare class MongoQueryBuilder<T = Document> implements MongoCollectionContract
     private limitCount;
     private skipCount;
     private softDeleteMode;
-    constructor(nativeCollection: MongoNativeCollection, collectionName: string, session?: unknown | undefined);
+    constructor(nativeCollection: MongoNativeCollection, collectionName: string, session?: unknown);
     /**
      * Adds a basic WHERE clause to the query.
      *

package/dist/index.js

@@ -1102,17 +1102,27 @@ var MongoClient = class {
     if (this.config.socketTimeoutMS) {
       options.socketTimeoutMS = this.config.socketTimeoutMS;
     }
-    this.client = new this.mongodb.MongoClient(uri, options);
     let lastError = null;
     for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+      const client = new this.mongodb.MongoClient(uri, options);
+      this.client = client;
       try {
-        await this.client.connect();
+        await client.connect();
         const dbName = this.config.database ?? "test";
-        this.db = this.client.db(dbName);
+        this.db = client.db(dbName);
         this.connected = true;
         return;
       } catch (error) {
         lastError = error;
+        this.connected = false;
+        this.db = null;
+        try {
+          await client.close();
+        } catch {
+        }
+        if (this.client === client) {
+          this.client = null;
+        }
         if (attempt < config.maxRetries) {
           const delay = config.retryDelayMs * config.backoffMultiplier ** attempt;
           await new Promise((resolve) => setTimeout(resolve, delay));

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@gravito/dark-matter",
-  "version": "1.1.1",
+  "sideEffects": false,
+  "version": "1.1.2",
   "description": "MongoDB client for Gravito - Bun native, Laravel-style API",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,6 +15,7 @@
   },
   "scripts": {
     "build": "bun run build.ts",
+    "build:dts": "bun run build.ts --dts-only",
     "test": "bun test --timeout=10000",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
     "test:coverage": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
@@ -26,7 +28,7 @@
     "bench:schema": "MONGODB_URI=mongodb://localhost:27017 bun test benchmarks/schema-validation.bench.ts",
     "bench:transactions": "MONGODB_URI=mongodb://localhost:27017 bun test benchmarks/transactions.bench.ts",
     "bench:change-streams": "MONGODB_URI=mongodb://localhost:27017 bun test benchmarks/change-streams.bench.ts",
-    "test:unit": "bun test tests/ --timeout=10000",
+    "test:unit": "bun test $(find tests -name '*.test.ts' ! -name '*.integration.test.ts' 2>/dev/null | tr '\\n' ' ') --timeout=10000",
     "test:integration": "test $(find tests -name '*.integration.test.ts' 2>/dev/null | wc -l) -gt 0 && find tests -name '*.integration.test.ts' -print0 | xargs -0 bun test --timeout=10000 || echo 'No integration tests found'"
   },
   "files": [