@concordiq/error-sdk 1.0.3 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@concordiq/error-sdk",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "private": false,
   "description": "Error monitoring SDK",
   "type": "module",

package/readMe.md

@@ -54,16 +54,170 @@ import express from "express";
 import ErrorSDK from "@concordiq/error-sdk";
 ----
 const app = express();
-
+``
 app.use("/pay", (req, res) => {
   throw new Error("Payment failed");
 });
+``
 
 /**
  * Must be last middleware
  */
+
+ ``
+app.use(ErrorSDK.expressMiddleware());
+
+
+
+✅ Default Import (Most Common)
+import ErrorSDK from "@concordiq/error-sdk";
+
+
+ErrorSDK.init({...});
+
+
+
+✅ Named Import (Tree-shaking)
+import { init, capture } from "@concordiq/error-sdk";
+
+init({...});
+
+
+
+✅ CommonJS
+const ErrorSDK = require("@concordiq/error-sdk");
+
+
+
+✅ Dynamic Import
+const sdk = await import("@concordiq/error-sdk");
+
+
+
+
+#
+import express, {
+  Request,
+  Response,
+  NextFunction
+} from "express";
+
+
+
+import ErrorSDK from "@concordiq/error-sdk";
+
+const app = express();
+
+/**
+ * Initialize once (on app startup)
+ */
+
+
+ErrorSDK.init({
+  apiKey: "coiq-6ddfeede1d57a268f7131ef0597624200a8a02b7",
+
+  endpoint: "https://concordiq.onrender.com/api/v1/ingest/events",
+
+  env: "production",
+
+  service: "payment-api"
+});
+
+
+/**
+ * Express error handler (optional custom)
+ */
+
+
+export function expressHandler() {
+  return (
+    err: Error,
+    req: Request,
+    res: Response,
+    next: NextFunction
+  ) => {
+    ErrorSDK.capture(err, {
+      url: req.originalUrl,
+      method: req.method,
+      user: (req as any).user?.id
+    });
+
+    next(err);
+  };
+}
+
+/**
+ * Register middleware (MUST be last)
+ */
+
+
 app.use(ErrorSDK.expressMiddleware());
 
+console.log("ErrorSDK loaded:", ErrorSDK);
+#
+
+
+
+`✅ Basic Usage in a Controller/Services (Recommended Way):`
+``using this SDK inside controllers/services is actually the best practice, especially for business-logic errors.``
+
+import { Request, Response, NextFunction } from "express";
+import ErrorSDK from "@concordiq/error-sdk";
+
+export const createPayment = async (
+  req: Request,
+  res: Response,
+  next: NextFunction
+) => {
+  try {
+    // Your logic
+    const { amount } = req.body;
+
+    if (!amount) {
+      throw new Error("Amount is required");
+    }
+
+    // Simulate error
+    if (amount < 100) {
+      throw new Error("Minimum payment is 100");
+    }
+
+    res.status(201).json({
+      success: true,
+      message: "Payment created"
+    });
+
+  } catch (err) {
+    /**
+     * Capture error manually
+     */
+    ErrorSDK.capture(err as Error, {
+      controller: "createPayment",
+      user: (req as any).user?.id,
+      body: req.body
+    });
+
+    /**
+     * Pass to global handler
+     */
+    next(err);
+  }
+};
+
+
+`✅ Why This SDK Is Best for you:`
+
+`This gives you:`
+
+`✔ Controller name`
+`✔ User info`
+`✔ Request data`
+`✔ Business context`
+`✔ Stack trace`
+`✔ Global error handling`
+
+`Your dashboard becomes very useful.`
+
 
 
 ## Features:

package/src/client.js

