litesoc 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,260 @@
+/**
+ * LiteSOC Node.js/TypeScript SDK
+ * Official SDK for security event tracking and threat detection
+ *
+ * @packageDocumentation
+ */
+/** Fetch function type for cross-environment compatibility */
+type FetchFunction = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+/**
+ * Authentication events
+ */
+type AuthEvent = "auth.login_success" | "auth.login_failed" | "auth.logout" | "auth.password_changed" | "auth.password_reset_requested" | "auth.password_reset_completed" | "auth.mfa_enabled" | "auth.mfa_disabled" | "auth.mfa_challenge_success" | "auth.mfa_challenge_failed" | "auth.session_created" | "auth.session_revoked" | "auth.token_refreshed" | "auth.failed";
+/**
+ * User events
+ */
+type UserEvent = "user.created" | "user.updated" | "user.deleted" | "user.email_changed" | "user.email_verified" | "user.phone_changed" | "user.phone_verified" | "user.profile_updated" | "user.avatar_changed" | "user.login_failed" | "user.login.failed";
+/**
+ * Authorization events
+ */
+type AuthzEvent = "authz.role_assigned" | "authz.role_removed" | "authz.role_changed" | "authz.permission_granted" | "authz.permission_revoked" | "authz.access_denied" | "authz.access_granted";
+/**
+ * Admin events
+ */
+type AdminEvent = "admin.privilege_escalation" | "admin.user_impersonation" | "admin.settings_changed" | "admin.api_key_created" | "admin.api_key_revoked" | "admin.invite_sent" | "admin.invite_accepted" | "admin.member_removed";
+/**
+ * Data events
+ */
+type DataEvent = "data.export" | "data.import" | "data.bulk_delete" | "data.bulk_update" | "data.sensitive_access" | "data.download" | "data.upload" | "data.shared" | "data.unshared";
+/**
+ * Security events
+ */
+type SecurityEvent = "security.suspicious_activity" | "security.rate_limit_exceeded" | "security.ip_blocked" | "security.ip_unblocked" | "security.account_locked" | "security.account_unlocked" | "security.brute_force_detected" | "security.impossible_travel" | "security.geo_anomaly";
+/**
+ * API events
+ */
+type ApiEvent = "api.key_used" | "api.rate_limited" | "api.error" | "api.webhook_sent" | "api.webhook_failed";
+/**
+ * Billing events
+ */
+type BillingEvent = "billing.subscription_created" | "billing.subscription_updated" | "billing.subscription_cancelled" | "billing.payment_succeeded" | "billing.payment_failed" | "billing.invoice_created" | "billing.invoice_paid";
+/**
+ * All predefined event types
+ */
+type PredefinedEventType = AuthEvent | UserEvent | AuthzEvent | AdminEvent | DataEvent | SecurityEvent | ApiEvent | BillingEvent;
+/**
+ * Custom event type (string pattern: category.action)
+ */
+type CustomEventType = `${string}.${string}`;
+/**
+ * All supported event types
+ */
+type EventType = PredefinedEventType | CustomEventType;
+/**
+ * Event severity levels
+ */
+type EventSeverity = "low" | "medium" | "high" | "critical";
+/**
+ * Actor information
+ */
+interface Actor {
+    /** Unique identifier for the actor (user ID, API key ID, etc.) */
+    id: string;
+    /** Actor's email address (optional) */
+    email?: string;
+}
+/**
+ * Event metadata (arbitrary key-value pairs)
+ */
+type EventMetadata = Record<string, unknown>;
+/**
+ * Options for tracking an event
+ */
+interface TrackOptions {
+    /** The actor (user) performing the action */
+    actor?: Actor | string;
+    /** Actor's email address (shorthand for actor.email) */
+    actorEmail?: string;
+    /** End-user's IP address (the user making the request) */
+    userIp?: string;
+    /** Event severity (optional, auto-detected for known events) */
+    severity?: EventSeverity;
+    /** Additional metadata for the event */
+    metadata?: EventMetadata;
+    /** Custom timestamp (defaults to now) */
+    timestamp?: Date | string;
+}
+/**
+ * SDK configuration options
+ */
+interface LiteSOCOptions {
+    /** Your LiteSOC API key */
+    apiKey: string;
+    /** API endpoint (defaults to https://www.litesoc.io/api/v1/collect) */
+    endpoint?: string;
+    /** Enable batching (defaults to true) */
+    batching?: boolean;
+    /** Batch size before auto-flush (defaults to 10) */
+    batchSize?: number;
+    /** Batch flush interval in milliseconds (defaults to 5000ms) */
+    flushInterval?: number;
+    /** Enable debug logging (defaults to false) */
+    debug?: boolean;
+    /** Fail silently on errors (defaults to true) */
+    silent?: boolean;
+    /** Custom fetch implementation (for Edge runtimes) */
+    fetch?: FetchFunction;
+}
+/**
+ * LiteSOC SDK for tracking security events
+ *
+ * @example
+ * ```typescript
+ * import { LiteSOC } from 'litesoc';
+ *
+ * const litesoc = new LiteSOC({ apiKey: 'your-api-key' });
+ *
+ * // Track a login failure
+ * await litesoc.track('auth.login_failed', {
+ *   actor: { id: 'user_123', email: 'user@example.com' },
+ *   userIp: '192.168.1.1',
+ *   metadata: { reason: 'invalid_password' }
+ * });
+ *
+ * // Flush remaining events before shutdown
+ * await litesoc.flush();
+ * ```
+ */
+declare class LiteSOC {
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly batching;
+    private readonly batchSize;
+    private readonly flushInterval;
+    private readonly debug;
+    private readonly silent;
+    private readonly fetchFn;
+    private queue;
+    private flushTimer;
+    private isFlushing;
+    /**
+     * Create a new LiteSOC SDK instance
+     *
+     * @param options - SDK configuration options
+     * @throws Error if apiKey is not provided
+     */
+    constructor(options: LiteSOCOptions);
+    /**
+     * Track a security event
+     *
+     * @param eventName - The event type (e.g., 'auth.login_failed')
+     * @param options - Event options including actor, IP, and metadata
+     * @returns Promise that resolves when the event is queued or sent
+     *
+     * @example
+     * ```typescript
+     * // Track with full options
+     * await litesoc.track('auth.login_failed', {
+     *   actor: { id: 'user_123', email: 'user@example.com' },
+     *   userIp: '192.168.1.1',
+     *   metadata: { reason: 'invalid_password', attempts: 3 }
+     * });
+     *
+     * // Track with shorthand actor
+     * await litesoc.track('user.created', {
+     *   actor: 'user_456',
+     *   actorEmail: 'newuser@example.com'
+     * });
+     * ```
+     */
+    track(eventName: EventType, options?: TrackOptions): Promise<void>;
+    /**
+     * Flush all queued events to the server
+     *
+     * @returns Promise that resolves when all events are sent
+     *
+     * @example
+     * ```typescript
+     * // Flush before application shutdown
+     * process.on('beforeExit', async () => {
+     *   await litesoc.flush();
+     * });
+     * ```
+     */
+    flush(): Promise<void>;
+    /**
+     * Get the current queue size
+     *
+     * @returns Number of events in the queue
+     */
+    getQueueSize(): number;
+    /**
+     * Clear all queued events without sending
+     */
+    clearQueue(): void;
+    /**
+     * Shutdown the SDK gracefully
+     * Flushes remaining events and clears timers
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Track a login failure event
+     */
+    trackLoginFailed(actorId: string, options?: Omit<TrackOptions, "actor">): Promise<void>;
+    /**
+     * Track a login success event
+     */
+    trackLoginSuccess(actorId: string, options?: Omit<TrackOptions, "actor">): Promise<void>;
+    /**
+     * Track a privilege escalation event
+     */
+    trackPrivilegeEscalation(actorId: string, options?: Omit<TrackOptions, "actor">): Promise<void>;
+    /**
+     * Track a sensitive data access event
+     */
+    trackSensitiveAccess(actorId: string, resource: string, options?: Omit<TrackOptions, "actor">): Promise<void>;
+    /**
+     * Track a bulk delete event
+     */
+    trackBulkDelete(actorId: string, recordCount: number, options?: Omit<TrackOptions, "actor">): Promise<void>;
+    /**
+     * Track a role change event
+     */
+    trackRoleChanged(actorId: string, oldRole: string, newRole: string, options?: Omit<TrackOptions, "actor">): Promise<void>;
+    /**
+     * Track an access denied event
+     */
+    trackAccessDenied(actorId: string, resource: string, options?: Omit<TrackOptions, "actor">): Promise<void>;
+    /**
+     * Schedule a flush after the flush interval
+     */
+    private scheduleFlush;
+    /**
+     * Send events to the LiteSOC API
+     */
+    private sendEvents;
+    /**
+     * Handle errors based on silent mode
+     */
+    private handleError;
+    /**
+     * Log debug messages
+     */
+    private log;
+}
+/**
+ * Create a new LiteSOC SDK instance
+ *
+ * @param options - SDK configuration options
+ * @returns LiteSOC SDK instance
+ *
+ * @example
+ * ```typescript
+ * import { createLiteSOC } from 'litesoc';
+ *
+ * const litesoc = createLiteSOC({ apiKey: 'your-api-key' });
+ * ```
+ */
+declare function createLiteSOC(options: LiteSOCOptions): LiteSOC;
+
+export { type Actor, type AdminEvent, type ApiEvent, type AuthEvent, type AuthzEvent, type BillingEvent, type CustomEventType, type DataEvent, type EventMetadata, type EventSeverity, type EventType, LiteSOC, type LiteSOCOptions, type PredefinedEventType, type SecurityEvent, type TrackOptions, type UserEvent, createLiteSOC, LiteSOC as default };

