@gravito/echo 3.1.1 → 4.0.0

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,GAClB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAG5D,YAAY,EAEV,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,cAAc,EAEd,cAAc,EAEd,eAAe,EACf,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,SAAS,CAAA"}

package/dist/monitor/src/MonitorOrbit.d.ts

@@ -1,43 +0,0 @@
-/**
- * @gravito/monitor - MonitorOrbit Plugin
- *
- * Gravito Orbit plugin for observability (Health, Metrics, Tracing)
- */
-import type { GravitoOrbit, PlanetCore } from '@gravito/core';
-import type { MonitorConfig } from './config';
-import { HealthRegistry } from './health';
-import { MetricsRegistry } from './metrics';
-import { TracingManager } from './tracing';
-/**
- * Monitor service container
- */
-export interface MonitorService {
-    health: HealthRegistry;
-    metrics: MetricsRegistry;
-    tracing: TracingManager;
-}
-/**
- * MonitorOrbit - Observability plugin for Gravito
- */
-export declare class MonitorOrbit implements GravitoOrbit {
-    readonly name = "monitor";
-    private userConfig;
-    private healthRegistry;
-    private metricsRegistry;
-    private tracingManager;
-    constructor(config?: MonitorConfig);
-    /**
-     * Install the orbit (required by GravitoOrbit interface)
-     */
-    install(core: PlanetCore): Promise<void>;
-    /**
-     * 註冊 health cache metrics
-     *
-     * 建立 metrics 來追蹤 health check cache 的效能
-     */
-    private registerHealthCacheMetrics;
-    /**
-     * Shutdown hook
-     */
-    shutdown(): Promise<void>;
-}

package/dist/monitor/src/config.d.ts

@@ -1,106 +0,0 @@
-/**
- * @gravito/monitor - Configuration Types
- */
-/**
- * Health check result
- */
-export interface HealthCheckResult {
-    status: 'healthy' | 'unhealthy' | 'degraded';
-    message?: string;
-    latency?: number;
-    details?: Record<string, unknown>;
-}
-/**
- * Health check function signature
- */
-export type HealthCheckFn = () => Promise<HealthCheckResult> | HealthCheckResult;
-/**
- * Health configuration
- */
-export interface HealthConfig {
-    /** Enable health endpoints (default: true) */
-    enabled?: boolean;
-    /** Path for full health check (default: /health) */
-    path?: string;
-    /** Path for Kubernetes readiness probe (default: /ready) */
-    readyPath?: string;
-    /** Path for Kubernetes liveness probe (default: /live) */
-    livePath?: string;
-    /** Timeout for individual health checks in ms (default: 5000) */
-    timeout?: number;
-    /** Cache health check results for ms (default: 0 = no cache) */
-    cacheTtl?: number;
-}
-/**
- * Metric types
- */
-export type MetricType = 'counter' | 'gauge' | 'histogram' | 'summary';
-/**
- * Metric definition options
- */
-export interface MetricOptions {
-    name: string;
-    help: string;
-    labels?: string[];
-    buckets?: number[];
-    percentiles?: number[];
-}
-/**
- * Metrics configuration
- */
-export interface MetricsConfig {
-    /** Enable metrics endpoint (default: true) */
-    enabled?: boolean;
-    /** Path for metrics endpoint (default: /metrics) */
-    path?: string;
-    /** Collect default runtime metrics (default: true) */
-    defaultMetrics?: boolean;
-    /** Prefix for all metric names (default: gravito_) */
-    prefix?: string;
-    /** Custom labels to add to all metrics */
-    defaultLabels?: Record<string, string>;
-}
-/**
- * Tracing configuration
- */
-export interface TracingConfig {
-    /** Enable tracing (default: false) */
-    enabled?: boolean;
-    /** Service name for tracing */
-    serviceName?: string;
-    /** Service version */
-    serviceVersion?: string;
-    /** OTLP endpoint URL (default: http://localhost:4318/v1/traces) */
-    endpoint?: string;
-    /** Sample rate 0.0 - 1.0 (default: 1.0) */
-    sampleRate?: number;
-    /** Additional resource attributes */
-    resourceAttributes?: Record<string, string>;
-    /** Trace HTTP requests automatically (default: true) */
-    traceHttp?: boolean;
-    /** Headers to propagate in traces */
-    propagateHeaders?: string[];
-}
-/**
- * Monitor configuration
- */
-export interface MonitorConfig {
-    /** Health check configuration */
-    health?: HealthConfig;
-    /** Metrics configuration */
-    metrics?: MetricsConfig;
-    /** Tracing configuration */
-    tracing?: TracingConfig;
-}
-/**
- * Default configuration values
- */
-export declare const defaultConfig: Required<MonitorConfig>;
-/**
- * Helper to merge config with defaults
- */
-export declare function resolveConfig(config: MonitorConfig): Required<MonitorConfig>;
-/**
- * Define monitor configuration (type helper)
- */
-export declare function defineMonitorConfig(config: MonitorConfig): MonitorConfig;

