@gravito/echo 3.1.1 → 4.0.0

package/dist/core/src/events/observability/metrics-types.d.ts

@@ -1,16 +0,0 @@
-/**
- * Minimal metric types for event observability.
- * Avoids importing @gravito/monitor from core to prevent circular dependency.
- * Runtime implementations are provided by @gravito/monitor MetricsRegistry.
- *
- * @internal
- */
-export interface EventMetricCounter {
-    inc(labels: Record<string, string>): void;
-}
-export interface EventMetricGauge {
-    set(value: number, labels: Record<string, string>): void;
-}
-export interface EventMetricHistogram {
-    observe(value: number, labels: Record<string, string>): void;
-}

package/dist/core/src/events/types.d.ts

@@ -1,134 +0,0 @@
-import type { ActionCallback } from '../HookManager';
-import type { BackpressureConfig } from './BackpressureManager';
-import type { EventOptions } from './EventOptions';
-/**
- * Event task for priority queue processing.
- * @internal
- */
-export interface EventTask {
-    /**
-     * Unique identifier for this event task.
-     */
-    id: string;
-    /**
-     * Event hook name.
-     */
-    hook: string;
-    /**
-     * Event payload/arguments.
-     */
-    args: unknown;
-    /**
-     * Event options.
-     */
-    options: EventOptions;
-    /**
-     * Callbacks to execute for this event.
-     */
-    callbacks: ActionCallback[];
-    /**
-     * Timestamp when the event was created.
-     */
-    createdAt: number;
-    /**
-     * Timestamp when the event was enqueued (added to the queue).
-     * Used for priority escalation calculations.
-     * @internal
-     */
-    enqueuedAt: number;
-    /**
-     * Partition key for ordering (if applicable).
-     */
-    partitionKey?: string;
-    /**
-     * Number of retry attempts made.
-     * @internal
-     */
-    retryCount?: number;
-    /**
-     * Timestamp when the event first failed.
-     * @internal
-     */
-    firstFailedAt?: number;
-    /**
-     * Last error encountered.
-     * @internal
-     */
-    lastError?: Error;
-}
-/**
- * Strategy for handling backpressure when the queue is full.
- */
-export type BackpressureStrategy = 'reject' | 'drop-oldest' | 'drop-newest' | 'ignore';
-/**
- * Configuration for the event priority queue.
- */
-export interface EventQueueConfig {
-    /**
-     * Maximum number of pending events in the queue.
-     * If exceeded, the backpressure strategy is applied.
-     * @default undefined (unbounded)
-     */
-    maxSize?: number;
-    /**
-     * Strategy to use when the queue is full.
-     * - 'reject': Throw an error (default)
-     * - 'drop-oldest': Drop the oldest lowest-priority event
-     * - 'drop-newest': Drop the incoming event
-     * - 'ignore': Silently drop the incoming event
-     * @default 'reject'
-     */
-    strategy?: BackpressureStrategy;
-    /**
-     * Advanced backpressure management configuration.
-     * When enabled, provides state-based flow control with multi-strategy support.
-     * If not provided, falls back to simple strategy-based backpressure.
-     * @default undefined (disabled, uses simple strategy)
-     */
-    backpressure?: BackpressureConfig;
-}
-/**
- * Multi-priority queue depth snapshot (FS-103)
- * Represents the current queue depth for each priority level.
- * @internal
- */
-export interface MultiPriorityQueueDepth {
-    /** Queue depth for CRITICAL priority events */
-    critical: number;
-    /** Queue depth for HIGH priority events */
-    high: number;
-    /** Queue depth for NORMAL priority events */
-    normal: number;
-    /** Queue depth for LOW priority events */
-    low: number;
-    /** Total queue depth across all priorities */
-    total: number;
-}
-/**
- * Window adjustment record for backpressure feedback (FS-103)
- * Records when and why the aggregation window was adjusted.
- * @internal
- */
-export interface WindowAdjustment {
-    /** Timestamp of the adjustment */
-    timestamp: number;
-    /** Previous window size in milliseconds */
-    from: number;
-    /** New window size in milliseconds */
-    to: number;
-    /** Backpressure state that triggered the adjustment */
-    reason: string;
-}
-/**
- * Dead letter queue routing decision (FS-103)
- * Determines whether an event should be routed to the DLQ.
- * @internal
- */
-export interface DeadLetterDecision {
-    /** Whether the event should be routed to DLQ */
-    shouldRoute: boolean;
-    /** Reason for the decision (if applicable) */
-    reason?: string;
-    /** Suggested retry strategy */
-    retryStrategy?: 'immediate' | 'delayed' | 'dlq-only';
-}

package/dist/core/src/exceptions/AuthenticationException.d.ts

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

package/dist/core/src/exceptions/AuthorizationException.d.ts

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

package/dist/core/src/exceptions/CircularDependencyException.d.ts

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

package/dist/core/src/exceptions/GravitoException.d.ts