package/dist/index.js

@@ -0,0 +1,344 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// src/index.ts
+var LiteSOC = class {
+  /**
+   * Create a new LiteSOC SDK instance
+   *
+   * @param options - SDK configuration options
+   * @throws Error if apiKey is not provided
+   */
+  constructor(options) {
+    this.queue = [];
+    this.flushTimer = null;
+    this.isFlushing = false;
+    if (!options.apiKey) {
+      throw new Error("LiteSOC: apiKey is required");
+    }
+    this.apiKey = options.apiKey;
+    this.endpoint = options.endpoint || "https://www.litesoc.io/api/v1/collect";
+    this.batching = options.batching ?? true;
+    this.batchSize = options.batchSize ?? 10;
+    this.flushInterval = options.flushInterval ?? 5e3;
+    this.debug = options.debug ?? false;
+    this.silent = options.silent ?? true;
+    this.fetchFn = options.fetch ?? fetch;
+    if (!this.fetchFn) {
+      throw new Error(
+        "LiteSOC: fetch is not available. Please provide a custom fetch implementation."
+      );
+    }
+    this.log("Initialized with endpoint:", this.endpoint);
+  }
+  /**
+   * Track a security event
+   *
+   * @param eventName - The event type (e.g., 'auth.login_failed')
+   * @param options - Event options including actor, IP, and metadata
+   * @returns Promise that resolves when the event is queued or sent
+   *
+   * @example
+   * ```typescript
+   * // Track with full options
+   * await litesoc.track('auth.login_failed', {
+   *   actor: { id: 'user_123', email: 'user@example.com' },
+   *   userIp: '192.168.1.1',
+   *   metadata: { reason: 'invalid_password', attempts: 3 }
+   * });
+   *
+   * // Track with shorthand actor
+   * await litesoc.track('user.created', {
+   *   actor: 'user_456',
+   *   actorEmail: 'newuser@example.com'
+   * });
+   * ```
+   */
+  async track(eventName, options = {}) {
+    try {
+      let actor = null;
+      if (options.actor) {
+        if (typeof options.actor === "string") {
+          actor = { id: options.actor, email: options.actorEmail };
+        } else {
+          actor = {
+            id: options.actor.id,
+            email: options.actor.email || options.actorEmail
+          };
+        }
+      } else if (options.actorEmail) {
+        actor = { id: options.actorEmail, email: options.actorEmail };
+      }
+      const event = {
+        event: eventName,
+        actor,
+        user_ip: options.userIp || null,
+        metadata: {
+          ...options.metadata,
+          // Auto-enrich with SDK info
+          _sdk: "litesoc-node",
+          _sdk_version: "1.0.0",
+          // Include severity if provided
+          ...options.severity ? { _severity: options.severity } : {}
+        },
+        timestamp: options.timestamp instanceof Date ? options.timestamp.toISOString() : options.timestamp || (/* @__PURE__ */ new Date()).toISOString()
+      };
+      this.log("Tracking event:", eventName, event);
+      if (this.batching) {
+        this.queue.push(event);
+        this.log(`Event queued. Queue size: ${this.queue.length}`);
+        if (this.queue.length >= this.batchSize) {
+          await this.flush();
+        } else {
+          this.scheduleFlush();
+        }
+      } else {
+        await this.sendEvents([event]);
+      }
+    } catch (error) {
+      this.handleError("track", error);
+    }
+  }
+  /**
+   * Flush all queued events to the server
+   *
+   * @returns Promise that resolves when all events are sent
+   *
+   * @example
+   * ```typescript
+   * // Flush before application shutdown
+   * process.on('beforeExit', async () => {
+   *   await litesoc.flush();
+   * });
+   * ```
+   */
+  async flush() {
+    if (this.isFlushing) {
+      this.log("Flush already in progress, skipping");
+      return;
+    }
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+    const events = [...this.queue];
+    this.queue = [];
+    if (events.length === 0) {
+      this.log("No events to flush");
+      return;
+    }
+    this.isFlushing = true;
+    this.log(`Flushing ${events.length} events`);
+    try {
+      await this.sendEvents(events);
+    } finally {
+      this.isFlushing = false;
+    }
+  }
+  /**
+   * Get the current queue size
+   *
+   * @returns Number of events in the queue
+   */
+  getQueueSize() {
+    return this.queue.length;
+  }
+  /**
+   * Clear all queued events without sending
+   */
+  clearQueue() {
+    this.queue = [];
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+    this.log("Queue cleared");
+  }
+  /**
+   * Shutdown the SDK gracefully
+   * Flushes remaining events and clears timers
+   */
+  async shutdown() {
+    this.log("Shutting down...");
+    await this.flush();
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+    this.log("Shutdown complete");
+  }
+  // ============================================
+  // CONVENIENCE METHODS
+  // ============================================
+  /**
+   * Track a login failure event
+   */
+  async trackLoginFailed(actorId, options = {}) {
+    return this.track("auth.login_failed", {
+      actor: actorId,
+      ...options
+    });
+  }
+  /**
+   * Track a login success event
+   */
+  async trackLoginSuccess(actorId, options = {}) {
+    return this.track("auth.login_success", {
+      actor: actorId,
+      ...options
+    });
+  }
+  /**
+   * Track a privilege escalation event
+   */
+  async trackPrivilegeEscalation(actorId, options = {}) {
+    return this.track("admin.privilege_escalation", {
+      actor: actorId,
+      severity: "critical",
+      ...options
+    });
+  }
+  /**
+   * Track a sensitive data access event
+   */
+  async trackSensitiveAccess(actorId, resource, options = {}) {
+    return this.track("data.sensitive_access", {
+      actor: actorId,
+      severity: "high",
+      metadata: {
+        resource,
+        ...options.metadata
+      },
+      ...options
+    });
+  }
+  /**
+   * Track a bulk delete event
+   */
+  async trackBulkDelete(actorId, recordCount, options = {}) {
+    return this.track("data.bulk_delete", {
+      actor: actorId,
+      severity: "high",
+      metadata: {
+        records_deleted: recordCount,
+        ...options.metadata
+      },
+      ...options
+    });
+  }
+  /**
+   * Track a role change event
+   */
+  async trackRoleChanged(actorId, oldRole, newRole, options = {}) {
+    return this.track("authz.role_changed", {
+      actor: actorId,
+      metadata: {
+        old_role: oldRole,
+        new_role: newRole,
+        ...options.metadata
+      },
+      ...options
+    });
+  }
+  /**
+   * Track an access denied event
+   */
+  async trackAccessDenied(actorId, resource, options = {}) {
+    return this.track("authz.access_denied", {
+      actor: actorId,
+      metadata: {
+        resource,
+        ...options.metadata
+      },
+      ...options
+    });
+  }
+  // ============================================
+  // PRIVATE METHODS
+  // ============================================
+  /**
+   * Schedule a flush after the flush interval
+   */
+  scheduleFlush() {
+    if (this.flushTimer) return;
+    this.flushTimer = setTimeout(() => {
+      this.flushTimer = null;
+      this.flush().catch((error) => this.handleError("scheduled flush", error));
+    }, this.flushInterval);
+  }
+  /**
+   * Send events to the LiteSOC API
+   */
+  async sendEvents(events) {
+    if (events.length === 0) return;
+    try {
+      const isBatch = events.length > 1;
+      const body = isBatch ? { events } : events[0];
+      const response = await this.fetchFn(this.endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`,
+          "User-Agent": "litesoc-node/1.0.0"
+        },
+        body: JSON.stringify(body)
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`API error ${response.status}: ${errorText}`);
+      }
+      const result = await response.json();
+      if (result.success) {
+        this.log(
+          `Successfully sent ${events.length} event(s)`,
+          isBatch ? `(batch, ${result.events_accepted} accepted)` : ""
+        );
+      } else {
+        throw new Error(result.error || "Unknown API error");
+      }
+    } catch (error) {
+      const retryableEvents = events.filter(
+        (e) => !(e.metadata._retry_count > 2)
+      );
+      if (retryableEvents.length > 0 && this.batching) {
+        this.log(`Re-queuing ${retryableEvents.length} events for retry`);
+        for (const event of retryableEvents) {
+          event.metadata._retry_count = (event.metadata._retry_count || 0) + 1;
+          this.queue.unshift(event);
+        }
+        this.scheduleFlush();
+      }
+      throw error;
+    }
+  }
+  /**
+   * Handle errors based on silent mode
+   */
+  handleError(context, error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    if (this.silent) {
+      this.log(`Error in ${context}: ${message}`);
+    } else {
+      throw error;
+    }
+  }
+  /**
+   * Log debug messages
+   */
+  log(...args) {
+    if (this.debug) {
+      console.log("[LiteSOC]", ...args);
+    }
+  }
+};
+function createLiteSOC(options) {
+  return new LiteSOC(options);
+}
+var index_default = LiteSOC;
+
+exports.LiteSOC = LiteSOC;
+exports.createLiteSOC = createLiteSOC;
+exports.default = index_default;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * LiteSOC Node.js/TypeScript SDK\n * Official SDK for security event tracking and threat detection\n *\n * @packageDocumentation\n */\n\n// ============================================\n// TYPE DEFINITIONS\n// ============================================\n\n/** Fetch function type for cross-environment compatibility */\ntype FetchFunction = (\n  input: string | URL | Request,\n  init?: RequestInit\n) => Promise<Response>;\n\n/**\n * Authentication events\n */\nexport type AuthEvent =\n  | \"auth.login_success\"\n  | \"auth.login_failed\"\n  | \"auth.logout\"\n  | \"auth.password_changed\"\n  | \"auth.password_reset_requested\"\n  | \"auth.password_reset_completed\"\n  | \"auth.mfa_enabled\"\n  | \"auth.mfa_disabled\"\n  | \"auth.mfa_challenge_success\"\n  | \"auth.mfa_challenge_failed\"\n  | \"auth.session_created\"\n  | \"auth.session_revoked\"\n  | \"auth.token_refreshed\"\n  | \"auth.failed\"; // Legacy alias\n\n/**\n * User events\n */\nexport type UserEvent =\n  | \"user.created\"\n  | \"user.updated\"\n  | \"user.deleted\"\n  | \"user.email_changed\"\n  | \"user.email_verified\"\n  | \"user.phone_changed\"\n  | \"user.phone_verified\"\n  | \"user.profile_updated\"\n  | \"user.avatar_changed\"\n  | \"user.login_failed\" // Alternative format\n  | \"user.login.failed\"; // Dot format\n\n/**\n * Authorization events\n */\nexport type AuthzEvent =\n  | \"authz.role_assigned\"\n  | \"authz.role_removed\"\n  | \"authz.role_changed\"\n  | \"authz.permission_granted\"\n  | \"authz.permission_revoked\"\n  | \"authz.access_denied\"\n  | \"authz.access_granted\";\n\n/**\n * Admin events\n */\nexport type AdminEvent =\n  | \"admin.privilege_escalation\"\n  | \"admin.user_impersonation\"\n  | \"admin.settings_changed\"\n  | \"admin.api_key_created\"\n  | \"admin.api_key_revoked\"\n  | \"admin.invite_sent\"\n  | \"admin.invite_accepted\"\n  | \"admin.member_removed\";\n\n/**\n * Data events\n */\nexport type DataEvent =\n  | \"data.export\"\n  | \"data.import\"\n  | \"data.bulk_delete\"\n  | \"data.bulk_update\"\n  | \"data.sensitive_access\"\n  | \"data.download\"\n  | \"data.upload\"\n  | \"data.shared\"\n  | \"data.unshared\";\n\n/**\n * Security events\n */\nexport type SecurityEvent =\n  | \"security.suspicious_activity\"\n  | \"security.rate_limit_exceeded\"\n  | \"security.ip_blocked\"\n  | \"security.ip_unblocked\"\n  | \"security.account_locked\"\n  | \"security.account_unlocked\"\n  | \"security.brute_force_detected\"\n  | \"security.impossible_travel\"\n  | \"security.geo_anomaly\";\n\n/**\n * API events\n */\nexport type ApiEvent =\n  | \"api.key_used\"\n  | \"api.rate_limited\"\n  | \"api.error\"\n  | \"api.webhook_sent\"\n  | \"api.webhook_failed\";\n\n/**\n * Billing events\n */\nexport type BillingEvent =\n  | \"billing.subscription_created\"\n  | \"billing.subscription_updated\"\n  | \"billing.subscription_cancelled\"\n  | \"billing.payment_succeeded\"\n  | \"billing.payment_failed\"\n  | \"billing.invoice_created\"\n  | \"billing.invoice_paid\";\n\n/**\n * All predefined event types\n */\nexport type PredefinedEventType =\n  | AuthEvent\n  | UserEvent\n  | AuthzEvent\n  | AdminEvent\n  | DataEvent\n  | SecurityEvent\n  | ApiEvent\n  | BillingEvent;\n\n/**\n * Custom event type (string pattern: category.action)\n */\nexport type CustomEventType = `${string}.${string}`;\n\n/**\n * All supported event types\n */\nexport type EventType = PredefinedEventType | CustomEventType;\n\n/**\n * Event severity levels\n */\nexport type EventSeverity = \"low\" | \"medium\" | \"high\" | \"critical\";\n\n/**\n * Actor information\n */\nexport interface Actor {\n  /** Unique identifier for the actor (user ID, API key ID, etc.) */\n  id: string;\n  /** Actor's email address (optional) */\n  email?: string;\n}\n\n/**\n * Event metadata (arbitrary key-value pairs)\n */\nexport type EventMetadata = Record<string, unknown>;\n\n/**\n * Options for tracking an event\n */\nexport interface TrackOptions {\n  /** The actor (user) performing the action */\n  actor?: Actor | string;\n  /** Actor's email address (shorthand for actor.email) */\n  actorEmail?: string;\n  /** End-user's IP address (the user making the request) */\n  userIp?: string;\n  /** Event severity (optional, auto-detected for known events) */\n  severity?: EventSeverity;\n  /** Additional metadata for the event */\n  metadata?: EventMetadata;\n  /** Custom timestamp (defaults to now) */\n  timestamp?: Date | string;\n}\n\n/**\n * Internal event structure for the queue\n */\ninterface QueuedEvent {\n  event: EventType;\n  actor: Actor | null;\n  user_ip: string | null;\n  metadata: EventMetadata;\n  timestamp: string;\n}\n\n/**\n * API response structure\n */\ninterface ApiResponse {\n  success: boolean;\n  event_id?: string;\n  events_accepted?: number;\n  error?: string;\n}\n\n/**\n * SDK configuration options\n */\nexport interface LiteSOCOptions {\n  /** Your LiteSOC API key */\n  apiKey: string;\n  /** API endpoint (defaults to https://www.litesoc.io/api/v1/collect) */\n  endpoint?: string;\n  /** Enable batching (defaults to true) */\n  batching?: boolean;\n  /** Batch size before auto-flush (defaults to 10) */\n  batchSize?: number;\n  /** Batch flush interval in milliseconds (defaults to 5000ms) */\n  flushInterval?: number;\n  /** Enable debug logging (defaults to false) */\n  debug?: boolean;\n  /** Fail silently on errors (defaults to true) */\n  silent?: boolean;\n  /** Custom fetch implementation (for Edge runtimes) */\n  fetch?: FetchFunction;\n}\n\n// ============================================\n// LITESOC SDK CLASS\n// ============================================\n\n/**\n * LiteSOC SDK for tracking security events\n *\n * @example\n * ```typescript\n * import { LiteSOC } from 'litesoc';\n *\n * const litesoc = new LiteSOC({ apiKey: 'your-api-key' });\n *\n * // Track a login failure\n * await litesoc.track('auth.login_failed', {\n *   actor: { id: 'user_123', email: 'user@example.com' },\n *   userIp: '192.168.1.1',\n *   metadata: { reason: 'invalid_password' }\n * });\n *\n * // Flush remaining events before shutdown\n * await litesoc.flush();\n * ```\n */\nexport class LiteSOC {\n  private readonly apiKey: string;\n  private readonly endpoint: string;\n  private readonly batching: boolean;\n  private readonly batchSize: number;\n  private readonly flushInterval: number;\n  private readonly debug: boolean;\n  private readonly silent: boolean;\n  private readonly fetchFn: FetchFunction;\n\n  private queue: QueuedEvent[] = [];\n  private flushTimer: ReturnType<typeof globalThis.setTimeout> | null = null;\n  private isFlushing = false;\n\n  /**\n   * Create a new LiteSOC SDK instance\n   *\n   * @param options - SDK configuration options\n   * @throws Error if apiKey is not provided\n   */\n  constructor(options: LiteSOCOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"LiteSOC: apiKey is required\");\n    }\n\n    this.apiKey = options.apiKey;\n    this.endpoint =\n      options.endpoint || \"https://www.litesoc.io/api/v1/collect\";\n    this.batching = options.batching ?? true;\n    this.batchSize = options.batchSize ?? 10;\n    this.flushInterval = options.flushInterval ?? 5000;\n    this.debug = options.debug ?? false;\n    this.silent = options.silent ?? true;\n    this.fetchFn = options.fetch ?? fetch;\n\n    // Validate fetch is available\n    if (!this.fetchFn) {\n      throw new Error(\n        \"LiteSOC: fetch is not available. Please provide a custom fetch implementation.\"\n      );\n    }\n\n    this.log(\"Initialized with endpoint:\", this.endpoint);\n  }\n\n  /**\n   * Track a security event\n   *\n   * @param eventName - The event type (e.g., 'auth.login_failed')\n   * @param options - Event options including actor, IP, and metadata\n   * @returns Promise that resolves when the event is queued or sent\n   *\n   * @example\n   * ```typescript\n   * // Track with full options\n   * await litesoc.track('auth.login_failed', {\n   *   actor: { id: 'user_123', email: 'user@example.com' },\n   *   userIp: '192.168.1.1',\n   *   metadata: { reason: 'invalid_password', attempts: 3 }\n   * });\n   *\n   * // Track with shorthand actor\n   * await litesoc.track('user.created', {\n   *   actor: 'user_456',\n   *   actorEmail: 'newuser@example.com'\n   * });\n   * ```\n   */\n  async track(eventName: EventType, options: TrackOptions = {}): Promise<void> {\n    try {\n      // Normalize actor\n      let actor: Actor | null = null;\n      if (options.actor) {\n        if (typeof options.actor === \"string\") {\n          actor = { id: options.actor, email: options.actorEmail };\n        } else {\n          actor = {\n            id: options.actor.id,\n            email: options.actor.email || options.actorEmail,\n          };\n        }\n      } else if (options.actorEmail) {\n        // If only email is provided, use it as both id and email\n        actor = { id: options.actorEmail, email: options.actorEmail };\n      }\n\n      // Build the event\n      const event: QueuedEvent = {\n        event: eventName,\n        actor,\n        user_ip: options.userIp || null,\n        metadata: {\n          ...options.metadata,\n          // Auto-enrich with SDK info\n          _sdk: \"litesoc-node\",\n          _sdk_version: \"1.0.0\",\n          // Include severity if provided\n          ...(options.severity ? { _severity: options.severity } : {}),\n        },\n        timestamp:\n          options.timestamp instanceof Date\n            ? options.timestamp.toISOString()\n            : options.timestamp || new Date().toISOString(),\n      };\n\n      this.log(\"Tracking event:\", eventName, event);\n\n      if (this.batching) {\n        // Add to queue\n        this.queue.push(event);\n        this.log(`Event queued. Queue size: ${this.queue.length}`);\n\n        // Auto-flush if batch size reached\n        if (this.queue.length >= this.batchSize) {\n          await this.flush();\n        } else {\n          // Schedule flush if not already scheduled\n          this.scheduleFlush();\n        }\n      } else {\n        // Send immediately\n        await this.sendEvents([event]);\n      }\n    } catch (error) {\n      this.handleError(\"track\", error);\n    }\n  }\n\n  /**\n   * Flush all queued events to the server\n   *\n   * @returns Promise that resolves when all events are sent\n   *\n   * @example\n   * ```typescript\n   * // Flush before application shutdown\n   * process.on('beforeExit', async () => {\n   *   await litesoc.flush();\n   * });\n   * ```\n   */\n  async flush(): Promise<void> {\n    // Prevent concurrent flushes\n    if (this.isFlushing) {\n      this.log(\"Flush already in progress, skipping\");\n      return;\n    }\n\n    // Clear scheduled flush\n    if (this.flushTimer) {\n      clearTimeout(this.flushTimer);\n      this.flushTimer = null;\n    }\n\n    // Get events to send\n    const events = [...this.queue];\n    this.queue = [];\n\n    if (events.length === 0) {\n      this.log(\"No events to flush\");\n      return;\n    }\n\n    this.isFlushing = true;\n    this.log(`Flushing ${events.length} events`);\n\n    try {\n      await this.sendEvents(events);\n    } finally {\n      this.isFlushing = false;\n    }\n  }\n\n  /**\n   * Get the current queue size\n   *\n   * @returns Number of events in the queue\n   */\n  getQueueSize(): number {\n    return this.queue.length;\n  }\n\n  /**\n   * Clear all queued events without sending\n   */\n  clearQueue(): void {\n    this.queue = [];\n    if (this.flushTimer) {\n      clearTimeout(this.flushTimer);\n      this.flushTimer = null;\n    }\n    this.log(\"Queue cleared\");\n  }\n\n  /**\n   * Shutdown the SDK gracefully\n   * Flushes remaining events and clears timers\n   */\n  async shutdown(): Promise<void> {\n    this.log(\"Shutting down...\");\n    await this.flush();\n    if (this.flushTimer) {\n      clearTimeout(this.flushTimer);\n      this.flushTimer = null;\n    }\n    this.log(\"Shutdown complete\");\n  }\n\n  // ============================================\n  // CONVENIENCE METHODS\n  // ============================================\n\n  /**\n   * Track a login failure event\n   */\n  async trackLoginFailed(\n    actorId: string,\n    options: Omit<TrackOptions, \"actor\"> = {}\n  ): Promise<void> {\n    return this.track(\"auth.login_failed\", {\n      actor: actorId,\n      ...options,\n    });\n  }\n\n  /**\n   * Track a login success event\n   */\n  async trackLoginSuccess(\n    actorId: string,\n    options: Omit<TrackOptions, \"actor\"> = {}\n  ): Promise<void> {\n    return this.track(\"auth.login_success\", {\n      actor: actorId,\n      ...options,\n    });\n  }\n\n  /**\n   * Track a privilege escalation event\n   */\n  async trackPrivilegeEscalation(\n    actorId: string,\n    options: Omit<TrackOptions, \"actor\"> = {}\n  ): Promise<void> {\n    return this.track(\"admin.privilege_escalation\", {\n      actor: actorId,\n      severity: \"critical\",\n      ...options,\n    });\n  }\n\n  /**\n   * Track a sensitive data access event\n   */\n  async trackSensitiveAccess(\n    actorId: string,\n    resource: string,\n    options: Omit<TrackOptions, \"actor\"> = {}\n  ): Promise<void> {\n    return this.track(\"data.sensitive_access\", {\n      actor: actorId,\n      severity: \"high\",\n      metadata: {\n        resource,\n        ...options.metadata,\n      },\n      ...options,\n    });\n  }\n\n  /**\n   * Track a bulk delete event\n   */\n  async trackBulkDelete(\n    actorId: string,\n    recordCount: number,\n    options: Omit<TrackOptions, \"actor\"> = {}\n  ): Promise<void> {\n    return this.track(\"data.bulk_delete\", {\n      actor: actorId,\n      severity: \"high\",\n      metadata: {\n        records_deleted: recordCount,\n        ...options.metadata,\n      },\n      ...options,\n    });\n  }\n\n  /**\n   * Track a role change event\n   */\n  async trackRoleChanged(\n    actorId: string,\n    oldRole: string,\n    newRole: string,\n    options: Omit<TrackOptions, \"actor\"> = {}\n  ): Promise<void> {\n    return this.track(\"authz.role_changed\", {\n      actor: actorId,\n      metadata: {\n        old_role: oldRole,\n        new_role: newRole,\n        ...options.metadata,\n      },\n      ...options,\n    });\n  }\n\n  /**\n   * Track an access denied event\n   */\n  async trackAccessDenied(\n    actorId: string,\n    resource: string,\n    options: Omit<TrackOptions, \"actor\"> = {}\n  ): Promise<void> {\n    return this.track(\"authz.access_denied\", {\n      actor: actorId,\n      metadata: {\n        resource,\n        ...options.metadata,\n      },\n      ...options,\n    });\n  }\n\n  // ============================================\n  // PRIVATE METHODS\n  // ============================================\n\n  /**\n   * Schedule a flush after the flush interval\n   */\n  private scheduleFlush(): void {\n    if (this.flushTimer) return;\n\n    this.flushTimer = setTimeout(() => {\n      this.flushTimer = null;\n      this.flush().catch((error) => this.handleError(\"scheduled flush\", error));\n    }, this.flushInterval);\n  }\n\n  /**\n   * Send events to the LiteSOC API\n   */\n  private async sendEvents(events: QueuedEvent[]): Promise<void> {\n    if (events.length === 0) return;\n\n    try {\n      // If single event, send directly; otherwise send as batch\n      const isBatch = events.length > 1;\n      const body = isBatch ? { events } : events[0];\n\n      const response = await this.fetchFn(this.endpoint, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Bearer ${this.apiKey}`,\n          \"User-Agent\": \"litesoc-node/1.0.0\",\n        },\n        body: JSON.stringify(body),\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new Error(`API error ${response.status}: ${errorText}`);\n      }\n\n      const result: ApiResponse = await response.json();\n\n      if (result.success) {\n        this.log(\n          `Successfully sent ${events.length} event(s)`,\n          isBatch ? `(batch, ${result.events_accepted} accepted)` : \"\"\n        );\n      } else {\n        throw new Error(result.error || \"Unknown API error\");\n      }\n    } catch (error) {\n      // Re-queue events on failure (with limit to prevent infinite loop)\n      const retryableEvents = events.filter(\n        (e) => !((e.metadata as Record<string, number>)._retry_count > 2)\n      );\n\n      if (retryableEvents.length > 0 && this.batching) {\n        this.log(`Re-queuing ${retryableEvents.length} events for retry`);\n        for (const event of retryableEvents) {\n          (event.metadata as Record<string, number>)._retry_count =\n            ((event.metadata as Record<string, number>)._retry_count || 0) + 1;\n          this.queue.unshift(event);\n        }\n        this.scheduleFlush();\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Handle errors based on silent mode\n   */\n  private handleError(context: string, error: unknown): void {\n    const message =\n      error instanceof Error ? error.message : \"Unknown error\";\n\n    if (this.silent) {\n      this.log(`Error in ${context}: ${message}`);\n    } else {\n      throw error;\n    }\n  }\n\n  /**\n   * Log debug messages\n   */\n  private log(...args: unknown[]): void {\n    if (this.debug) {\n      console.log(\"[LiteSOC]\", ...args);\n    }\n  }\n}\n\n// ============================================\n// FACTORY FUNCTION\n// ============================================\n\n/**\n * Create a new LiteSOC SDK instance\n *\n * @param options - SDK configuration options\n * @returns LiteSOC SDK instance\n *\n * @example\n * ```typescript\n * import { createLiteSOC } from 'litesoc';\n *\n * const litesoc = createLiteSOC({ apiKey: 'your-api-key' });\n * ```\n */\nexport function createLiteSOC(options: LiteSOCOptions): LiteSOC {\n  return new LiteSOC(options);\n}\n\n// ============================================\n// DEFAULT EXPORT\n// ============================================\n\nexport default LiteSOC;\n"]}