@codmir/sdk 0.1.1

package/dist/index-BlgYnCLd.d.cts

@@ -0,0 +1,171 @@
+/**
+ * @codmir/sdk/overseer - Error Tracking & Session Replay
+ *
+ * Sentry-compatible API for error tracking, session replay,
+ * and performance monitoring.
+ *
+ * @example
+ * ```typescript
+ * import { init, captureException } from '@codmir/sdk/overseer';
+ *
+ * init({
+ *   dsn: 'https://your-project.codmir.com/api/overseer',
+ *   environment: 'production',
+ * });
+ *
+ * try {
+ *   riskyOperation();
+ * } catch (error) {
+ *   captureException(error);
+ * }
+ * ```
+ */
+interface OverseerConfig {
+    /** Data Source Name - your Codmir project endpoint */
+    dsn?: string;
+    /** Environment (production, staging, development) */
+    environment?: string;
+    /** Release version */
+    release?: string;
+    /** Enable/disable SDK */
+    enabled?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Sample rate for errors (0-1) */
+    sampleRate?: number;
+    /** Sample rate for traces/performance (0-1) */
+    tracesSampleRate?: number;
+    /** Sample rate for session replay (0-1) */
+    replaysSessionSampleRate?: number;
+    /** Sample rate for replay on error (0-1) */
+    replaysOnErrorSampleRate?: number;
+    /** Hook to modify/filter events before sending */
+    beforeSend?: (event: OverseerEvent) => OverseerEvent | null;
+    /** Initial user context */
+    initialUser?: UserContext;
+    /** Initial tags */
+    initialTags?: Record<string, string>;
+}
+interface OverseerEvent {
+    id: string;
+    type: "error" | "message" | "transaction" | "replay";
+    timestamp: string;
+    level: "fatal" | "error" | "warning" | "info" | "debug";
+    message?: string;
+    exception?: ExceptionData;
+    user?: UserContext;
+    tags?: Record<string, string>;
+    extra?: Record<string, unknown>;
+    breadcrumbs?: Breadcrumb[];
+    contexts?: Record<string, unknown>;
+    request?: RequestData;
+    sdk?: {
+        name: string;
+        version: string;
+    };
+    environment?: string;
+    release?: string;
+    fingerprint?: string[];
+}
+interface ExceptionData {
+    type: string;
+    value: string;
+    stacktrace?: StackFrame[];
+    mechanism?: {
+        type: string;
+        handled: boolean;
+    };
+}
+interface StackFrame {
+    filename?: string;
+    function?: string;
+    lineno?: number;
+    colno?: number;
+    in_app?: boolean;
+    context_line?: string;
+    pre_context?: string[];
+    post_context?: string[];
+}
+interface UserContext {
+    id?: string;
+    email?: string;
+    username?: string;
+    ip_address?: string;
+    [key: string]: unknown;
+}
+interface Breadcrumb {
+    type?: string;
+    category?: string;
+    message?: string;
+    data?: Record<string, unknown>;
+    level?: "fatal" | "error" | "warning" | "info" | "debug";
+    timestamp?: string;
+}
+interface RequestData {
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    query_string?: string;
+    data?: unknown;
+}
+type SeverityLevel = "fatal" | "error" | "warning" | "info" | "debug";
+declare class OverseerClient {
+    private config;
+    private user;
+    private tags;
+    private breadcrumbs;
+    private eventQueue;
+    private flushTimer;
+    private isInitialized;
+    constructor(config?: OverseerConfig);
+    init(): void;
+    captureException(error: Error | unknown, context?: Record<string, unknown>): string;
+    captureMessage(message: string, level?: SeverityLevel): string;
+    setUser(user: UserContext | null): void;
+    setTag(key: string, value: string): void;
+    setTags(tags: Record<string, string>): void;
+    setExtra(key: string, value: unknown): void;
+    addBreadcrumb(breadcrumb: Breadcrumb): void;
+    flush(timeout?: number): Promise<boolean>;
+    close(): void;
+    private shouldSample;
+    private parseStackTrace;
+    private sendEvent;
+    private sendBatch;
+}
+declare function init(config?: OverseerConfig): void;
+declare function getClient(): OverseerClient | null;
+declare function captureException(error: Error | unknown, context?: Record<string, unknown>): string;
+declare function captureMessage(message: string, level?: SeverityLevel): string;
+declare function setUser(user: UserContext | null): void;
+declare function setTag(key: string, value: string): void;
+declare function setTags(tags: Record<string, string>): void;
+declare function addBreadcrumb(breadcrumb: Breadcrumb): void;
+declare function flush(timeout?: number): Promise<boolean>;
+declare function close(): void;
+
+type index_Breadcrumb = Breadcrumb;
+type index_ExceptionData = ExceptionData;
+type index_OverseerClient = OverseerClient;
+declare const index_OverseerClient: typeof OverseerClient;
+type index_OverseerConfig = OverseerConfig;
+type index_OverseerEvent = OverseerEvent;
+type index_RequestData = RequestData;
+type index_SeverityLevel = SeverityLevel;
+type index_StackFrame = StackFrame;
+type index_UserContext = UserContext;
+declare const index_addBreadcrumb: typeof addBreadcrumb;
+declare const index_captureException: typeof captureException;
+declare const index_captureMessage: typeof captureMessage;
+declare const index_close: typeof close;
+declare const index_flush: typeof flush;
+declare const index_getClient: typeof getClient;
+declare const index_init: typeof init;
+declare const index_setTag: typeof setTag;
+declare const index_setTags: typeof setTags;
+declare const index_setUser: typeof setUser;
+declare namespace index {
+  export { type index_Breadcrumb as Breadcrumb, type index_ExceptionData as ExceptionData, index_OverseerClient as OverseerClient, type index_OverseerConfig as OverseerConfig, type index_OverseerEvent as OverseerEvent, type index_RequestData as RequestData, type index_SeverityLevel as SeverityLevel, type index_StackFrame as StackFrame, type index_UserContext as UserContext, index_addBreadcrumb as addBreadcrumb, index_captureException as captureException, index_captureMessage as captureMessage, index_close as close, index_flush as flush, index_getClient as getClient, index_init as init, index_setTag as setTag, index_setTags as setTags, index_setUser as setUser };
+}
+
+export { type Breadcrumb as B, type ExceptionData as E, type OverseerConfig as O, type RequestData as R, type SeverityLevel as S, type UserContext as U, captureMessage as a, setTags as b, captureException as c, addBreadcrumb as d, close as e, flush as f, getClient as g, setTag as h, index as i, type OverseerEvent as j, OverseerClient as k, type StackFrame as l, init as m, setUser as s };