@@ -1,23 +0,0 @@
-import type { ContentfulStatusCode } from '../http/types';
-/**
- * Options for creating a GravitoException
- * @public
- */
-export interface ExceptionOptions {
-    message?: string;
-    cause?: unknown;
-    i18nKey?: string;
-    i18nParams?: Record<string, string | number>;
-}
-/**
- * Base exception class for consistent error handling.
- * @public
- */
-export declare abstract class GravitoException extends Error {
-    readonly status: ContentfulStatusCode;
-    readonly code: string;
-    readonly i18nKey?: string;
-    readonly i18nParams?: Record<string, string | number>;
-    constructor(status: number, code: string, options?: ExceptionOptions);
-    getLocalizedMessage(t: (key: string, params?: Record<string, string | number>) => string): string;
-}

package/dist/core/src/exceptions/HttpException.d.ts

@@ -1,9 +0,0 @@
-import type { ContentfulStatusCode } from '../http/types';
-import { type ExceptionOptions, GravitoException } from './GravitoException';
-/**
- * Generic HTTP Exception
- * @public
- */
-export declare class HttpException extends GravitoException {
-    constructor(status: ContentfulStatusCode, options?: ExceptionOptions);
-}

package/dist/core/src/exceptions/ModelNotFoundException.d.ts

@@ -1,10 +0,0 @@
-import { GravitoException } from './GravitoException';
-/**
- * Exception thrown when a database model is not found.
- * @public
- */
-export declare class ModelNotFoundException extends GravitoException {
-    readonly model: string;
-    readonly id?: string | number;
-    constructor(model: string, id?: string | number);
-}

package/dist/core/src/exceptions/ValidationException.d.ts

@@ -1,22 +0,0 @@
-import { GravitoException } from './GravitoException';
-/**
- * Structure of a validation error
- * @public
- */
-export interface ValidationError {
-    field: string;
-    message: string;
-    code?: string;
-}
-/**
- * Exception thrown when data validation fails.
- * @public
- */
-export declare class ValidationException extends GravitoException {
-    readonly errors: ValidationError[];
-    redirectTo?: string;
-    input?: unknown;
-    constructor(errors: ValidationError[], message?: string);
-    withRedirect(url: string): this;
-    withInput(input: unknown): this;
-}

package/dist/core/src/exceptions/index.d.ts

@@ -1,7 +0,0 @@
-export * from './AuthenticationException';
-export * from './AuthorizationException';
-export * from './CircularDependencyException';
-export * from './GravitoException';
-export * from './HttpException';
-export * from './ModelNotFoundException';
-export * from './ValidationException';

package/dist/core/src/health/HealthProvider.d.ts

@@ -1,67 +0,0 @@
-/**
- * @fileoverview HealthProvider - Cloud-native health checks
- *
- * Provides liveness and readiness probes for Kubernetes and cloud deployments
- *
- * @module @gravito/core/health
- * @since 2.2.0
- */
-import type { Container } from '../Container';
-import type { PlanetCore } from '../PlanetCore';
-import { ServiceProvider } from '../ServiceProvider';
-/**
- * Health check result
- * @public
- */
-export interface HealthCheckResult {
-    /** Health status */
-    status: 'healthy' | 'unhealthy';
-    /** Optional message */
-    message?: string;
-}
-/**
- * Health check function interface
- * @public
- */
-export interface HealthCheck {
-    /** Unique name for this check */
-    name: string;
-    /** Check function that returns health status */
-    check(): Promise<HealthCheckResult>;
-}
-/**
- * HealthProvider - Provides /health/liveness and /health/readiness endpoints
- *
- * - Liveness: Always returns 200 OK (just checks if server is running)
- * - Readiness: Returns 200 if all checks are healthy, 503 otherwise
- *
- * @public
- */
-export declare class HealthProvider extends ServiceProvider {
-    private checks;
-    register(container: Container): void;
-    /**
-     * Register a health check
-     *
-     * @param check - The health check to register
-     *
-     * @example
-     * ```typescript
-     * const health = core.container.make<HealthProvider>('health')
-     * health.registerCheck({
-     *   name: 'database',
-     *   check: async () => {
-     *     try {
-     *       await db.ping()
-     *       return { status: 'healthy' }
-     *     } catch {
-     *       return { status: 'unhealthy', message: 'DB unreachable' }
-     *     }
-     *   }
-     * })
-     * ```
-     */
-    registerCheck(check: HealthCheck): void;
-    boot(core: PlanetCore): void;
-}
-export default HealthProvider;

package/dist/core/src/helpers/Arr.d.ts

@@ -1,19 +0,0 @@
-import { type DataPath } from './data';
-/**
- * Array and Collection Helpers.
- * Provides utility methods for array manipulation and deep object access.
- * @public
- */
-export declare const Arr: {
-    readonly get: <TDefault = undefined>(target: unknown, path: DataPath | null | undefined, defaultValue?: TDefault) => unknown | TDefault;
-    readonly has: (target: unknown, path: DataPath | null | undefined) => boolean;
-    readonly set: (target: unknown, path: DataPath, value: unknown, overwrite?: boolean) => unknown;
-    readonly wrap: <T>(value: T | T[] | null | undefined) => T[];
-    readonly first: <T>(items: readonly T[], callback?: (value: T, index: number) => boolean) => T | undefined;
-    readonly last: <T>(items: readonly T[], callback?: (value: T, index: number) => boolean) => T | undefined;
-    readonly only: <T extends Record<string, unknown>>(target: T, keys: readonly string[]) => Partial<T>;
-    readonly except: <T extends Record<string, unknown>>(target: T, keys: readonly string[]) => Partial<T>;
-    readonly flatten: (items: unknown[], depth?: number) => unknown[];
-    readonly pluck: <TItem extends Record<string, unknown>>(items: readonly TItem[], valuePath: DataPath, keyPath?: DataPath) => unknown[] | Record<string, unknown>;
-    readonly where: <T>(items: readonly T[], callback: (value: T, index: number) => boolean) => T[];
-};

