@simplr-ai/node 1.1.1 → 1.2.0

package/dist/index.d.cts

@@ -1,9 +1,33 @@
+type NetworkSource = "frontend" | "backend";
+interface NetworkLogEntry {
+    id: string;
+    source: NetworkSource;
+    timestamp: string;
+    sdk?: string;
+    applicationId?: string;
+    environment?: string;
+    method: string;
+    url: string;
+    requestHeaders?: Record<string, string>;
+    requestBody?: unknown;
+    status?: number;
+    statusText?: string;
+    responseHeaders?: Record<string, string>;
+    responseBody?: unknown;
+    durationMs?: number;
+    ok?: boolean;
+    error?: string;
+}
+type NetworkLogger = (entry: NetworkLogEntry) => void;
+
 interface HttpConfig {
-    /** Auth headers to send (e.g. { "X-API-Key": "sk_…" } or { Authorization: "Bearer …" }). */
     authHeaders: Record<string, string>;
     baseUrl: string;
     timeoutMs: number;
     fetchImpl: typeof fetch;
+    onNetworkLog?: NetworkLogger;
+    logBodies?: boolean;
+    redactFields?: string[];
 }
 
 type RiskLevel = "low" | "medium" | "high" | "critical";
@@ -25,6 +49,11 @@ interface SimplrOptions {
     timeoutMs?: number;
     /** Override the fetch implementation (defaults to global fetch). */
     fetch?: typeof fetch;
+    onNetworkLog?: NetworkLogger;
+    logBodies?: boolean;
+    redactFields?: string[];
+    shipNetworkLogs?: boolean;
+    applicationId?: string;
 }
 interface CheckInput {
     email?: string;
@@ -274,6 +303,9 @@ interface FlagsOptions {
     refreshIntervalMs?: number;
     timeoutMs?: number;
     fetch?: typeof fetch;
+    onNetworkLog?: NetworkLogger;
+    logBodies?: boolean;
+    redactFields?: string[];
 }
 interface EvalContext {
     userId?: string;
@@ -473,6 +505,27 @@ declare class WebhookVerificationError extends Error {
     constructor(message: string);
 }
 
+interface ShipperConfig {
+    baseUrl: string;
+    apiKey: string;
+    fetchImpl: typeof fetch;
+    sdk: string;
+    applicationId?: string;
+    environment?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+}
+declare class NetworkLogShipper {
+    private readonly cfg;
+    private queue;
+    private timer;
+    constructor(cfg: ShipperConfig);
+    start(): void;
+    add(entry: NetworkLogEntry): void;
+    flush(): Promise<void>;
+    stop(): void;
+}
+
 interface SimplrAdminOptions {
     /** Portal token (JWT) for dashboard/admin operations. */
     token: string;
@@ -564,6 +617,7 @@ declare class Simplr {
     /** Webhook signature helpers (no network). */
     readonly webhooks: typeof webhooks$1;
     private readonly _flags?;
+    private readonly shipper?;
     constructor(options: SimplrOptions);
     /**
      * Server-side feature flags. Requires a `publicKey` in the constructor options
@@ -574,6 +628,8 @@ declare class Simplr {
     check(input: CheckInput): Promise<CheckResult>;
     /** Run up to 100 checks at once. */
     checkBulk(items: CheckInput[]): Promise<BulkResult<CheckResult>>;
+    flushNetworkLogs(): Promise<void>;
+    close(): void;
 }
 
-export { type BindingMode, type BulkResult, type CheckInput, type CheckResult, type CreateDelegationOptions, type DelegationInfo, type DelegationResult, type DelegationStats, type EdgeLogEntry, type EvalContext, type FlagDefinition, type FlagRule, type FlagsOptions, type IdentifyOptions, type OrderInput, type OrderResult, type PhoneOutcome, type PhoneReportInput, type ProfileResult, type ProfileRiskResult, type RUMEvent, type RUMEventBatch, type RUMEventType, type RUMLogLevel, type RiskLevel, Simplr, SimplrAI, SimplrAdmin, type SimplrAdminOptions, SimplrError, SimplrFlags, type SimplrOptions, SimplrProfiles, SimplrRUM, type SimplrRUMConfig, type ValidationResult, WebhookVerificationError, constructEvent as constructWebhookEvent, Simplr as default, verify as verifyWebhook };
+export { type BindingMode, type BulkResult, type CheckInput, type CheckResult, type CreateDelegationOptions, type DelegationInfo, type DelegationResult, type DelegationStats, type EdgeLogEntry, type EvalContext, type FlagDefinition, type FlagRule, type FlagsOptions, type IdentifyOptions, type NetworkLogEntry, NetworkLogShipper, type NetworkLogger, type NetworkSource, type OrderInput, type OrderResult, type PhoneOutcome, type PhoneReportInput, type ProfileResult, type ProfileRiskResult, type RUMEvent, type RUMEventBatch, type RUMEventType, type RUMLogLevel, type RiskLevel, type ShipperConfig, Simplr, SimplrAI, SimplrAdmin, type SimplrAdminOptions, SimplrError, SimplrFlags, type SimplrOptions, SimplrProfiles, SimplrRUM, type SimplrRUMConfig, type ValidationResult, WebhookVerificationError, constructEvent as constructWebhookEvent, Simplr as default, verify as verifyWebhook };

package/dist/index.d.ts

@@ -1,9 +1,33 @@
+type NetworkSource = "frontend" | "backend";
+interface NetworkLogEntry {
+    id: string;
+    source: NetworkSource;
+    timestamp: string;
+    sdk?: string;
+    applicationId?: string;
+    environment?: string;
+    method: string;
+    url: string;
+    requestHeaders?: Record<string, string>;
+    requestBody?: unknown;
+    status?: number;
+    statusText?: string;
+    responseHeaders?: Record<string, string>;
+    responseBody?: unknown;
+    durationMs?: number;
+    ok?: boolean;
+    error?: string;
+}
+type NetworkLogger = (entry: NetworkLogEntry) => void;
+
 interface HttpConfig {
-    /** Auth headers to send (e.g. { "X-API-Key": "sk_…" } or { Authorization: "Bearer …" }). */
     authHeaders: Record<string, string>;
     baseUrl: string;
     timeoutMs: number;
     fetchImpl: typeof fetch;
+    onNetworkLog?: NetworkLogger;
+    logBodies?: boolean;
+    redactFields?: string[];
 }
 
 type RiskLevel = "low" | "medium" | "high" | "critical";
@@ -25,6 +49,11 @@ interface SimplrOptions {
     timeoutMs?: number;
     /** Override the fetch implementation (defaults to global fetch). */
     fetch?: typeof fetch;
+    onNetworkLog?: NetworkLogger;
+    logBodies?: boolean;
+    redactFields?: string[];
+    shipNetworkLogs?: boolean;
+    applicationId?: string;
 }
 interface CheckInput {
     email?: string;
@@ -274,6 +303,9 @@ interface FlagsOptions {
     refreshIntervalMs?: number;
     timeoutMs?: number;
     fetch?: typeof fetch;
+    onNetworkLog?: NetworkLogger;
+    logBodies?: boolean;
+    redactFields?: string[];
 }
 interface EvalContext {
     userId?: string;
@@ -473,6 +505,27 @@ declare class WebhookVerificationError extends Error {
     constructor(message: string);
 }
 
+interface ShipperConfig {
+    baseUrl: string;
+    apiKey: string;
+    fetchImpl: typeof fetch;
+    sdk: string;
+    applicationId?: string;
+    environment?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+}
+declare class NetworkLogShipper {
+    private readonly cfg;
+    private queue;
+    private timer;
+    constructor(cfg: ShipperConfig);
+    start(): void;
+    add(entry: NetworkLogEntry): void;
+    flush(): Promise<void>;
+    stop(): void;
+}
+
 interface SimplrAdminOptions {
     /** Portal token (JWT) for dashboard/admin operations. */
     token: string;
@@ -564,6 +617,7 @@ declare class Simplr {
     /** Webhook signature helpers (no network). */
     readonly webhooks: typeof webhooks$1;
     private readonly _flags?;
+    private readonly shipper?;
     constructor(options: SimplrOptions);
     /**
      * Server-side feature flags. Requires a `publicKey` in the constructor options
@@ -574,6 +628,8 @@ declare class Simplr {
     check(input: CheckInput): Promise<CheckResult>;
     /** Run up to 100 checks at once. */
     checkBulk(items: CheckInput[]): Promise<BulkResult<CheckResult>>;
+    flushNetworkLogs(): Promise<void>;
+    close(): void;
 }
 
-export { type BindingMode, type BulkResult, type CheckInput, type CheckResult, type CreateDelegationOptions, type DelegationInfo, type DelegationResult, type DelegationStats, type EdgeLogEntry, type EvalContext, type FlagDefinition, type FlagRule, type FlagsOptions, type IdentifyOptions, type OrderInput, type OrderResult, type PhoneOutcome, type PhoneReportInput, type ProfileResult, type ProfileRiskResult, type RUMEvent, type RUMEventBatch, type RUMEventType, type RUMLogLevel, type RiskLevel, Simplr, SimplrAI, SimplrAdmin, type SimplrAdminOptions, SimplrError, SimplrFlags, type SimplrOptions, SimplrProfiles, SimplrRUM, type SimplrRUMConfig, type ValidationResult, WebhookVerificationError, constructEvent as constructWebhookEvent, Simplr as default, verify as verifyWebhook };
+export { type BindingMode, type BulkResult, type CheckInput, type CheckResult, type CreateDelegationOptions, type DelegationInfo, type DelegationResult, type DelegationStats, type EdgeLogEntry, type EvalContext, type FlagDefinition, type FlagRule, type FlagsOptions, type IdentifyOptions, type NetworkLogEntry, NetworkLogShipper, type NetworkLogger, type NetworkSource, type OrderInput, type OrderResult, type PhoneOutcome, type PhoneReportInput, type ProfileResult, type ProfileRiskResult, type RUMEvent, type RUMEventBatch, type RUMEventType, type RUMLogLevel, type RiskLevel, type ShipperConfig, Simplr, SimplrAI, SimplrAdmin, type SimplrAdminOptions, SimplrError, SimplrFlags, type SimplrOptions, SimplrProfiles, SimplrRUM, type SimplrRUMConfig, type ValidationResult, WebhookVerificationError, constructEvent as constructWebhookEvent, Simplr as default, verify as verifyWebhook };

package/dist/index.js

@@ -22,17 +22,128 @@ var WebhookVerificationError = class extends Error {
   }
 };
 
+// src/network-log.ts
+var SENSITIVE_HEADERS = /* @__PURE__ */ new Set([
+  "authorization",
+  "cookie",
+  "set-cookie",
+  "x-api-key",
+  "x-auth-token",
+  "x-csrf-token",
+  "x-xsrf-token"
+]);
+var SENSITIVE_KEY_PARTS = [
+  "password",
+  "passwd",
+  "secret",
+  "token",
+  "api_key",
+  "apikey",
+  "authorization",
+  "auth",
+  "credential",
+  "private_key",
+  "card",
+  "cardnumber",
+  "pan",
+  "cvv",
+  "cvc",
+  "ssn",
+  "pin",
+  "otp"
+];
+var MAX_REDACT_DEPTH = 8;
+var MAX_BODY_CHARS = 1e4;
+function isSensitiveKey(key, extraKeys) {
+  const lower = key.toLowerCase();
+  if (extraKeys.some((k) => lower === k.toLowerCase())) return true;
+  return SENSITIVE_KEY_PARTS.some((part) => lower.includes(part));
+}
+function redactDeep(value, extraKeys, depth = 0) {
+  if (depth >= MAX_REDACT_DEPTH) return "[truncated]";
+  if (Array.isArray(value)) return value.map((v) => redactDeep(v, extraKeys, depth + 1));
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, val] of Object.entries(value)) {
+      out[key] = isSensitiveKey(key, extraKeys) ? "[REDACTED]" : redactDeep(val, extraKeys, depth + 1);
+    }
+    return out;
+  }
+  return value;
+}
+function redactHeaders(headers) {
+  if (!headers) return void 0;
+  const out = {};
+  const set = (key, value) => {
+    out[key] = SENSITIVE_HEADERS.has(key.toLowerCase()) ? "[REDACTED]" : value;
+  };
+  if (typeof headers.forEach === "function" && !Array.isArray(headers)) {
+    headers.forEach((value, key) => set(key, value));
+  } else {
+    for (const [key, value] of Object.entries(headers)) {
+      set(key, String(value));
+    }
+  }
+  return out;
+}
+function previewBody(raw, redactFields = []) {
+  if (raw === void 0 || raw === null) return void 0;
+  let value = raw;
+  if (typeof raw === "string") {
+    try {
+      value = JSON.parse(raw);
+    } catch {
+      return raw.length > MAX_BODY_CHARS ? raw.slice(0, MAX_BODY_CHARS) + "\u2026[truncated]" : raw;
+    }
+  }
+  const redacted = redactDeep(value, redactFields);
+  let text;
+  try {
+    text = JSON.stringify(redacted);
+  } catch {
+    return "[unserializable]";
+  }
+  if (text.length > MAX_BODY_CHARS) {
+    return text.slice(0, MAX_BODY_CHARS) + "\u2026[truncated]";
+  }
+  return redacted;
+}
+function newLogId() {
+  const uuid = globalThis?.crypto?.randomUUID;
+  if (typeof uuid === "function") return uuid.call(globalThis.crypto);
+  return `req_${Date.now().toString(36)}${Math.random().toString(36).slice(2, 10)}`;
+}
+
 // src/http.ts
 async function apiRequest(cfg, method, path, body) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), cfg.timeoutMs);
