@gravito/zenith 1.1.3 → 1.1.6

package/src/shared/types.ts

@@ -1,223 +0,0 @@
-/**
- * Metrics representing CPU usage for a specific node/process.
- *
- * Used to visualize load distribution and identify CPU-bound workers.
- *
- * @public
- * @since 3.0.0
- */
-export interface PulseCpu {
-  /** System-wide CPU usage percentage (0-100). */
-  system: number
-  /** Process-specific CPU usage percentage (0-100). */
-  process: number
-  /** Number of CPU cores available on the host. */
-  cores: number
-}
-
-/**
- * Metrics representing memory usage for a specific node/process.
- *
- * Critical for detecting memory leaks and capacity planning.
- *
- * @public
- * @since 3.0.0
- */
-export interface PulseMemory {
-  /** System-wide memory statistics. */
-  system: {
-    /** Total system memory in bytes. */
-    total: number
-    /** Free system memory in bytes. */
-    free: number
-    /** Used system memory in bytes. */
-    used: number
-  }
-  /** Process-specific memory statistics. */
-  process: {
-    /** Resident Set Size (RSS) in bytes. */
-    rss: number
-    /** Total allocated heap size in bytes. */
-    heapTotal: number
-    /** Used heap size in bytes. */
-    heapUsed: number
-  }
-}
-
-/**
- * Runtime metadata for a monitored process.
- *
- * Provides context about the environment (Node.js version, platform)
- * and current health status.
- *
- * @public
- * @since 3.0.0
- */
-export interface PulseRuntime {
-  /** Uptime in seconds. */
-  uptime: number
-  /** Framework or runtime identification (e.g., "Node 21.4"). */
-  framework: string
-  /** Current process status (e.g., 'online', 'maintenance'). */
-  status?: string
-  /** Last few error messages captured from the process stderr/logs. */
-  errors?: string[]
-}
-
-/**
- * Statistics snapshot for a specific queue.
- *
- * Represents the state of a queue at a specific point in time, including
- * job counts and throughput metrics. Used for dashboard graphs.
- *
- * @public
- * @since 3.0.0
- */
-export interface QueueSnapshot {
-  /** The name of the queue. */
-  name: string
-  /** The driver used (redis, sqs, etc.). */
-  driver: 'redis' | 'sqs' | 'rabbitmq'
-  /** Current counts of jobs in different states. */
-  size: {
-    waiting: number
-    active: number
-    failed: number
-    delayed: number
-  }
-  /** Historical throughput data (jobs processed per minute). */
-  throughput?: {
-    in: number
-    out: number
-  }
-}
-
-/**
- * Represents a single application instance (node) monitored by Zenith.
- *
- * A PulseNode corresponds to a running process (e.g., a worker, API server)
- * that emits heartbeats. These nodes form the cluster topology.
- *
- * @public
- * @since 3.0.0
- */
-export interface PulseNode {
-  /** Unique execution ID for the node (usually UUID). */
-  id: string
-  /** Service group name (e.g., "payment-worker", "api-gateway"). */
-  service: string
-  /** Programming language or runtime type. */
-  language: 'node' | 'bun' | 'deno' | 'php' | 'go' | 'python' | 'other'
-  /** Application version (from package.json). */
-  version: string
-  /** Process identifier (PID). */
-  pid: number
-  /** Hostname of the machine. */
-  hostname: string
-  /** Operating system platform (darwin, linux, win32). */
-  platform: string
-  /** CPU metrics. */
-  cpu: PulseCpu
-  /** Memory metrics. */
-  memory: PulseMemory
-  /** Optional list of queues managed by this node. */
-  queues?: QueueSnapshot[]
-  /** Runtime details. */
-  runtime: PulseRuntime
-  /** Unstructured metadata (e.g., framework-specific details). */
-  meta?: any
-  /** Epoch timestamp of the last heartbeat received. */
-  timestamp: number
-}
-
-/**
- * Definition of an alert rule for monitoring health.
- *
- * Alert rules define conditions that trigger notifications, such as
- * high queue backlogs or worker failures.
- *
- * @public
- * @since 3.0.0
- */
-export interface AlertRule {
-  /** Unique rule ID. */
-  id: string
-  /** Human-readable name. */
-  name: string
-  /** The metric type to monitor. */
-  type: 'backlog' | 'failure' | 'worker_lost' | 'node_cpu' | 'node_ram'
-  /** The value that triggers the alert (e.g., > 100 jobs). */
-  threshold: number
-  /** Optional queue name to scope the rule to. */
-  queue?: string
-  /** Minutes to wait before re-triggering the alert (debounce). */
-  cooldownMinutes: number
-}
-
-/**
- * Configuration for alert notification channels.
- *
- * Defines where alerts should be sent when triggered.
- *
- * @public
- * @since 3.0.0
- */
-export interface AlertConfig {
-  /** Map of enabled notification channels. */
-  channels: {
-    slack?: {
-      enabled: boolean
-      webhookUrl: string
-    }
-    discord?: {
-      enabled: boolean
-      webhookUrl: string
-    }
-    email?: {
-      enabled: boolean
-      smtpHost: string
-      smtpPort: number
-      smtpUser: string
-      smtpPass: string
-      from: string
-      to: string
-    }
-  }
-}
-
-/**
- * Configuration for automated system maintenance.
- *
- * Controls data retention policies and auto-cleanup tasks.
- *
- * @public
- * @since 3.0.0
- */
-export interface MaintenanceConfig {
-  /** Whether to automatically delete old data. */
-  autoCleanup: boolean
-  /** Number of days to retain records (logs, metrics). */
-  retentionDays: number
-  /** Timestamp of the last maintenance run. */
-  lastRun?: number
-}
-
-/**
- * Represents a historical alert event.
- *
- * Stored in the database/log to track system health history.
- *
- * @public
- * @since 3.0.0
- */
-export interface AlertEvent {
-  id?: string
-  ruleId: string
-  ruleName?: string
-  type?: string
-  severity: 'critical' | 'warning' | 'info'
-  message: string
-  timestamp: number
-  resolved?: boolean
-  resolvedAt?: number
-}