package/dist/core/src/helpers/Str.d.ts

@@ -1,23 +0,0 @@
-type StartsEndsNeedle = string | readonly string[];
-/**
- * String Helper Utilities.
- * Provides methods for string manipulation, case conversion, and UUID generation.
- * @public
- */
-export declare const Str: {
-    readonly lower: (value: string) => string;
-    readonly upper: (value: string) => string;
-    readonly startsWith: (haystack: string, needles: StartsEndsNeedle) => boolean;
-    readonly endsWith: (haystack: string, needles: StartsEndsNeedle) => boolean;
-    readonly contains: (haystack: string, needles: StartsEndsNeedle) => boolean;
-    readonly snake: (value: string) => string;
-    readonly kebab: (value: string) => string;
-    readonly studly: (value: string) => string;
-    readonly camel: (value: string) => string;
-    readonly title: (value: string) => string;
-    readonly limit: (value: string, limit: number, end?: string) => string;
-    readonly slug: (value: string, separator?: string) => string;
-    readonly uuid: () => string;
-    readonly random: (length?: number) => string;
-};
-export {};

package/dist/core/src/helpers/data.d.ts

@@ -1,25 +0,0 @@
-/**
- * Path segment (key) in a data structure.
- * @public
- */
-export type PathSegment = string | number;
-/**
- * Path to a value (dot notation or array of segments).
- * @public
- */
-export type DataPath = string | readonly PathSegment[];
-/**
- * Retrieve a value from a deep object using dot notation.
- * @public
- */
-export declare function dataGet<TDefault = undefined>(target: unknown, path: DataPath | null | undefined, defaultValue?: TDefault): unknown | TDefault;
-/**
- * Check if a key exists in a deep object using dot notation.
- * @public
- */
-export declare function dataHas(target: unknown, path: DataPath | null | undefined): boolean;
-/**
- * Set a value in a deep object using dot notation.
- * @public
- */
-export declare function dataSet(target: unknown, path: DataPath, setValue: unknown, overwrite?: boolean): unknown;

package/dist/core/src/helpers/errors.d.ts

@@ -1,34 +0,0 @@
-import type { GravitoContext } from '../http/types';
-/**
- * Interface for displaying validation errors in views.
- * @public
- */
-export interface ErrorBag {
-    /** Check if a field has errors */
-    has(field: string): boolean;
-    /** Get the first error message for a field (or any first error if no field specified) */
-    first(field?: string): string | undefined;
-    /** Get all error messages for a field */
-    get(field: string): string[];
-    /** Get all errors for all fields */
-    all(): Record<string, string[]>;
-    /** Check if there are any errors */
-    any(): boolean;
-    /** Get total number of error messages */
-    count(): number;
-}
-/**
- * Create a new ErrorBag instance from raw errors.
- * @public
- */
-export declare function createErrorBag(errors: Record<string, string[]>): ErrorBag;
-/**
- * Helper to retrieve the ErrorBag from session flash data.
- * @public
- */
-export declare function errors(c: GravitoContext): ErrorBag;
-/**
- * Helper to retrieve old input value from session flash.
- * @public
- */
-export declare function old(c: GravitoContext, field: string, defaultValue?: unknown): unknown;

package/dist/core/src/helpers/response.d.ts

@@ -1,41 +0,0 @@
-import type { ContentfulStatusCode, GravitoContext } from '../http/types';
-/**
- * Standard API Success Response Structure
- * @public
- */
-export type ApiSuccess<T> = {
-    success: true;
-    data: T;
-};
-/**
- * Standard API Failure Response Structure
- * @public
- */
-export type ApiFailure = {
-    success: false;
-    error: {
-        message: string;
-        code?: string;
-        details?: unknown;
-    };
-};
-/**
- * Create a success response object.
- * @public
- */
-export declare function ok<T>(data: T): ApiSuccess<T>;
-/**
- * Create a failure response object.
- * @public
- */
-export declare function fail(message: string, code?: string, details?: unknown): ApiFailure;
-/**
- * Return a JSON response with standard success structure.
- * @public
- */
-export declare function jsonSuccess<T>(c: GravitoContext, data: T, status?: ContentfulStatusCode): Response;
-/**
- * Return a JSON response with standard failure structure.
- * @public
- */
-export declare function jsonFail(c: GravitoContext, message: string, status?: ContentfulStatusCode, code?: string, details?: unknown): Response;