package/dist/monitor/src/health/HealthController.d.ts

@@ -1,28 +0,0 @@
-/**
- * @gravito/monitor - Health Controller
- *
- * HTTP handlers for health check endpoints
- */
-import type { GravitoContext } from '@gravito/core';
-import type { HealthRegistry } from './HealthRegistry';
-/**
- * HealthController handles health check HTTP endpoints
- */
-export declare class HealthController {
-    private registry;
-    constructor(registry: HealthRegistry);
-    /**
-     * GET /health - Full health check with all registered checks
-     */
-    health(c: GravitoContext): Promise<Response>;
-    /**
-     * GET /ready - Kubernetes readiness probe
-     * Returns 200 if ready to serve traffic, 503 otherwise
-     */
-    ready(c: GravitoContext): Promise<Response>;
-    /**
-     * GET /live - Kubernetes liveness probe
-     * Returns 200 if the process is alive
-     */
-    live(c: GravitoContext): Promise<Response>;
-}

package/dist/monitor/src/health/HealthRegistry.d.ts

@@ -1,80 +0,0 @@
-/**
- * @gravito/monitor - Health Check Registry
- *
- * Manages health check registrations and executions
- */
-import type { HealthCheckFn, HealthCheckResult, HealthConfig } from '../config';
-/**
- * Aggregated health check report.
- * @public
- */
-export interface HealthReport {
-    status: 'healthy' | 'unhealthy' | 'degraded';
-    timestamp: string;
-    uptime: number;
-    checks: Record<string, HealthCheckResult & {
-        name: string;
-    }>;
-}
-/**
- * Cache statistics
- */
-export interface CacheStats {
-    hits: number;
-    misses: number;
-    hitRate: number;
-}
-/**
- * HealthRegistry manages all health checks
- */
-export declare class HealthRegistry {
-    private checks;
-    private startTime;
-    private cachedReport;
-    private cacheExpiry;
-    private timeout;
-    private cacheTtl;
-    private cacheHits;
-    private cacheMisses;
-    constructor(config?: HealthConfig);
-    /**
-     * Register a health check
-     */
-    register(name: string, check: HealthCheckFn): this;
-    /**
-     * Unregister a health check
-     */
-    unregister(name: string): boolean;
-    /**
-     * Get all registered check names
-     */
-    getCheckNames(): string[];
-    /**
-     * Execute a single health check with timeout
-     */
-    private executeCheck;
-    /**
-     * Execute all health checks and generate report
-     */
-    check(): Promise<HealthReport>;
-    /**
-     * Simple liveness check (is the process running?)
-     */
-    liveness(): Promise<{
-        status: 'healthy' | 'unhealthy';
-    }>;
-    /**
-     * Readiness check (is the app ready to serve traffic?)
-     * By default, requires all checks to be healthy
-     */
-    readiness(): Promise<{
-        status: 'healthy' | 'unhealthy';
-        reason?: string;
-    }>;
-    /**
-     * Get cache statistics
-     *
-     * Useful for monitoring cache effectiveness and tuning cacheTtl
-     */
-    getCacheStats(): CacheStats;
-}

package/dist/monitor/src/health/index.d.ts