package/tailwind.config.js

@@ -1,80 +0,0 @@
-/** @type {import('tailwindcss').Config} */
-export default {
-  content: ['./src/client/index.html', './src/client/**/*.{js,ts,jsx,tsx}'],
-  theme: {
-    extend: {
-      colors: {
-        background: 'hsl(var(--background))',
-        foreground: 'hsl(var(--foreground))',
-        oled: '#000000',
-        cyan: {
-          500: '#00F0FF',
-          accent: '#00F0FF',
-        },
-        card: {
-          DEFAULT: 'hsl(var(--card))',
-          foreground: 'hsl(var(--card-foreground))',
-        },
-        popover: {
-          DEFAULT: 'hsl(var(--popover))',
-          foreground: 'hsl(var(--popover-foreground))',
-        },
-        primary: {
-          DEFAULT: 'hsl(var(--primary))',
-          foreground: 'hsl(var(--primary-foreground))',
-        },
-        secondary: {
-          DEFAULT: 'hsl(var(--secondary))',
-          foreground: 'hsl(var(--secondary-foreground))',
-        },
-        muted: {
-          DEFAULT: 'hsl(var(--muted))',
-          foreground: 'hsl(var(--muted-foreground))',
-        },
-        accent: {
-          DEFAULT: 'hsl(var(--accent))',
-          foreground: 'hsl(var(--accent-foreground))',
-        },
-        destructive: {
-          DEFAULT: 'hsl(var(--destructive))',
-          foreground: 'hsl(var(--destructive-foreground))',
-        },
-        border: 'hsl(var(--border))',
-        input: 'hsl(var(--input))',
-        ring: 'hsl(var(--ring))',
-        chart: {
-          1: 'hsl(var(--chart-1))',
-          2: 'hsl(var(--chart-2))',
-          3: 'hsl(var(--chart-3))',
-          4: 'hsl(var(--chart-4))',
-          5: 'hsl(var(--chart-5))',
-        },
-      },
-      borderRadius: {
-        lg: 'var(--radius)',
-        md: 'calc(var(--radius) - 2px)',
-        sm: 'calc(var(--radius) - 4px)',
-      },
-      keyframes: {
-        'accordion-down': {
-          from: { height: '0' },
-          to: { height: 'var(--radix-accordion-content-height)' },
-        },
-        'accordion-up': {
-          from: { height: 'var(--radix-accordion-content-height)' },
-          to: { height: '0' },
-        },
-      },
-      animation: {
-        'accordion-down': 'accordion-down 0.2s ease-out',
-        'accordion-up': 'accordion-up 0.2s ease-out',
-      },
-      fontFamily: {
-        sans: ['Poppins', 'ui-sans-serif', 'system-ui', 'sans-serif'],
-        mono: ['Fira Code', 'ui-monospace', 'SFMono-Regular', 'monospace'],
-        heading: ['Poppins', 'sans-serif'],
-      },
-    },
-  },
-  plugins: [],
-}

package/tests/placeholder.test.ts

@@ -1,7 +0,0 @@
-import { describe, expect, it } from 'bun:test'
-
-describe('zenith', () => {
-  it('should have a test', () => {
-    expect(true).toBe(true)
-  })
-})

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "target": "ESNext",
-    "useDefineForClassFields": true,
-    "lib": ["ESNext", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "skipLibCheck": true,
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    /* Linting */
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "types": ["bun-types", "vite/client"]
-  },
-  "include": ["src"],
-  "references": [
-    {
-      "path": "./tsconfig.node.json"
-    }
-  ]
-}

package/tsconfig.node.json

@@ -1,10 +0,0 @@
-{
-  "compilerOptions": {
-    "composite": true,
-    "skipLibCheck": true,
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "allowSyntheticDefaultImports": true
-  },
-  "include": ["vite.config.ts"]
-}

package/vite.config.ts

@@ -1,27 +0,0 @@
-import { resolve } from 'node:path'
-import react from '@vitejs/plugin-react'
-import { defineConfig } from 'vite'
-
-// https://vitejs.dev/config/
-export default defineConfig({
-  plugins: [react()],
-  root: 'src/client',
-  publicDir: '../../public',
-  build: {
-    outDir: '../../dist/client',
-    emptyOutDir: true,
-  },
-  resolve: {
-    alias: {
-      '@': resolve(__dirname, './src/client'),
-    },
-  },
-  server: {
-    proxy: {
-      '/api': {
-        target: 'http://localhost:3000',
-        changeOrigin: true,
-      },
-    },
-  },
-})