package/dist/index-BlgYnCLd.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @codmir/sdk/overseer - Error Tracking & Session Replay
+ *
+ * Sentry-compatible API for error tracking, session replay,
+ * and performance monitoring.
+ *
+ * @example
+ * ```typescript
+ * import { init, captureException } from '@codmir/sdk/overseer';
+ *
+ * init({
+ *   dsn: 'https://your-project.codmir.com/api/overseer',
+ *   environment: 'production',
+ * });
+ *
+ * try {
+ *   riskyOperation();
+ * } catch (error) {
+ *   captureException(error);
+ * }
+ * ```
+ */
+interface OverseerConfig {
+    /** Data Source Name - your Codmir project endpoint */
+    dsn?: string;
+    /** Environment (production, staging, development) */
+    environment?: string;
+    /** Release version */
+    release?: string;
+    /** Enable/disable SDK */
+    enabled?: boolean;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Sample rate for errors (0-1) */
+    sampleRate?: number;
+    /** Sample rate for traces/performance (0-1) */
+    tracesSampleRate?: number;
+    /** Sample rate for session replay (0-1) */
+    replaysSessionSampleRate?: number;
+    /** Sample rate for replay on error (0-1) */
+    replaysOnErrorSampleRate?: number;
+    /** Hook to modify/filter events before sending */
+    beforeSend?: (event: OverseerEvent) => OverseerEvent | null;
+    /** Initial user context */
+    initialUser?: UserContext;
+    /** Initial tags */
+    initialTags?: Record<string, string>;
+}
+interface OverseerEvent {
+    id: string;
+    type: "error" | "message" | "transaction" | "replay";
+    timestamp: string;
+    level: "fatal" | "error" | "warning" | "info" | "debug";
+    message?: string;
+    exception?: ExceptionData;
+    user?: UserContext;
+    tags?: Record<string, string>;
+    extra?: Record<string, unknown>;
+    breadcrumbs?: Breadcrumb[];
+    contexts?: Record<string, unknown>;
+    request?: RequestData;
+    sdk?: {
+        name: string;
+        version: string;
+    };
+    environment?: string;
+    release?: string;
+    fingerprint?: string[];
+}
+interface ExceptionData {
+    type: string;
+    value: string;
+    stacktrace?: StackFrame[];
+    mechanism?: {
+        type: string;
+        handled: boolean;
+    };
+}
+interface StackFrame {
+    filename?: string;
+    function?: string;
+    lineno?: number;
+    colno?: number;
+    in_app?: boolean;
+    context_line?: string;
+    pre_context?: string[];
+    post_context?: string[];
+}
+interface UserContext {
+    id?: string;
+    email?: string;
+    username?: string;
+    ip_address?: string;
+    [key: string]: unknown;
+}
+interface Breadcrumb {
+    type?: string;
+    category?: string;
+    message?: string;
+    data?: Record<string, unknown>;
+    level?: "fatal" | "error" | "warning" | "info" | "debug";
+    timestamp?: string;
+}
+interface RequestData {
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    query_string?: string;
+    data?: unknown;
+}
+type SeverityLevel = "fatal" | "error" | "warning" | "info" | "debug";
+declare class OverseerClient {
+    private config;
+    private user;
+    private tags;
+    private breadcrumbs;
+    private eventQueue;
+    private flushTimer;
+    private isInitialized;
+    constructor(config?: OverseerConfig);
+    init(): void;
+    captureException(error: Error | unknown, context?: Record<string, unknown>): string;
+    captureMessage(message: string, level?: SeverityLevel): string;
+    setUser(user: UserContext | null): void;
+    setTag(key: string, value: string): void;
+    setTags(tags: Record<string, string>): void;
+    setExtra(key: string, value: unknown): void;
+    addBreadcrumb(breadcrumb: Breadcrumb): void;
+    flush(timeout?: number): Promise<boolean>;
+    close(): void;
+    private shouldSample;
+    private parseStackTrace;
+    private sendEvent;
+    private sendBatch;
+}
+declare function init(config?: OverseerConfig): void;
+declare function getClient(): OverseerClient | null;
+declare function captureException(error: Error | unknown, context?: Record<string, unknown>): string;
+declare function captureMessage(message: string, level?: SeverityLevel): string;
+declare function setUser(user: UserContext | null): void;
+declare function setTag(key: string, value: string): void;
+declare function setTags(tags: Record<string, string>): void;
+declare function addBreadcrumb(breadcrumb: Breadcrumb): void;
+declare function flush(timeout?: number): Promise<boolean>;
+declare function close(): void;
+
+type index_Breadcrumb = Breadcrumb;
+type index_ExceptionData = ExceptionData;
+type index_OverseerClient = OverseerClient;
+declare const index_OverseerClient: typeof OverseerClient;
+type index_OverseerConfig = OverseerConfig;
+type index_OverseerEvent = OverseerEvent;
+type index_RequestData = RequestData;
+type index_SeverityLevel = SeverityLevel;
+type index_StackFrame = StackFrame;
+type index_UserContext = UserContext;
+declare const index_addBreadcrumb: typeof addBreadcrumb;
+declare const index_captureException: typeof captureException;
+declare const index_captureMessage: typeof captureMessage;
+declare const index_close: typeof close;
+declare const index_flush: typeof flush;
+declare const index_getClient: typeof getClient;
+declare const index_init: typeof init;
+declare const index_setTag: typeof setTag;
+declare const index_setTags: typeof setTags;
+declare const index_setUser: typeof setUser;
+declare namespace index {
+  export { type index_Breadcrumb as Breadcrumb, type index_ExceptionData as ExceptionData, index_OverseerClient as OverseerClient, type index_OverseerConfig as OverseerConfig, type index_OverseerEvent as OverseerEvent, type index_RequestData as RequestData, type index_SeverityLevel as SeverityLevel, type index_StackFrame as StackFrame, type index_UserContext as UserContext, index_addBreadcrumb as addBreadcrumb, index_captureException as captureException, index_captureMessage as captureMessage, index_close as close, index_flush as flush, index_getClient as getClient, index_init as init, index_setTag as setTag, index_setTags as setTags, index_setUser as setUser };
+}
+
+export { type Breadcrumb as B, type ExceptionData as E, type OverseerConfig as O, type RequestData as R, type SeverityLevel as S, type UserContext as U, captureMessage as a, setTags as b, captureException as c, addBreadcrumb as d, close as e, flush as f, getClient as g, setTag as h, index as i, type OverseerEvent as j, OverseerClient as k, type StackFrame as l, init as m, setUser as s };