@statly/observe 1.0.0 → 1.2.0

package/dist/index.d.mts

@@ -1,6 +1,56 @@
 export { expressErrorHandler, requestHandler } from './integrations/express.mjs';
 export { captureNextJsError, withStatly, withStatlyGetServerSideProps, withStatlyGetStaticProps, withStatlyPagesApi, withStatlyServerAction } from './integrations/nextjs.mjs';
 export { createRequestCapture, statlyFastifyPlugin, statlyPlugin } from './integrations/fastify.mjs';
+export { AIFeatures, ConsoleDestination, ConsoleDestinationConfig, DEFAULT_LEVELS, Destination, EXTENDED_LEVELS, ErrorExplanation, FileDestination, FileDestinationConfig, FileRotationConfig, FixSuggestion, LOG_LEVELS, LevelSet, LogEntry, LogLevel, Logger, LoggerConfig, ObserveDestination, ObserveDestinationConfig, REDACTED, SCRUB_PATTERNS, SENSITIVE_KEYS, ScrubPattern, Scrubber, ScrubbingConfig, formatJson, formatJsonPretty, formatPretty, getConsoleMethod, getDefaultLogger, isSensitiveKey, audit as logAudit, debug as logDebug, error as logError, fatal as logFatal, info as logInfo, trace as logTrace, warn as logWarn, setDefaultLogger } from './logger/index.mjs';
+
+/**
+ * Span module for Statly Observe SDK
+ * Handles distributed tracing spans
+ */
+declare enum SpanStatus {
+    OK = "ok",
+    ERROR = "error"
+}
+interface SpanContext {
+    traceId: string;
+    spanId: string;
+    parentId?: string | null;
+}
+interface SpanData {
+    name: string;
+    traceId: string;
+    spanId: string;
+    parentId?: string | null;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    status: SpanStatus;
+    tags: Record<string, string>;
+    metadata: Record<string, unknown>;
+}
+declare class Span {
+    readonly name: string;
+    readonly context: SpanContext;
+    readonly startTime: number;
+    private _endTime?;
+    private _durationMs?;
+    private _status;
+    private _tags;
+    private _metadata;
+    private _finished;
+    constructor(name: string, context: SpanContext, tags?: Record<string, string>);
+    /**
+     * Finish the span and calculate duration
+     */
+    finish(endTime?: number): void;
+    setTag(key: string, value: string): this;
+    setMetadata(key: string, value: unknown): this;
+    setStatus(status: SpanStatus): this;
+    get status(): SpanStatus;
+    get tags(): Record<string, string>;
+    get durationMs(): number | undefined;
+    toDict(): SpanData;
+}
 
 /**
  * Statly Observe SDK Types
@@ -79,9 +129,10 @@ interface DeviceInfo {
 interface StatlyEvent {
     message: string;
     timestamp?: number;
-    level?: 'debug' | 'info' | 'warning' | 'error' | 'fatal';
+    level?: 'debug' | 'info' | 'warning' | 'error' | 'fatal' | 'span';
     stack?: string;
     exception?: Exception;
+    span?: SpanData;
     environment?: string;
     release?: string;
     url?: string;
@@ -130,6 +181,18 @@ declare class StatlyClient {
      * Capture a message
      */
     captureMessage(message: string, level?: EventLevel): string;
+    /**
+     * Capture a completed span
+     */
+    captureSpan(span: Span): string;
+    /**
+     * Start a new tracing span
+     */
+    startSpan(name: string, tags?: Record<string, string>): Span;
+    /**
+     * Execute a function within a trace span
+     */
+    trace<T>(name: string, operation: (span: Span) => Promise<T> | T, tags?: Record<string, string>): Promise<T>;
     /**
      * Internal method to capture an error
      */
@@ -181,47 +244,6 @@ declare class StatlyClient {
     flush(): Promise<void>;
 }
 