+  const url = `${cfg.baseUrl}${path}`;
+  const requestHeaders = {
+    "Content-Type": "application/json",
+    ...cfg.authHeaders
+  };
+  const startedAt = Date.now();
+  const log = cfg.onNetworkLog ? {
+    id: newLogId(),
+    source: "backend",
+    timestamp: new Date(startedAt).toISOString(),
+    method,
+    url,
+    requestHeaders: redactHeaders(requestHeaders),
+    requestBody: cfg.logBodies ? previewBody(body, cfg.redactFields) : void 0
+  } : null;
+  const emit = (extra) => {
+    if (!log || !cfg.onNetworkLog) return;
+    try {
+      cfg.onNetworkLog({ ...log, durationMs: Date.now() - startedAt, ...extra });
+    } catch {
+    }
+  };
   try {
-    const res = await cfg.fetchImpl(`${cfg.baseUrl}${path}`, {
+    const res = await cfg.fetchImpl(url, {
       method,
-      headers: {
-        "Content-Type": "application/json",
-        ...cfg.authHeaders
-      },
+      headers: requestHeaders,
       body: body !== void 0 ? JSON.stringify(body) : void 0,
       signal: controller.signal
     });
@@ -43,6 +154,13 @@ async function apiRequest(cfg, method, path, body) {
     } catch {
       parsed = text;
     }
+    emit({
+      status: res.status,
+      statusText: res.statusText,
+      ok: res.ok,
+      responseHeaders: redactHeaders(res.headers),
+      responseBody: cfg.logBodies ? previewBody(parsed ?? text, cfg.redactFields) : void 0
+    });
     if (!res.ok) {
       const message = parsed && (parsed.message || parsed.error) || `Simplr API error ${res.status}`;
       throw new SimplrError(message, res.status, parsed);
@@ -51,14 +169,68 @@ async function apiRequest(cfg, method, path, body) {
   } catch (err) {
     if (err instanceof SimplrError) throw err;
     if (err instanceof Error && err.name === "AbortError") {
+      emit({ ok: false, error: `timed out after ${cfg.timeoutMs}ms` });
       throw new SimplrError(`Request to ${path} timed out after ${cfg.timeoutMs}ms`, 0, null);
     }
+    emit({ ok: false, error: err instanceof Error ? err.message : "Network error" });
     throw new SimplrError(err instanceof Error ? err.message : "Network error", 0, null);
   } finally {
     clearTimeout(timer);
   }
 }
 
+// src/network-shipper.ts
+var DEFAULT_BATCH = 25;
+var DEFAULT_FLUSH_MS = 5e3;
+var NetworkLogShipper = class {
+  cfg;
+  queue = [];
+  timer = null;
+  constructor(cfg) {
+    this.cfg = cfg;
+  }
+  start() {
+    if (this.timer) return;
+    const interval = this.cfg.flushIntervalMs ?? DEFAULT_FLUSH_MS;
+    this.timer = setInterval(() => {
+      void this.flush();
+    }, interval);
+    this.timer?.unref?.();
+  }
+  add(entry) {
+    this.queue.push({
+      ...entry,
+      sdk: this.cfg.sdk,
+      applicationId: entry.applicationId ?? this.cfg.applicationId,
+      environment: entry.environment ?? this.cfg.environment
+    });
+    if (this.queue.length >= (this.cfg.batchSize ?? DEFAULT_BATCH)) {
+      void this.flush();
+    }
+  }
+  async flush() {
+    if (this.queue.length === 0) return;
+    const logs = this.queue;
+    this.queue = [];
+    try {
+      await this.cfg.fetchImpl(`${this.cfg.baseUrl}/v1/network-logs`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": this.cfg.apiKey
+        },
+        body: JSON.stringify({ logs })
+      });
+    } catch {
+    }
+  }
+  stop() {
+    if (this.timer) clearInterval(this.timer);
+    this.timer = null;
+    void this.flush();
+  }
+};
+
 // src/resources.ts
 var OrdersResource = class {
   constructor(cfg) {
@@ -161,7 +333,10 @@ var SimplrFlags = class {
       authHeaders: { "X-API-Key": options.publicKey },
       baseUrl: (options.baseUrl || "https://api.simplr.sh").replace(/\/+$/, ""),
       timeoutMs: options.timeoutMs ?? 15e3,
-      fetchImpl: options.fetch ?? globalThis.fetch
+      fetchImpl: options.fetch ?? globalThis.fetch,
+      onNetworkLog: options.onNetworkLog,
+      logBodies: options.logBodies,
+      redactFields: options.redactFields
     };
     this.environment = options.environment;
     this.refreshIntervalMs = options.refreshIntervalMs ?? 6e4;
@@ -663,13 +838,34 @@ var Simplr = class {
   /** Webhook signature helpers (no network). */
   webhooks = webhooks_exports;
   _flags;
+  shipper;
   constructor(options) {
     if (!options?.apiKey) throw new Error("Simplr: `apiKey` is required");
+    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, "");
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (options.shipNetworkLogs) {
+      this.shipper = new NetworkLogShipper({
+        baseUrl,
+        apiKey: options.apiKey,
+        fetchImpl,
+        sdk: "node",
+        applicationId: options.applicationId,
+        environment: options.environment
+      });
+      this.shipper.start();
+    }
+    const onNetworkLog = this.shipper || options.onNetworkLog ? (entry) => {
+      this.shipper?.add(entry);
+      options.onNetworkLog?.(entry);
+    } : void 0;
     this.cfg = {
       authHeaders: { "X-API-Key": options.apiKey },
-      baseUrl: (options.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, ""),
+      baseUrl,
       timeoutMs: options.timeoutMs ?? 15e3,
-      fetchImpl: options.fetch ?? globalThis.fetch
+      fetchImpl,
+      onNetworkLog,
+      logBodies: options.logBodies ?? options.shipNetworkLogs,
+      redactFields: options.redactFields
     };
     if (typeof this.cfg.fetchImpl !== "function") {
       throw new Error("Simplr: no global fetch available \u2014 use Node 18+ or pass `fetch` in options");
@@ -686,7 +882,10 @@ var Simplr = class {
         environment: options.environment,
         baseUrl: this.cfg.baseUrl,
         timeoutMs: this.cfg.timeoutMs,
-        fetch: this.cfg.fetchImpl
+        fetch: this.cfg.fetchImpl,
+        onNetworkLog: this.cfg.onNetworkLog,
+        logBodies: this.cfg.logBodies,
+        redactFields: options.redactFields
       });
     }
   }
@@ -710,9 +909,17 @@ var Simplr = class {
   checkBulk(items) {
     return apiRequest(this.cfg, "POST", "/v1/check/bulk", { items });
   }
+  flushNetworkLogs() {
+    return this.shipper?.flush() ?? Promise.resolve();
+  }
+  close() {
+    this.shipper?.stop();
+    this._flags?.dispose();
+  }
 };
 var src_default = Simplr;
 export {
+  NetworkLogShipper,
   Simplr,
   SimplrAI,
   SimplrAdmin,