@sentienguard/apm 1.0.7 → 1.0.8

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@sentienguard/apm",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "SentienGuard APM SDK - Minimal, production-safe application performance monitoring",
   "main": "src/index.js",
+  "types": "src/index.d.ts",
   "type": "module",
   "browser": "./src/browser.js",
   "exports": {
     ".": {
+      "types": "./src/index.d.ts",
       "browser": "./src/browser.js",
       "default": "./src/index.js"
     }

package/src/index.d.ts

@@ -0,0 +1,102 @@
+/**
+ * SentienGuard APM SDK TypeScript Declarations
+ */
+
+// Configuration types
+export interface ApmConfig {
+  apiKey?: string;
+  service?: string;
+  environment?: string;
+  endpoint?: string;
+  flushInterval?: number;
+  maxRoutes?: number;
+  maxPayloadSize?: number;
+  enabled?: boolean;
+  debug?: boolean;
+}
+
+export interface BrowserApmConfig {
+  apiKey: string;
+  service: string;
+  endpoint?: string;
+  environment?: string;
+  flushInterval?: number;
+  debug?: boolean;
+}
+
+export interface ApmStatus {
+  enabled: boolean;
+  initialized: boolean;
+  config: {
+    service: string;
+    environment: string;
+    flushInterval: number;
+  };
+  stats: {
+    requestMetrics?: number;
+    dependencyMetrics?: number;
+    webVitals?: number;
+    jsErrors?: number;
+  };
+}
+
+// Core functions
+export function initialize(options?: BrowserApmConfig): void;
+export function init(options?: BrowserApmConfig): void;
+export function shutdown(): Promise<void>;
+export function getStatus(): ApmStatus;
+export function flush(): Promise<void>;
+export function getConfig(): ApmConfig;
+export function isEnabled(): boolean;
+
+// Express middleware (no-ops in browser)
+export function expressMiddleware(): (req: any, res: any, next: any) => void;
+export function expressErrorMiddleware(): (err: any, req: any, res: any, next: any) => void;
+
+// Fastify plugin (no-ops in browser)
+export function fastifyPlugin(): any;
+export function fastifyErrorHandler(): any;
+
+// Route utilities (no-ops in browser)
+export function normalizeRoute(route: string): string;
+export function extractRoute(req: any): string;
+export const RouteRegistry: any;
+
+// Aggregator
+export function getAggregator(): any;
+
+// MongoDB instrumentation (no-ops in browser)
+export function instrumentMongoDB(): void;
+
+// OpenAI instrumentation (no-ops in browser)
+export function instrumentOpenAI(): void;
+
+// Circuit breaker (no-ops in browser)
+export function createBreaker(fn: any): any;
+export function wrapMongoOperation(fn: any): any;
+export function getBreakerStats(): any;
+
+// Default export
+declare const SentienGuard: {
+  init: typeof init;
+  initialize: typeof initialize;
+  shutdown: typeof shutdown;
+  getStatus: typeof getStatus;
+  flush: typeof flush;
+  getConfig: typeof getConfig;
+  isEnabled: typeof isEnabled;
+  getAggregator: typeof getAggregator;
+  expressMiddleware: typeof expressMiddleware;
+  expressErrorMiddleware: typeof expressErrorMiddleware;
+  fastifyPlugin: typeof fastifyPlugin;
+  fastifyErrorHandler: typeof fastifyErrorHandler;
+  normalizeRoute: typeof normalizeRoute;
+  extractRoute: typeof extractRoute;
+  instrumentMongoDB: typeof instrumentMongoDB;
+  instrumentOpenAI: typeof instrumentOpenAI;
+  createBreaker: typeof createBreaker;
+  wrapMongoOperation: typeof wrapMongoOperation;
+  getBreakerStats: typeof getBreakerStats;
+};
+
+export default SentienGuard;