-/**
- * Statly Observe SDK
- *
- * Error tracking and monitoring for JavaScript applications.
- *
- * @example
- * ```typescript
- * import { Statly } from '@statly/observe-sdk';
- *
- * Statly.init({
- *   dsn: 'https://sk_live_xxx@statly.live/your-org',
- *   release: '1.0.0',
- *   environment: 'production',
- * });
- *
- * // Errors are captured automatically
- *
- * // Manual capture
- * try {
- *   riskyOperation();
- * } catch (error) {
- *   Statly.captureException(error);
- * }
- *
- * // Capture a message
- * Statly.captureMessage('Something happened', 'warning');
- *
- * // Set user context
- * Statly.setUser({
- *   id: 'user-123',
- *   email: 'user@example.com',
- * });
- *
- * // Add breadcrumb
- * Statly.addBreadcrumb({
- *   category: 'auth',
- *   message: 'User logged in',
- * });
- * ```
- */
-
 /**
  * Initialize the Statly SDK
  *
@@ -274,6 +296,18 @@ declare function close(): Promise<void>;
  * Get the current client instance
  */
 declare function getClient(): StatlyClient | null;
+/**
+ * Execute a function within a trace span
+ */
+declare function trace<T>(name: string, operation: (span: Span) => Promise<T> | T, tags?: Record<string, string>): Promise<T>;
+/**
+ * Start a new tracing span
+ */
+declare function startSpan(name: string, tags?: Record<string, string>): Span | null;
+/**
+ * Capture a completed span
+ */
+declare function captureSpan(span: Span): string;
 declare const Statly: {
     readonly init: typeof init;
     readonly captureException: typeof captureException;
@@ -285,6 +319,9 @@ declare const Statly: {
     readonly flush: typeof flush;
     readonly close: typeof close;
     readonly getClient: typeof getClient;
+    readonly trace: typeof trace;
+    readonly startSpan: typeof startSpan;
+    readonly captureSpan: typeof captureSpan;
 };
 
-export { type Breadcrumb, type BrowserInfo, type DeviceInfo, type EventLevel, type Exception, type OSInfo, type StackFrame, Statly, StatlyClient, type StatlyEvent, type StatlyOptions, type User, addBreadcrumb, captureException, captureMessage, close, flush, getClient, init, setTag, setTags, setUser };
+export { type Breadcrumb, type BrowserInfo, type DeviceInfo, type EventLevel, type Exception, type OSInfo, type StackFrame, Statly, StatlyClient, type StatlyEvent, type StatlyOptions, type User, addBreadcrumb, captureException, captureMessage, captureSpan, close, flush, getClient, init, setTag, setTags, setUser, startSpan, trace };

package/dist/index.d.ts

@@ -1,6 +1,56 @@
 export { expressErrorHandler, requestHandler } from './integrations/express.js';
 export { captureNextJsError, withStatly, withStatlyGetServerSideProps, withStatlyGetStaticProps, withStatlyPagesApi, withStatlyServerAction } from './integrations/nextjs.js';
 export { createRequestCapture, statlyFastifyPlugin, statlyPlugin } from './integrations/fastify.js';
+export { AIFeatures, ConsoleDestination, ConsoleDestinationConfig, DEFAULT_LEVELS, Destination, EXTENDED_LEVELS, ErrorExplanation, FileDestination, FileDestinationConfig, FileRotationConfig, FixSuggestion, LOG_LEVELS, LevelSet, LogEntry, LogLevel, Logger, LoggerConfig, ObserveDestination, ObserveDestinationConfig, REDACTED, SCRUB_PATTERNS, SENSITIVE_KEYS, ScrubPattern, Scrubber, ScrubbingConfig, formatJson, formatJsonPretty, formatPretty, getConsoleMethod, getDefaultLogger, isSensitiveKey, audit as logAudit, debug as logDebug, error as logError, fatal as logFatal, info as logInfo, trace as logTrace, warn as logWarn, setDefaultLogger } from './logger/index.js';
+
+/**
+ * Span module for Statly Observe SDK
+ * Handles distributed tracing spans
+ */
+declare enum SpanStatus {
+    OK = "ok",
+    ERROR = "error"
+}
+interface SpanContext {
+    traceId: string;
+    spanId: string;
+    parentId?: string | null;
+}
+interface SpanData {
+    name: string;
+    traceId: string;
+    spanId: string;
+    parentId?: string | null;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    status: SpanStatus;
+    tags: Record<string, string>;
+    metadata: Record<string, unknown>;
+}
+declare class Span {
+    readonly name: string;
+    readonly context: SpanContext;
+    readonly startTime: number;
+    private _endTime?;
+    private _durationMs?;
+    private _status;
+    private _tags;
+    private _metadata;
+    private _finished;
+    constructor(name: string, context: SpanContext, tags?: Record<string, string>);
+    /**
+     * Finish the span and calculate duration
+     */
+    finish(endTime?: number): void;
+    setTag(key: string, value: string): this;
+    setMetadata(key: string, value: unknown): this;
+    setStatus(status: SpanStatus): this;
+    get status(): SpanStatus;
+    get tags(): Record<string, string>;
+    get durationMs(): number | undefined;
+    toDict(): SpanData;
+}
 
 /**
  * Statly Observe SDK Types
@@ -79,9 +129,10 @@ interface DeviceInfo {
 interface StatlyEvent {
     message: string;
     timestamp?: number;
-    level?: 'debug' | 'info' | 'warning' | 'error' | 'fatal';
+    level?: 'debug' | 'info' | 'warning' | 'error' | 'fatal' | 'span';
     stack?: string;
     exception?: Exception;
+    span?: SpanData;
     environment?: string;
     release?: string;
     url?: string;
@@ -130,6 +181,18 @@ declare class StatlyClient {
      * Capture a message
      */
     captureMessage(message: string, level?: EventLevel): string;
+    /**
+     * Capture a completed span
+     */
+    captureSpan(span: Span): string;
+    /**
+     * Start a new tracing span
+     */
+    startSpan(name: string, tags?: Record<string, string>): Span;
+    /**
+     * Execute a function within a trace span
+     */
+    trace<T>(name: string, operation: (span: Span) => Promise<T> | T, tags?: Record<string, string>): Promise<T>;
     /**
      * Internal method to capture an error
      */
@@ -181,47 +244,6 @@ declare class StatlyClient {
     flush(): Promise<void>;
 }
 
-/**
- * Statly Observe SDK
- *
- * Error tracking and monitoring for JavaScript applications.
- *
- * @example
- * ```typescript
- * import { Statly } from '@statly/observe-sdk';
- *
- * Statly.init({
- *   dsn: 'https://sk_live_xxx@statly.live/your-org',
- *   release: '1.0.0',
- *   environment: 'production',
- * });
- *
- * // Errors are captured automatically
- *
- * // Manual capture
- * try {
- *   riskyOperation();
- * } catch (error) {
- *   Statly.captureException(error);
- * }
- *
- * // Capture a message
- * Statly.captureMessage('Something happened', 'warning');
- *
- * // Set user context
- * Statly.setUser({
- *   id: 'user-123',
- *   email: 'user@example.com',
- * });
- *
- * // Add breadcrumb
- * Statly.addBreadcrumb({
- *   category: 'auth',
- *   message: 'User logged in',
- * });
- * ```
- */
-
 /**
  * Initialize the Statly SDK
  *
@@ -274,6 +296,18 @@ declare function close(): Promise<void>;
  * Get the current client instance
  */
 declare function getClient(): StatlyClient | null;
+/**
+ * Execute a function within a trace span
+ */
+declare function trace<T>(name: string, operation: (span: Span) => Promise<T> | T, tags?: Record<string, string>): Promise<T>;
+/**
+ * Start a new tracing span
+ */
+declare function startSpan(name: string, tags?: Record<string, string>): Span | null;
+/**
+ * Capture a completed span
+ */
+declare function captureSpan(span: Span): string;
 declare const Statly: {
     readonly init: typeof init;
     readonly captureException: typeof captureException;
@@ -285,6 +319,9 @@ declare const Statly: {
     readonly flush: typeof flush;
     readonly close: typeof close;
     readonly getClient: typeof getClient;
+    readonly trace: typeof trace;
+    readonly startSpan: typeof startSpan;
+    readonly captureSpan: typeof captureSpan;
 };
 
-export { type Breadcrumb, type BrowserInfo, type DeviceInfo, type EventLevel, type Exception, type OSInfo, type StackFrame, Statly, StatlyClient, type StatlyEvent, type StatlyOptions, type User, addBreadcrumb, captureException, captureMessage, close, flush, getClient, init, setTag, setTags, setUser };
+export { type Breadcrumb, type BrowserInfo, type DeviceInfo, type EventLevel, type Exception, type OSInfo, type StackFrame, Statly, StatlyClient, type StatlyEvent, type StatlyOptions, type User, addBreadcrumb, captureException, captureMessage, captureSpan, close, flush, getClient, init, setTag, setTags, setUser, startSpan, trace };