@@ -1,36 +0,0 @@
-/**
- * @gravito/monitor - Built-in Health Checks
- */
-import type { HealthCheckFn } from '../config';
-export type { CacheStats, HealthReport } from './HealthRegistry';
-/**
- * Create a database health check
- */
-export declare function createDatabaseCheck(connectionFn: () => Promise<boolean> | boolean): HealthCheckFn;
-/**
- * Create a Redis health check
- */
-export declare function createRedisCheck(pingFn: () => Promise<string> | string): HealthCheckFn;
-/**
- * Create a memory usage health check
- */
-export declare function createMemoryCheck(options?: {
-    maxHeapUsedPercent?: number;
-}): HealthCheckFn;
-/**
- * Create a custom HTTP endpoint health check
- */
-export declare function createHttpCheck(url: string, options?: {
-    timeout?: number;
-    expectedStatus?: number;
-    method?: string;
-}): HealthCheckFn;
-/**
- * Create a disk space health check
- */
-export declare function createDiskCheck(options?: {
-    path?: string;
-    minFreePercent?: number;
-}): HealthCheckFn;
-export { HealthController } from './HealthController';
-export { HealthRegistry } from './HealthRegistry';

package/dist/monitor/src/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * @gravito/monitor
- *
- * Observability module for Gravito
- * - Health Checks (Kubernetes probes)
- * - Metrics (Prometheus format)
- * - Tracing (OpenTelemetry OTLP)
- */
-export { defineMonitorConfig, type HealthCheckFn, type HealthCheckResult, type HealthConfig, type MetricOptions, type MetricsConfig, type MonitorConfig, type TracingConfig, } from './config';
-export { createDatabaseCheck, createDiskCheck, createHttpCheck, createMemoryCheck, createRedisCheck, HealthController, HealthRegistry, type HealthReport, } from './health';
-export { MonitorOrbit, type MonitorService } from './MonitorOrbit';
-export { Counter, createHttpMetricsMiddleware, Gauge, Histogram, MetricsController, MetricsRegistry, } from './metrics';
-export { createTracingMiddleware, type Span, type SpanContext, type SpanEvent, TracingManager, } from './tracing';

package/dist/monitor/src/metrics/MetricsController.d.ts

@@ -1,22 +0,0 @@
-/**
- * @gravito/monitor - Metrics Controller
- */
-import type { GravitoContext } from '@gravito/core';
-import type { MetricsRegistry } from './MetricsRegistry';
-/**
- * MetricsController handles the /metrics endpoint
- */
-export declare class MetricsController {
-    private registry;
-    constructor(registry: MetricsRegistry);
-    /**
-     * GET /metrics - Prometheus metrics endpoint
-     */
-    metrics(_c: GravitoContext): Promise<Response>;
-    /**
-     * 更新 health cache metrics
-     *
-     * 從 HealthRegistry 讀取最新的 cache 統計並更新 gauges
-     */
-    private updateHealthCacheMetrics;
-}

package/dist/monitor/src/metrics/MetricsRegistry.d.ts

