reportli 1.0.0

package/README.md

@@ -0,0 +1,116 @@
+# Reportli SDK 🚀
+
+The official, enterprise-grade real-time exception tracking and AI-powered diagnostics SDK for client-side (SPA/Next.js/React/Vue), server-side (Node.js/Express), and full-stack software applications.
+
+---
+
+## Key Features
+
+- **🛡️ 50+ Classified Errors**: Automatically groups and parses crashes including Standard exceptions, React Hydration errors, Invalid Hooks, Stripe Payment failures, database anomalies, CORS issues, Token expirations, and express timeouts.
+- **🌐 Network Hooking**: Transparently intercept Global `fetch` and standard `XMLHttpRequest` transactions to capture API deviations (e.g. 400 Bad Requests, 401 Unauthorized, 404 Not Founds, and 500 Server Crashes).
+- **📂 Resource Validation**: Captures failing third-party style asset downloads, un-resolving JS scripts, font timeouts, and image load errors.
+- **⚡ Async/Rejections Safe**: Hooks deep into the browser thread (`unhandledrejection`) and Node processes (`unhandledRejection`, `uncaughtException`) to record issues before threads exit.
+- **📢 Instant Setup Webhook**: Sells registration success notifications to your telemetry database instantly upon first module configuration.
+
+---
+
+## Installation
+
+Install the package via standard node package managers:
+
+```bash
+npm install reportli
+```
+
+---
+
+## Usage Guide
+
+### 1. Browser/Single-Page Applications & React/Next.js Client (HTML/JS)
+
+Simply import and run the initialization at the main entry file (`src/index.tsx`, `app/layout.tsx` or raw `App.js` blocks):
+
+```typescript
+import { Reportli } from 'reportli';
+
+Reportli.init({
+  apiKey: "YOUR_PROJECT_API_KEY",
+  projectName: "My Customer Portal UI",
+  projectId: "portal-ui",
+  environment: "production",
+  userEmail: "client-agent@domain.com"
+});
+```
+
+### 2. Node.js & Express Backends (Server-Side)
+
+Reportli hooks into your routes to catch server-side crashes and express execution exceptions.
+
+```javascript
+const express = require('express');
+const { Reportli } = require('reportli');
+
+const app = express();
+
+// Initialize the Exception agent
+Reportli.init({
+  apiKey: "YOUR_PROJECT_API_KEY",
+  projectName: "Billing & Subscriptions API",
+  projectId: "billing-api",
+  framework: "Express"
+});
+
+app.use(express.json());
+
+// ... Standard route handlers ...
+app.get("/api/checkout", (req, res) => {
+  throw new Error("Stripe payment processing failed: Card declined"); // Auto-caught & classified!
+});
+
+// Place Reportli Error Handler at the ultimate end of active middleware
+app.use(Reportli.expressErrorHandler);
+
+app.listen(3000);
+```
+
+### 3. Manual Crash Tracking & Custom Severity
+
+Report custom exception payloads with forced severity tiers:
+
+```typescript
+try {
+  initiateComplexDbSync();
+} catch (error) {
+  // Capture manually
+  Reportli.captureException(error, "critical");
+}
+```
+
+---
+
+## Publishing to npmjs.com
+
+Follow these three simple commands to compile, bundle, and release the SDK:
+
+1. **Install Build Dependencies**:
+   ```bash
+   cd reportli-sdk
+   npm install
+   ```
+
+2. **Bundle/Build Package**:
+   ```bash
+   npm run build
+   ```
+   This generates ESM (`dist/index.mjs`), CommonJS (`dist/index.js`), and fully mapped TS definitions (`dist/index.d.ts`).
+
+3. **Publish to Registry**:
+   ```bash
+   npm publish --access public
+   ```
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

package/build.js

