@gravito/core 2.0.6 → 3.0.0

package/dist/PlanetCore.d.ts

@@ -183,6 +183,12 @@ export declare class PlanetCore {
     private deferredProviders;
     private bootedProviders;
     private isShuttingDown;
+    /**
+     * Global shutdown timeout in milliseconds (D-10).
+     * If the entire shutdown sequence does not complete within this limit,
+     * a warning is logged and shutdown is force-completed so the process can exit.
+     */
+    private static readonly GLOBAL_SHUTDOWN_TIMEOUT;
     /**
      * Initialize observability asynchronously (metrics, tracing, Prometheus).
      * This is called from constructor but doesn't block initialization.

package/dist/events/CircuitBreaker.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Event-system CircuitBreaker — standalone copy.
+ *
+ * NOTE: This is intentionally NOT a re-export from @gravito/resilience
+ * to avoid a circular dependency (core <-> resilience):
+ *   @gravito/core -> @gravito/resilience (peerDep of resilience -> core)
+ *
+ * The canonical CB implementation lives in @gravito/resilience.
+ * Keep this file in sync manually if the canonical CB API changes.
+ *
+ * Per D-02 decision recorded in 17-RESEARCH.md.
+ */
 /**
  * Circuit Breaker state enum.
  * @public

package/dist/exceptions/AuthException.d.ts

@@ -0,0 +1,10 @@
+import { type ExceptionOptions } from './GravitoException';
+import { DomainException } from './DomainException';
+/**
+ * Abstract base class for authentication/authorization-related domain errors.
+ * Used by fortify and sentinel packages.
+ * @public
+ */
+export declare abstract class AuthException extends DomainException {
+    constructor(status: number, code: string, options?: ExceptionOptions);
+}

package/dist/exceptions/AuthenticationException.d.ts

@@ -1,8 +1,8 @@
-import { GravitoException } from './GravitoException';
+import { DomainException } from './DomainException';
 /**
  * Exception thrown when authentication fails.
  * @public
  */
-export declare class AuthenticationException extends GravitoException {
+export declare class AuthenticationException extends DomainException {
     constructor(message?: string);
 }

package/dist/exceptions/AuthorizationException.d.ts

@@ -1,8 +1,8 @@
-import { GravitoException } from './GravitoException';
+import { DomainException } from './DomainException';
 /**
  * Exception thrown when user is not authorized to perform an action.
  * @public
  */
-export declare class AuthorizationException extends GravitoException {
+export declare class AuthorizationException extends DomainException {
     constructor(message?: string);
 }

package/dist/exceptions/CacheException.d.ts

@@ -0,0 +1,9 @@
+import { InfrastructureException, type InfrastructureExceptionOptions } from './InfrastructureException';
+/**
+ * Abstract base class for cache/Redis-related infrastructure errors.
+ * All plasma error classes extend this instead of bare Error.
+ * @public
+ */
+export declare abstract class CacheException extends InfrastructureException {
+    constructor(status: number, code: string, options?: InfrastructureExceptionOptions);
+}

package/dist/exceptions/CircularDependencyException.d.ts

@@ -1,9 +1,10 @@
 import type { ServiceKey } from '../Container';
+import { SystemException } from './SystemException';
 /**
  * CircularDependencyException - Thrown when the container detects an infinite loop.
  *
  * @module @gravito/core
  */
-export declare class CircularDependencyException extends Error {
+export declare class CircularDependencyException extends SystemException {
     constructor(key: ServiceKey, stack: ServiceKey[]);
 }

package/dist/exceptions/ConfigurationException.d.ts

@@ -0,0 +1,9 @@
+import { type ExceptionOptions } from './GravitoException';
+import { SystemException } from './SystemException';
+/**
+ * Thrown when the framework encounters an invalid or missing configuration value.
+ * @public
+ */
+export declare class ConfigurationException extends SystemException {
+    constructor(message: string, options?: Omit<ExceptionOptions, 'message'>);
+}

package/dist/exceptions/DatabaseException.d.ts

@@ -0,0 +1,9 @@
+import { InfrastructureException, type InfrastructureExceptionOptions } from './InfrastructureException';
+/**
+ * Abstract base class for database-related infrastructure errors.
+ * All atlas error classes extend this instead of bare Error.
+ * @public
+ */
+export declare abstract class DatabaseException extends InfrastructureException {
+    constructor(status: number, code: string, options?: InfrastructureExceptionOptions);
+}

package/dist/exceptions/DomainException.d.ts

@@ -0,0 +1,9 @@
+import { type ExceptionOptions, GravitoException } from './GravitoException';
+/**
+ * Abstract base class for business logic / domain rule violations.
+ * Extend this for exceptions that represent a caller mistake (invalid input, constraint violation, etc.).
+ * @public
+ */
+export declare abstract class DomainException extends GravitoException {
+    constructor(status: number, code: string, options?: ExceptionOptions);
+}

package/dist/exceptions/InfrastructureException.d.ts

@@ -0,0 +1,17 @@
+import { type ExceptionOptions, GravitoException } from './GravitoException';
+/**
+ * Options for creating an InfrastructureException
+ * @public
+ */
+export interface InfrastructureExceptionOptions extends ExceptionOptions {
+    retryable?: boolean;
+}
+/**
+ * Abstract base class for infrastructure / I/O errors (database, network, filesystem, etc.).
+ * Carries a `retryable` flag that callers can inspect to decide whether the operation should be retried.
+ * @public
+ */
+export declare abstract class InfrastructureException extends GravitoException {
+    readonly retryable: boolean;
+    constructor(status: number, code: string, options?: InfrastructureExceptionOptions);
+}

package/dist/exceptions/QueueException.d.ts

@@ -0,0 +1,9 @@
+import { InfrastructureException, type InfrastructureExceptionOptions } from './InfrastructureException';
+/**
+ * Abstract base class for message queue infrastructure errors.
+ * Used by quasar and flux packages.
+ * @public
+ */
+export declare abstract class QueueException extends InfrastructureException {
+    constructor(status: number, code: string, options?: InfrastructureExceptionOptions);
+}

package/dist/exceptions/StorageException.d.ts

@@ -0,0 +1,9 @@
+import { InfrastructureException, type InfrastructureExceptionOptions } from './InfrastructureException';
+/**
+ * Abstract base class for file/object storage infrastructure errors.
+ * Used by constellation, nebula, nebula-s3, freeze, stasis packages.
+ * @public
+ */
+export declare abstract class StorageException extends InfrastructureException {
+    constructor(status: number, code: string, options?: InfrastructureExceptionOptions);
+}

package/dist/exceptions/StreamException.d.ts

@@ -0,0 +1,9 @@
+import { InfrastructureException, type InfrastructureExceptionOptions } from './InfrastructureException';
+/**
+ * Abstract base class for stream/message processing infrastructure errors.
+ * Used by the stream package (Kafka, RabbitMQ, SQS).
+ * @public
+ */
+export declare abstract class StreamException extends InfrastructureException {
+    constructor(status: number, code: string, options?: InfrastructureExceptionOptions);
+}

package/dist/exceptions/SystemException.d.ts

@@ -0,0 +1,9 @@
+import { type ExceptionOptions, GravitoException } from './GravitoException';
+/**
+ * Abstract base class for internal framework / system-level errors.
+ * Extend this for exceptions that represent an unexpected or unrecoverable framework state.
+ * @public
+ */
+export declare abstract class SystemException extends GravitoException {
+    constructor(status: number, code: string, options?: ExceptionOptions);
+}

package/dist/exceptions/ValidationException.d.ts

@@ -1,4 +1,4 @@
-import { GravitoException } from './GravitoException';
+import { DomainException } from './DomainException';
 /**
  * Structure of a validation error
  * @public
@@ -12,7 +12,7 @@ export interface ValidationError {
  * Exception thrown when data validation fails.
  * @public
  */
-export declare class ValidationException extends GravitoException {
+export declare class ValidationException extends DomainException {
     readonly errors: ValidationError[];
     redirectTo?: string;
     input?: unknown;

package/dist/exceptions/index.d.ts

@@ -1,7 +1,17 @@
 export * from './AuthenticationException';
+export * from './AuthException';
 export * from './AuthorizationException';
+export * from './CacheException';
 export * from './CircularDependencyException';
+export * from './ConfigurationException';
+export * from './DatabaseException';
+export * from './DomainException';
 export * from './GravitoException';
 export * from './HttpException';
+export * from './InfrastructureException';
 export * from './ModelNotFoundException';
+export * from './QueueException';
+export * from './StorageException';
+export * from './StreamException';
+export * from './SystemException';
 export * from './ValidationException';

package/dist/index.browser.js

@@ -149,7 +149,7 @@ var randomBytes = randomBytesFn;
 // package.json
 var package_default = {
   name: "@gravito/core",
-  version: "2.0.6",
+  version: "3.0.0",
   description: "",
   module: "./dist/index.js",
   main: "./dist/index.js",
@@ -3609,11 +3609,50 @@ class ConfigManager {
     }
   }
 }
+// src/exceptions/GravitoException.ts
+class GravitoException extends Error {
+  status;
+  code;
+  i18nKey;
+  i18nParams;
+  constructor(status, code, options2 = {}) {
+    super(options2.message);
+    this.name = "GravitoException";
+    this.status = status;
+    this.cause = options2.cause;
+    this.code = code;
+    if (options2.i18nKey) {
+      this.i18nKey = options2.i18nKey;
+    }
+    if (options2.i18nParams) {
+      this.i18nParams = options2.i18nParams;
+    }
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  getLocalizedMessage(t) {
+    if (this.i18nKey) {
+      return t(this.i18nKey, this.i18nParams);
+    }
+    return this.message;
+  }
+}
+
+// src/exceptions/SystemException.ts
+class SystemException extends GravitoException {
+  constructor(status, code, options2 = {}) {
+    super(status, code, options2);
+    this.name = "SystemException";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+
 // src/exceptions/CircularDependencyException.ts
-class CircularDependencyException extends Error {
+class CircularDependencyException extends SystemException {
   constructor(key, stack) {
     const path2 = [...stack, key].map(String).join(" -> ");
-    super(`Circular dependency detected: ${path2}`);
+    super(500, "system.circular_dependency", {
+      message: `Circular dependency detected: ${path2}`
+    });
     this.name = "CircularDependencyException";
   }
 }
@@ -4107,33 +4146,6 @@ function detectRequestScopeLeaks(context) {
   };
 }
 
-// src/exceptions/GravitoException.ts
-class GravitoException extends Error {
-  status;
-  code;
-  i18nKey;
-  i18nParams;
-  constructor(status, code, options2 = {}) {
-    super(options2.message);
-    this.name = "GravitoException";
-    this.status = status;
-    this.cause = options2.cause;
-    this.code = code;
-    if (options2.i18nKey) {
-      this.i18nKey = options2.i18nKey;
-    }
-    if (options2.i18nParams) {
-      this.i18nParams = options2.i18nParams;
-    }
-  }
-  getLocalizedMessage(t) {
-    if (this.i18nKey) {
-      return t(this.i18nKey, this.i18nParams);
-    }
-    return this.message;
-  }
-}
-
 // src/exceptions/HttpException.ts
 class HttpException extends GravitoException {
   constructor(status, options2 = {}) {
@@ -4142,8 +4154,17 @@ class HttpException extends GravitoException {
   }
 }
 
+// src/exceptions/DomainException.ts
+class DomainException extends GravitoException {
+  constructor(status, code, options2 = {}) {
+    super(status, code, options2);
+    this.name = "DomainException";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+
 // src/exceptions/ValidationException.ts
-class ValidationException extends GravitoException {
+class ValidationException extends DomainException {
   errors;
   redirectTo;
   input;
@@ -4152,6 +4173,7 @@ class ValidationException extends GravitoException {
       message,
       i18nKey: "errors.validation.failed"
     });
+    this.name = "ValidationException";
     this.errors = errors;
   }
   withRedirect(url) {
@@ -9030,4 +9052,4 @@ export {
   Arr
 };
 
-//# debugId=1C1545AE2FF7EA4564756E2164756E21
+//# debugId=004674489562A73F64756E2164756E21