@@ -1,136 +0,0 @@
-/**
- * @gravito/monitor - Metrics Registry
- *
- * Manages metric collection and Prometheus exposition
- */
-import type { MetricOptions, MetricsConfig } from '../config';
-/**
- * Represents a single metric data point with labels.
- * @public
- */
-export interface MetricValue {
-    value: number;
-    labels: Record<string, string>;
-    timestamp?: number;
-}
-/**
- * Counter metric - monotonically increasing value
- */
-export declare class Counter {
-    readonly name: string;
-    readonly help: string;
-    readonly labelNames: string[];
-    private values;
-    constructor(name: string, help: string, labelNames?: string[]);
-    /**
-     * Increment the counter
-     */
-    inc(labels?: Record<string, string>, delta?: number): void;
-    /**
-     * Get current values
-     */
-    getValues(): MetricValue[];
-    /**
-     * Reset all values
-     */
-    reset(): void;
-    private labelsToKey;
-    private keyToLabels;
-}
-/**
- * Gauge metric - value that can go up or down
- */
-export declare class Gauge {
-    readonly name: string;
-    readonly help: string;
-    readonly labelNames: string[];
-    private values;
-    constructor(name: string, help: string, labelNames?: string[]);
-    /**
-     * Set the gauge value
-     */
-    set(value: number, labels?: Record<string, string>): void;
-    /**
-     * Increment the gauge
-     */
-    inc(labels?: Record<string, string>, delta?: number): void;
-    /**
-     * Decrement the gauge
-     */
-    dec(labels?: Record<string, string>, delta?: number): void;
-    /**
-     * Get current values
-     */
-    getValues(): MetricValue[];
-    private labelsToKey;
-    private keyToLabels;
-}
-/**
- * Histogram metric - tracks distribution of values
- */
-export declare class Histogram {
-    readonly name: string;
-    readonly help: string;
-    readonly labelNames: string[];
-    private bucketCounts;
-    private sums;
-    private counts;
-    readonly buckets: number[];
-    constructor(name: string, help: string, labelNames?: string[], buckets?: number[]);
-    /**
-     * Observe a value
-     */
-    observe(value: number, labels?: Record<string, string>): void;
-    /**
-     * Start a timer and return a function to stop it
-     */
-    startTimer(labels?: Record<string, string>): () => void;
-    /**
-     * Get values for Prometheus format
-     */
-    getValues(): {
-        buckets: Map<string, Map<number, number>>;
-        sums: Map<string, number>;
-        counts: Map<string, number>;
-    };
-    private labelsToKey;
-}
-/**
- * MetricsRegistry manages all metrics
- */
-export declare class MetricsRegistry {
-    private counters;
-    private gauges;
-    private histograms;
-    private startTime;
-    private prefix;
-    private defaultLabels;
-    private collectDefaultMetrics;
-    constructor(config?: MetricsConfig);
-    /**
-     * Create or get a counter
-     */
-    counter(options: MetricOptions): Counter;
-    /**
-     * Create or get a gauge
-     */
-    gauge(options: MetricOptions): Gauge;
-    /**
-     * Create or get a histogram
-     */
-    histogram(options: MetricOptions): Histogram;
-    /**
-     * Initialize default runtime metrics
-     */
-    private initDefaultMetrics;
-    /**
-     * Update default metrics with current values
-     */
-    private updateDefaultMetrics;
-    /**
-     * Export metrics in Prometheus format
-     */
-    toPrometheus(): string;
-    private formatLabels;
-    private keyToLabels;
-}

package/dist/monitor/src/metrics/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * @gravito/monitor - HTTP Metrics Middleware
- */
-import type { GravitoContext } from '@gravito/core';
-import type { MetricsRegistry } from './MetricsRegistry';
-/**
- * Create middleware that collects HTTP metrics
- */
-export declare function createHttpMetricsMiddleware(registry: MetricsRegistry): (c: GravitoContext, next: () => Promise<void>) => Promise<Response | undefined>;
-export { MetricsController } from './MetricsController';
-export { Counter, Gauge, Histogram, MetricsRegistry } from './MetricsRegistry';

package/dist/monitor/src/tracing/TracingManager.d.ts

@@ -1,97 +0,0 @@
-/**
- * @gravito/monitor - Tracing Manager
- *
- * OpenTelemetry OTLP tracing integration
- */
-import type { TracingConfig } from '../config';
-/**
- * Span interface for tracing
- */
-export interface Span {
-    name: string;
-    traceId: string;
-    spanId: string;
-    parentSpanId?: string;
-    startTime: number;
-    endTime?: number;
-    attributes: Record<string, string | number | boolean>;
-    status: 'ok' | 'error' | 'unset';
-    events: SpanEvent[];
-}
-/**
- * Event recorded within a span.
- * @public
- */
-export interface SpanEvent {
-    name: string;
-    timestamp: number;
-    attributes?: Record<string, string | number | boolean>;
-}
-/**
- * Span context for propagation
- */
-export interface SpanContext {
-    traceId: string;
-    spanId: string;
-    traceFlags: number;
-}
-/**
- * TracingManager handles distributed tracing
- */
-export declare class TracingManager {
-    private otelSdk;
-    private spans;
-    private isInitialized;
-    private serviceName;
-    private serviceVersion;
-    private endpoint;
-    private resourceAttributes;
-    constructor(config?: TracingConfig);
-    /**
-     * Initialize OpenTelemetry SDK if available
-     */
-    initialize(): Promise<void>;
-    /**
-     * Shutdown tracing
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Start a new span
-     */
-    startSpan(name: string, options?: {
-        attributes?: Record<string, string | number | boolean>;
-        parentSpan?: Span;
-    }): Span;
-    /**
-     * End a span
-     */
-    endSpan(span: Span, status?: 'ok' | 'error'): void;
-    /**
-     * Add an event to a span
-     */
-    addEvent(span: Span, name: string, attributes?: Record<string, string | number | boolean>): void;
-    /**
-     * Set span attribute
-     */
-    setAttribute(span: Span, key: string, value: string | number | boolean): void;
-    /**
-     * Get the currently active span
-     */
-    getActiveSpan(): Span | null;
-    /**
-     * Extract trace context from headers
-     */
-    extractContext(headers: Headers): SpanContext | null;
-    /**
-     * Inject trace context into headers
-     */
-    injectContext(headers: Headers, span: Span): void;
-    /**
-     * Get all collected spans (for debugging)
-     */
-    getSpans(): Span[];
-    /**
-     * Clear collected spans
-     */
-    clearSpans(): void;
-}