@@ -0,0 +1,52 @@
+const esbuild = require("esbuild");
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+async function build() {
+  console.log("🧹 Cleaning dist folder...");
+  const distPath = path.join(__dirname, "dist");
+  if (fs.existsSync(distPath)) {
+    fs.rmSync(distPath, { recursive: true, force: true });
+  }
+
+  console.log("📦 Compiling CommonJS bundle...");
+  await esbuild.build({
+    entryPoints: ["src/index.ts"],
+    outfile: "dist/index.js",
+    bundle: true,
+    platform: "node",
+    format: "cjs",
+    target: "es2020",
+    sourcemap: true,
+    minify: false,
+    external: ["esbuild"],
+  });
+
+  console.log("📦 Compiling ES Module bundle...");
+  await esbuild.build({
+    entryPoints: ["src/index.ts"],
+    outfile: "dist/index.mjs",
+    bundle: true,
+    platform: "neutral",
+    format: "esm",
+    target: "es2020",
+    sourcemap: true,
+    minify: false,
+  });
+
+  console.log("🏷️  Generating TypeScript declaration files...");
+  try {
+    execSync("npx tsc --emitDeclarationOnly --outDir dist", { cwd: __dirname });
+    console.log("✨ TypeScript declarations generated successfully.");
+  } catch (error) {
+    console.error("⚠️ Failed to generate TypeScript declaration files. Proceeding anyway...", error);
+  }
+
+  console.log("🚀 Reportli SDK build completed successfully!");
+}
+
+build().catch((err) => {
+  console.error("❌ Build failed:", err);
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Reportli SDK
+ * Enterprise-grade real-time exception tracking and AI diagnostic companion.
+ */
+export interface ReportliConfig {
+    apiKey: string;
+    projectId?: string;
+    projectName?: string;
+    environment?: string;
+    framework?: string;
+    disableHmrLogging?: boolean;
+    captureUnhandledRejections?: boolean;
+    autoCreateGitHubIssues?: boolean;
+    userEmail?: string;
+}
+export interface ExceptionPayload {
+    apiKey: string;
+    projectId?: string;
+    projectName?: string;
+    errorType: string;
+    errorMessage: string;
+    errorStack: string;
+    framework?: string;
+    user_email?: string;
+    severity?: "low" | "medium" | "high" | "critical";
+    status?: string;
+}
+declare class ReportliTracker {
+    private config;
+    private isInitialized;
+    /**
+     * Initializes the Reportli tracker with your secure project credentials.
+     */
+    init(config: ReportliConfig): void;
+    /**
+     * Manually captures and files a custom application exception with custom severity.
+     */
+    captureException(error: Error | any, severityInput?: "low" | "medium" | "high" | "critical"): void;
+    /**
+     * Express error handler middleware
+     */
+    expressErrorHandler: (err: any, req: any, res: any, next: any) => void;
+    /**
+     * Registers global window listeners for DOM-based exceptions.
+     */
+    private setupBrowserListeners;
+    /**
+     * Registers node process listeners for server instances.
+     */
+    private setupNodeListeners;
+    /**
+     * Safe payload sender with retry limits.
+     */
+    private sendCrashReport;
+    /**
+     * Sends registration verification to user edge function on first install.
+     */
+    private sendRegistrationWebhook;
+    /**
+     * Capture fetch network status deviations.
+     */
+    private interceptFetch;
+    /**
+     * Trace XHR status failures.
+     */
+    private interceptXhr;
+    private logNetworkError;
+    private logNetworkFailure;
+    /**
+     * Helper to safely format raw objects / strings into structured Errors
+     */
+    private normalizeError;
+    /**
+     * Comprehensive classification rules checking substring and classifications
+     */
+    private classifyError;
+}
+export declare const Reportli: ReportliTracker;
+export default Reportli;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,aAAa,CAAS;IAE9B;;OAEG;IACI,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAmCzC;;OAEG;IACI,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI;IAyBzG;;OAEG;IACI,mBAAmB,GAAI,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,KAAG,IAAI,CAyB1E;IAEF;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwH7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqD1B;;OAEG;YACW,eAAe;IAoB7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA+B/B;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2CpB,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAgPtB;AAED,eAAO,MAAM,QAAQ,iBAAwB,CAAC;AAC9C,eAAe,QAAQ,CAAC"}