feat(tsmdb): implement TsmDB Mongo-wire-compatible server, add storage/engine modules and reorganize exports

ts/ts_tsmdb/errors/TsmdbErrors.ts

@@ -0,0 +1,181 @@
+/**
+ * Base error class for all TsmDB errors
+ * Mirrors MongoDB driver error hierarchy
+ */
+export class TsmdbError extends Error {
+  public code?: number;
+  public codeName?: string;
+
+  constructor(message: string, code?: number, codeName?: string) {
+    super(message);
+    this.name = 'TsmdbError';
+    this.code = code;
+    this.codeName = codeName;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+
+/**
+ * Error thrown during connection issues
+ */
+export class TsmdbConnectionError extends TsmdbError {
+  constructor(message: string) {
+    super(message);
+    this.name = 'TsmdbConnectionError';
+  }
+}
+
+/**
+ * Error thrown when an operation times out
+ */
+export class TsmdbTimeoutError extends TsmdbError {
+  constructor(message: string) {
+    super(message, 50, 'MaxTimeMSExpired');
+    this.name = 'TsmdbTimeoutError';
+  }
+}
+
+/**
+ * Error thrown during write operations
+ */
+export class TsmdbWriteError extends TsmdbError {
+  public writeErrors?: IWriteError[];
+  public result?: any;
+
+  constructor(message: string, code?: number, writeErrors?: IWriteError[]) {
+    super(message, code);
+    this.name = 'TsmdbWriteError';
+    this.writeErrors = writeErrors;
+  }
+}
+
+/**
+ * Error thrown for duplicate key violations
+ */
+export class TsmdbDuplicateKeyError extends TsmdbWriteError {
+  public keyPattern?: Record<string, 1>;
+  public keyValue?: Record<string, any>;
+
+  constructor(message: string, keyPattern?: Record<string, 1>, keyValue?: Record<string, any>) {
+    super(message, 11000);
+    this.name = 'TsmdbDuplicateKeyError';
+    this.codeName = 'DuplicateKey';
+    this.keyPattern = keyPattern;
+    this.keyValue = keyValue;
+  }
+}
+
+/**
+ * Error thrown for bulk write failures
+ */
+export class TsmdbBulkWriteError extends TsmdbError {
+  public writeErrors: IWriteError[];
+  public result: any;
+
+  constructor(message: string, writeErrors: IWriteError[], result: any) {
+    super(message, 65);
+    this.name = 'TsmdbBulkWriteError';
+    this.writeErrors = writeErrors;
+    this.result = result;
+  }
+}
+
+/**
+ * Error thrown during transaction operations
+ */
+export class TsmdbTransactionError extends TsmdbError {
+  constructor(message: string, code?: number) {
+    super(message, code);
+    this.name = 'TsmdbTransactionError';
+  }
+}
+
+/**
+ * Error thrown when a transaction is aborted due to conflict
+ */
+export class TsmdbWriteConflictError extends TsmdbTransactionError {
+  constructor(message: string = 'Write conflict during transaction') {
+    super(message, 112);
+    this.name = 'TsmdbWriteConflictError';
+    this.codeName = 'WriteConflict';
+  }
+}
+
+/**
+ * Error thrown for invalid arguments
+ */
+export class TsmdbArgumentError extends TsmdbError {
+  constructor(message: string) {
+    super(message);
+    this.name = 'TsmdbArgumentError';
+  }
+}
+
+/**
+ * Error thrown when an operation is not supported
+ */
+export class TsmdbNotSupportedError extends TsmdbError {
+  constructor(message: string) {
+    super(message, 115);
+    this.name = 'TsmdbNotSupportedError';
+    this.codeName = 'CommandNotSupported';
+  }
+}
+
+/**
+ * Error thrown when cursor is exhausted or closed
+ */
+export class TsmdbCursorError extends TsmdbError {
+  constructor(message: string) {
+    super(message);
+    this.name = 'TsmdbCursorError';
+  }
+}
+
+/**
+ * Error thrown when a namespace (database.collection) is invalid
+ */
+export class TsmdbNamespaceError extends TsmdbError {
+  constructor(message: string) {
+    super(message, 73);
+    this.name = 'TsmdbNamespaceError';
+    this.codeName = 'InvalidNamespace';
+  }
+}
+
+/**
+ * Error thrown when an index operation fails
+ */
+export class TsmdbIndexError extends TsmdbError {
+  constructor(message: string, code?: number) {
+    super(message, code || 86);
+    this.name = 'TsmdbIndexError';
+  }
+}
+
+/**
+ * Write error detail for bulk operations
+ */
+export interface IWriteError {
+  index: number;
+  code: number;
+  errmsg: string;
+  op: any;
+}
+
+/**
+ * Convert any error to a TsmdbError
+ */
+export function toTsmdbError(error: any): TsmdbError {
+  if (error instanceof TsmdbError) {
+    return error;
+  }
+  const tsmdbError = new TsmdbError(error.message || String(error));
+  if (error.code) {
+    tsmdbError.code = error.code;
+  }
+  if (error.codeName) {
+    tsmdbError.codeName = error.codeName;
+  }
+  return tsmdbError;
+}