package/dist/monitor/src/tracing/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * @gravito/monitor - Tracing Middleware
- */
-import type { GravitoContext } from '@gravito/core';
-import type { TracingManager } from './TracingManager';
-/**
- * Create middleware that traces HTTP requests
- */
-export declare function createTracingMiddleware(tracer: TracingManager): (c: GravitoContext, next: () => Promise<void>) => Promise<Response | undefined>;
-export { type Span, type SpanContext, type SpanEvent, TracingManager } from './TracingManager';

package/dist/photon/src/index.d.ts

@@ -1,89 +0,0 @@
-/**
- * @gravito/photon - High-performance web engine for the Gravito Galaxy Architecture.
- *
- * Photon serves as the foundational HTTP layer for Gravito, providing an ultra-fast,
- * type-safe routing system based on Hono. It is designed to be the "light" that
- * connects Satellites (domain plugins) and Orbits (infrastructure) within the ecosystem.
- *
- * Key features:
- * - Zero-overhead routing and middleware.
- * - Full TypeScript inference for request parameters and body.
- * - Built-in support for HTMX and binary (CBOR) protocols.
- *
- * @example
- * ```typescript
- * import { Photon } from '@gravito/photon'
- *
- * const app = new Photon()
- *
- * app.get('/welcome', (c) => c.text('Welcome to the Galaxy!'))
- *
- * export default app
- * ```
- * @packageDocumentation
- */
-export * from 'hono';
-/**
- * The primary application class for Photon.
- *
- * An alias for `Hono`, providing the core routing and middleware capabilities.
- * Use this to define your API structure and mount domain-specific Satellites.
- *
- * @remarks
- * Photon extends Hono's capabilities with Gravito-specific optimizations.
- * It serves as the entry point for defining routes, applying middleware,
- * and handling the request-response lifecycle.
- *
- * @example
- * ```typescript
- * const app = new Photon()
- *
- * // Basic routing
- * app.get('/api/health', (c) => c.json({ status: 'ok' }))
- *
- * // Middleware integration
- * app.use('/api/*', myMiddleware)
- *
- * // Mounting sub-routers
- * app.route('/v1', v1Router)
- * ```
- * @public
- */
-export { Hono as Photon } from 'hono';
-/**
- * Binary-related middleware for Photon.
- *
- * Provides utilities for handling binary data formats like CBOR,
- * optimizing payload size and serialization speed for high-performance APIs.
- *
- * @public
- */
-export * from './middleware/binary';
-/**
- * HTMX-related middleware for Photon.
- *
- * Enhances Photon with first-class support for HTMX, including
- * automatic request detection and simplified header access for hypermedia-driven UIs.
- *
- * @public
- */
-export * from './middleware/htmx';
-/**
- * Rate limiting middleware for Photon.
- *
- * Provides built-in rate limiting with token bucket and sliding window strategies.
- * Supports both memory-based and custom storage backends.
- *
- * @public
- */
-export * from './middleware/ratelimit';
-/**
- * Redis-based rate limiting storage.
- * @public
- */
-export * from './middleware/ratelimit-redis';
-/**
- * OpenAPI utilities
- * @public
- */
-export * from './openapi';