@gravito/dark-matter 1.1.2 → 2.0.0

package/dist/index.cjs

@@ -29,6 +29,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DarkMatterError: () => DarkMatterError,
+  DarkMatterErrorCodes: () => DarkMatterErrorCodes,
   Mongo: () => Mongo,
   MongoAggregateBuilder: () => MongoAggregateBuilder,
   MongoClient: () => MongoClient,
@@ -41,6 +43,25 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/errors/DarkMatterError.ts
+var import_core = require("@gravito/core");
+var DarkMatterError = class extends import_core.InfrastructureException {
+  constructor(status, code, options = {}) {
+    super(status, code, options);
+    this.name = "DarkMatterError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/errors/codes.ts
+var DarkMatterErrorCodes = {
+  CONNECTION_FAILED: "dark_matter.connection_failed",
+  NOT_CONNECTED: "dark_matter.not_connected",
+  CONNECTION_NOT_CONFIGURED: "dark_matter.connection_not_configured",
+  GRIDFS_NOT_INITIALIZED: "dark_matter.gridfs_not_initialized",
+  OPERATION_FAILED: "dark_matter.operation_failed"
+};
+
 // src/MongoQueryBuilder.ts
 var MongoQueryBuilder = class _MongoQueryBuilder {
   constructor(nativeCollection, collectionName, session) {
@@ -1172,9 +1193,11 @@ var MongoClient = class {
         }
       }
     }
-    throw new Error(
-      `Failed to connect to MongoDB after ${config.maxRetries + 1} attempts: ${lastError?.message}`
-    );
+    throw new DarkMatterError(503, DarkMatterErrorCodes.CONNECTION_FAILED, {
+      message: `Failed to connect to MongoDB after ${config.maxRetries + 1} attempts: ${lastError?.message}`,
+      cause: lastError,
+      retryable: true
+    });
   }
   /**
    * Closes the connection to the MongoDB server.
@@ -1364,20 +1387,24 @@ var MongoClient = class {
       const mongodb = await import("mongodb");
       return mongodb;
     } catch {
-      throw new Error(
-        'MongoDB client requires the "mongodb" package. Please install it: bun add mongodb'
-      );
+      throw new DarkMatterError(500, DarkMatterErrorCodes.CONNECTION_FAILED, {
+        message: 'MongoDB client requires the "mongodb" package. Please install it: bun add mongodb'
+      });
     }
   }
   getClient() {
     if (!this.client) {
-      throw new Error("MongoDB client not connected. Call connect() first.");
+      throw new DarkMatterError(503, DarkMatterErrorCodes.NOT_CONNECTED, {
+        message: "MongoDB client not connected. Call connect() first."
+      });
     }
     return this.client;
   }
   getDatabase() {
     if (!this.db) {
-      throw new Error("MongoDB client not connected. Call connect() first.");
+      throw new DarkMatterError(503, DarkMatterErrorCodes.NOT_CONNECTED, {
+        message: "MongoDB client not connected. Call connect() first."
+      });
     }
     return this.db;
   }
@@ -1500,7 +1527,9 @@ var MongoManager = class {
     if (!this.connections.has(connectionName)) {
       const config = this.configs.get(connectionName);
       if (!config) {
-        throw new Error(`MongoDB connection "${connectionName}" not configured`);
+        throw new DarkMatterError(500, DarkMatterErrorCodes.CONNECTION_NOT_CONFIGURED, {
+          message: `MongoDB connection "${connectionName}" not configured`
+        });
       }
       this.connections.set(connectionName, new MongoClient(config));
     }
@@ -2004,7 +2033,10 @@ var MongoGridFS = class {
   }
   async ensureBucket() {
     if (!this.bucket) {
-      throw new Error("GridFS bucket not initialized. Please wait a moment after creation.");
+      throw new DarkMatterError(503, DarkMatterErrorCodes.GRIDFS_NOT_INITIALIZED, {
+        message: "GridFS bucket not initialized. Please wait a moment after creation.",
+        retryable: true
+      });
     }
   }
 };
@@ -2314,6 +2346,8 @@ function schema() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DarkMatterError,
+  DarkMatterErrorCodes,
   Mongo,
   MongoAggregateBuilder,
   MongoClient,

package/dist/index.d.cts

@@ -1,3 +1,27 @@
+import { InfrastructureException, InfrastructureExceptionOptions } from '@gravito/core';
+
+/**
+ * Error codes for the dark-matter package.
+ * @public
+ */
+declare const DarkMatterErrorCodes: {
+    readonly CONNECTION_FAILED: "dark_matter.connection_failed";
+    readonly NOT_CONNECTED: "dark_matter.not_connected";
+    readonly CONNECTION_NOT_CONFIGURED: "dark_matter.connection_not_configured";
+    readonly GRIDFS_NOT_INITIALIZED: "dark_matter.gridfs_not_initialized";
+    readonly OPERATION_FAILED: "dark_matter.operation_failed";
+};
+type DarkMatterErrorCode = (typeof DarkMatterErrorCodes)[keyof typeof DarkMatterErrorCodes];
+
+/**
+ * Concrete error class for the dark-matter (MongoDB) package.
+ * Extends InfrastructureException to participate in the GravitoException hierarchy.
+ * @public
+ */
+declare class DarkMatterError extends InfrastructureException {
+    constructor(status: number, code: DarkMatterErrorCode, options?: InfrastructureExceptionOptions);
+}
+
 /**
  * @gravito/dark-matter - Type Definitions
  */
@@ -1953,4 +1977,4 @@ declare class MongoSchemaBuilder {
  */
 declare function schema(): MongoSchemaBuilder;
 
-export { type BulkWriteOperation, type BulkWriteResult, type DeleteResult, type Document$1 as Document, type FilterDocument, type FilterOperator, type GridFSFile, type GridFSUploadOptions, type GridFSUploadProgress, type InsertManyResult, type InsertResult, type LookupOptions, Mongo, MongoAggregateBuilder, type MongoAggregateContract, MongoClient, type MongoClientContract, type MongoCollectionContract, type MongoConfig, type MongoDatabaseContract, MongoGridFS, MongoManager, type MongoManagerConfig, MongoPoolMonitor, MongoQueryBuilder, MongoSchemaBuilder, type MongoSession, type PipelineStage, type PoolMetrics, type Projection, type RetryConfig, type SchemaValidationOptions, type SoftDeletableDocument, type SortDirection, type SortSpec, type TransactionOptions, type UpdateDocument, type UpdateResult, schema };
+export { type BulkWriteOperation, type BulkWriteResult, DarkMatterError, type DarkMatterErrorCode, DarkMatterErrorCodes, type DeleteResult, type Document$1 as Document, type FilterDocument, type FilterOperator, type GridFSFile, type GridFSUploadOptions, type GridFSUploadProgress, type InsertManyResult, type InsertResult, type LookupOptions, Mongo, MongoAggregateBuilder, type MongoAggregateContract, MongoClient, type MongoClientContract, type MongoCollectionContract, type MongoConfig, type MongoDatabaseContract, MongoGridFS, MongoManager, type MongoManagerConfig, MongoPoolMonitor, MongoQueryBuilder, MongoSchemaBuilder, type MongoSession, type PipelineStage, type PoolMetrics, type Projection, type RetryConfig, type SchemaValidationOptions, type SoftDeletableDocument, type SortDirection, type SortSpec, type TransactionOptions, type UpdateDocument, type UpdateResult, schema };

package/dist/index.d.ts

@@ -1,3 +1,27 @@
+import { InfrastructureException, InfrastructureExceptionOptions } from '@gravito/core';
+
+/**
+ * Error codes for the dark-matter package.
+ * @public
+ */
+declare const DarkMatterErrorCodes: {
+    readonly CONNECTION_FAILED: "dark_matter.connection_failed";
+    readonly NOT_CONNECTED: "dark_matter.not_connected";
+    readonly CONNECTION_NOT_CONFIGURED: "dark_matter.connection_not_configured";
+    readonly GRIDFS_NOT_INITIALIZED: "dark_matter.gridfs_not_initialized";
+    readonly OPERATION_FAILED: "dark_matter.operation_failed";
+};
+type DarkMatterErrorCode = (typeof DarkMatterErrorCodes)[keyof typeof DarkMatterErrorCodes];
+
+/**
+ * Concrete error class for the dark-matter (MongoDB) package.
+ * Extends InfrastructureException to participate in the GravitoException hierarchy.
+ * @public
+ */
+declare class DarkMatterError extends InfrastructureException {
+    constructor(status: number, code: DarkMatterErrorCode, options?: InfrastructureExceptionOptions);
+}
+
 /**
  * @gravito/dark-matter - Type Definitions
  */
@@ -1953,4 +1977,4 @@ declare class MongoSchemaBuilder {
  */
 declare function schema(): MongoSchemaBuilder;
 
-export { type BulkWriteOperation, type BulkWriteResult, type DeleteResult, type Document$1 as Document, type FilterDocument, type FilterOperator, type GridFSFile, type GridFSUploadOptions, type GridFSUploadProgress, type InsertManyResult, type InsertResult, type LookupOptions, Mongo, MongoAggregateBuilder, type MongoAggregateContract, MongoClient, type MongoClientContract, type MongoCollectionContract, type MongoConfig, type MongoDatabaseContract, MongoGridFS, MongoManager, type MongoManagerConfig, MongoPoolMonitor, MongoQueryBuilder, MongoSchemaBuilder, type MongoSession, type PipelineStage, type PoolMetrics, type Projection, type RetryConfig, type SchemaValidationOptions, type SoftDeletableDocument, type SortDirection, type SortSpec, type TransactionOptions, type UpdateDocument, type UpdateResult, schema };
+export { type BulkWriteOperation, type BulkWriteResult, DarkMatterError, type DarkMatterErrorCode, DarkMatterErrorCodes, type DeleteResult, type Document$1 as Document, type FilterDocument, type FilterOperator, type GridFSFile, type GridFSUploadOptions, type GridFSUploadProgress, type InsertManyResult, type InsertResult, type LookupOptions, Mongo, MongoAggregateBuilder, type MongoAggregateContract, MongoClient, type MongoClientContract, type MongoCollectionContract, type MongoConfig, type MongoDatabaseContract, MongoGridFS, MongoManager, type MongoManagerConfig, MongoPoolMonitor, MongoQueryBuilder, MongoSchemaBuilder, type MongoSession, type PipelineStage, type PoolMetrics, type Projection, type RetryConfig, type SchemaValidationOptions, type SoftDeletableDocument, type SortDirection, type SortSpec, type TransactionOptions, type UpdateDocument, type UpdateResult, schema };

package/dist/index.js

@@ -1,3 +1,22 @@
+// src/errors/DarkMatterError.ts
+import { InfrastructureException } from "@gravito/core";
+var DarkMatterError = class extends InfrastructureException {
+  constructor(status, code, options = {}) {
+    super(status, code, options);
+    this.name = "DarkMatterError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/errors/codes.ts
+var DarkMatterErrorCodes = {
+  CONNECTION_FAILED: "dark_matter.connection_failed",
+  NOT_CONNECTED: "dark_matter.not_connected",
+  CONNECTION_NOT_CONFIGURED: "dark_matter.connection_not_configured",
+  GRIDFS_NOT_INITIALIZED: "dark_matter.gridfs_not_initialized",
+  OPERATION_FAILED: "dark_matter.operation_failed"
+};
+
 // src/MongoQueryBuilder.ts
 var MongoQueryBuilder = class _MongoQueryBuilder {
   constructor(nativeCollection, collectionName, session) {
@@ -1129,9 +1148,11 @@ var MongoClient = class {
         }
       }
     }
-    throw new Error(
-      `Failed to connect to MongoDB after ${config.maxRetries + 1} attempts: ${lastError?.message}`
-    );
+    throw new DarkMatterError(503, DarkMatterErrorCodes.CONNECTION_FAILED, {
+      message: `Failed to connect to MongoDB after ${config.maxRetries + 1} attempts: ${lastError?.message}`,
+      cause: lastError,
+      retryable: true
+    });
   }
   /**
    * Closes the connection to the MongoDB server.
@@ -1321,20 +1342,24 @@ var MongoClient = class {
       const mongodb = await import("mongodb");
       return mongodb;
     } catch {
-      throw new Error(
-        'MongoDB client requires the "mongodb" package. Please install it: bun add mongodb'
-      );
+      throw new DarkMatterError(500, DarkMatterErrorCodes.CONNECTION_FAILED, {
+        message: 'MongoDB client requires the "mongodb" package. Please install it: bun add mongodb'
+      });
     }
   }
   getClient() {
     if (!this.client) {
-      throw new Error("MongoDB client not connected. Call connect() first.");
+      throw new DarkMatterError(503, DarkMatterErrorCodes.NOT_CONNECTED, {
+        message: "MongoDB client not connected. Call connect() first."
+      });
     }
     return this.client;
   }
   getDatabase() {
     if (!this.db) {
-      throw new Error("MongoDB client not connected. Call connect() first.");
+      throw new DarkMatterError(503, DarkMatterErrorCodes.NOT_CONNECTED, {
+        message: "MongoDB client not connected. Call connect() first."
+      });
     }
     return this.db;
   }
@@ -1457,7 +1482,9 @@ var MongoManager = class {
     if (!this.connections.has(connectionName)) {
       const config = this.configs.get(connectionName);
       if (!config) {
-        throw new Error(`MongoDB connection "${connectionName}" not configured`);
+        throw new DarkMatterError(500, DarkMatterErrorCodes.CONNECTION_NOT_CONFIGURED, {
+          message: `MongoDB connection "${connectionName}" not configured`
+        });
       }
       this.connections.set(connectionName, new MongoClient(config));
     }
@@ -1961,7 +1988,10 @@ var MongoGridFS = class {
   }
   async ensureBucket() {
     if (!this.bucket) {
-      throw new Error("GridFS bucket not initialized. Please wait a moment after creation.");
+      throw new DarkMatterError(503, DarkMatterErrorCodes.GRIDFS_NOT_INITIALIZED, {
+        message: "GridFS bucket not initialized. Please wait a moment after creation.",
+        retryable: true
+      });
     }
   }
 };
@@ -2270,6 +2300,8 @@ function schema() {
   return new MongoSchemaBuilder();
 }
 export {
+  DarkMatterError,
+  DarkMatterErrorCodes,
   Mongo,
   MongoAggregateBuilder,
   MongoClient,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gravito/dark-matter",
   "sideEffects": false,
-  "version": "1.1.2",
+  "version": "2.0.0",
   "description": "MongoDB client for Gravito - Bun native, Laravel-style API",
   "type": "module",
   "main": "./dist/index.js",