@@ -1,3 +1,24 @@
+// import fetch from "node-fetch";
+
+// export async function sendError(apiKey, url, payload) {
+//   try {
+//     await fetch(url, {
+//       method: "POST",
+
+//       headers: {
+//         "Content-Type": "application/json",
+//         "x-api-key": apiKey
+//       },
+
+//       body: JSON.stringify(payload)
+//     });
+//   } catch (err) {
+//     // Never crash client app
+//     console.error("SDK Send Failed:", err.message);
+//   }
+// }
+
+
 import fetch from "node-fetch";
 
 /**
@@ -10,7 +31,8 @@ export async function sendError(apiKey, endpoint, payload) {
 
       headers: {
         "Content-Type": "application/json",
-        Authorization: apiKey
+        "Authorization": apiKey,
+        "x-api-key": apiKey
       },
 
       body: JSON.stringify(payload)

package/src/handlers.js

@@ -1,14 +1,48 @@
-import { capture } from "./index.js";
-
-/**
- * Attach process-level handlers
- */
-export function attachHandlers() {
-  process.on("uncaughtException", (err) => {
-    capture(err);
+import { sendError } from "./client.js";
+
+export function attachHandlers(config) {
+  // Promise errors
+  process.on("unhandledRejection", err => {
+    report(err, config);
   });
 
-  process.on("unhandledRejection", (err) => {
-    capture(err);
+  // Crash errors
+  process.on("uncaughtException", err => {
+    report(err, config);
   });
-}
+}
+
+function report(err, config) {
+  const payload = {
+    message: err.message,
+    stack: err.stack,
+    type: "system",
+
+    service: config.service,
+    env: config.env,
+
+    timestamp: new Date()
+  };
+
+  sendError(
+    config.apiKey,
+    config.endpoint,
+    payload
+  );
+}
+
+
+// import { capture } from "./index.js";
+
+// /**
+//  * Attach process-level handlers
+//  */
+// export function attachHandlers() {
+//   process.on("uncaughtException", (err) => {
+//     capture(err);
+//   });
+
+//   process.on("unhandledRejection", (err) => {
+//     capture(err);
+//   });
+// }

package/src/index.js

@@ -1,16 +1,13 @@
 import { expressMiddleware } from "./middleware.js";
-import { sendError } from "./client.js";
 import { attachHandlers } from "./handlers.js";
+import { sendError } from "./client.js";
 import { getMeta } from "./utils.js";
 
 let config = null;
 
-/**
- * Initialize SDK
- */
 function init(options) {
-  if (!options?.apiKey) {
-    throw new Error("apiKey is required");
+  if (!options.apiKey) {
+    throw new Error("apiKey required");
   }
 
   config = {
@@ -28,16 +25,12 @@ function init(options) {
   attachHandlers(config);
 }
 
-/**
- * Capture error manually
- */
 async function capture(error, extra = {}) {
   if (!config) return;
 
   const payload = {
-    message: error?.message || String(error),
-
-    stack: error?.stack,
+    message: error.message || error,
+    stack: error.stack,
 
     type: "manual",
 
@@ -49,7 +42,7 @@ async function capture(error, extra = {}) {
       ...extra
     },
 
-    timestamp: new Date().toISOString()
+    timestamp: new Date()
   };
 
   await sendError(
@@ -65,8 +58,84 @@ export {
   expressMiddleware
 };
 
+
 export default {
   init,
   capture,
   expressMiddleware
-};
+};
+
+
+
+// import { expressMiddleware } from "./middleware.js";
+// import { sendError } from "./client.js";
+// import { attachHandlers } from "./handlers.js";
+// import { getMeta } from "./utils.js";
+
+// let config = null;
+
+// /**
+//  * Initialize SDK
+//  */
+// function init(options) {
+//   if (!options?.apiKey) {
+//     throw new Error("apiKey is required");
+//   }
+
+//   config = {
+//     apiKey: options.apiKey,
+
+//     endpoint:
+//       options.endpoint ||
+//       "https://concordiq.onrender.com/api/v1/ingest/events",
+
+//     env: options.env || "production",
+
+//     service: options.service || "app"
+//   };
+
+//   attachHandlers(config);
+// }
+
+// /**
+//  * Capture error manually
+//  */
+// async function capture(error, extra = {}) {
+//   if (!config) return;
+
+//   const payload = {
+//     message: error?.message || String(error),
+
+//     stack: error?.stack,
+
+//     type: "manual",
+
+//     env: config.env,
+//     service: config.service,
+
+//     meta: {
+//       ...getMeta(),
+//       ...extra
+//     },
+
+//     timestamp: new Date().toISOString()
+//   };
+
+//   await sendError(
+//     config.apiKey,
+//     config.endpoint,
+//     payload
+//   );
+// }
+
+// export {
+//   init,
+//   capture,
+//   expressMiddleware
+// };
+
+// export default {
+//   init,
+//   capture,
+//   expressMiddleware
+// };