@bugmail-js/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MarcorpAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# Shared core logic for BugMail SDKs
+
+This package will contain shared logic for Node.js and Django SDKs.

package/breadcrumb-tracker.js

@@ -0,0 +1,66 @@
+/**
+ * Breadcrumb Tracker (core, generic)
+ * Records user actions and events leading up to errors
+ */
+
+/**
+ * @typedef {Object} Breadcrumb
+ * @property {string} type - Type of breadcrumb (navigation, click, error, etc.)
+ * @property {string} category - Category (ui, network, user, etc.)
+ * @property {string} message - Description of the event
+ * @property {Object} [data] - Additional contextual data
+ * @property {number} timestamp - When the breadcrumb occurred
+ * @property {string} [level] - Severity level (info, warning, error)
+ */
+
+export class BreadcrumbTracker {
+  constructor(config = {}) {
+    this.config = {
+      maxBreadcrumbs: 50,
+      ...config
+    };
+    this.breadcrumbs = [];
+  }
+
+  record(breadcrumb) {
+    const newBreadcrumb = {
+      timestamp: Date.now(),
+      level: 'info',
+      ...breadcrumb
+    };
+    this.breadcrumbs.push(newBreadcrumb);
+    if (this.breadcrumbs.length > this.config.maxBreadcrumbs) {
+      this.breadcrumbs = this.breadcrumbs.slice(-this.config.maxBreadcrumbs);
+    }
+  }
+
+  recordCustom(message, category = 'custom', data = {}, level = 'info') {
+    this.record({
+      type: 'custom',
+      category,
+      message,
+      data,
+      level
+    });
+  }
+
+  recordRequest(requestData) {
+    this.record({
+      type: 'http',
+      category: 'network',
+      message: `${requestData.method || 'GET'} ${requestData.url}`,
+      data: requestData,
+      level: requestData.error ? 'error' : 
+             requestData.status >= 400 ? 'error' :
+             requestData.status >= 300 ? 'warning' : 'info'
+    });
+  }
+
+  getBreadcrumbs() {
+    return [...this.breadcrumbs];
+  }
+
+  clear() {
+    this.breadcrumbs = [];
+  }
+}

package/bugmail-core-client.d.ts

@@ -0,0 +1,4 @@
+export declare class BugMailCoreClient {
+  constructor(config?: any);
+  captureException(error: any, context?: any): void;
+}

package/bugmail-core-client.js

@@ -0,0 +1,58 @@
+// Core BugMail client (shared logic)
+// Extracted from browser SDK
+
+export class BugMailCoreClient {
+  constructor(config = {}) {
+    this.config = { ...config };
+    // config.baseUrl (default: 'http://localhost:8000')
+    // config.apiPath (default: '/api/sdk/v1/errors')
+    // config.onError (optional callback)
+  }
+
+  /**
+   * Capture and report an exception to the BugMail backend
+   * @param {Error|any} error - The error object
+   * @param {Object} context - { headers, payload, ... }
+   */
+  async captureException(error, context = {}) {
+    const baseUrl = this.config.baseUrl || process.env.BUGMAIL_API_BASE_URL || 'http://localhost:8000';
+    const apiPath = this.config.apiPath || '/api/sdk/v1/errors';
+    const url = baseUrl.replace(/\/$/, '') + apiPath;
+    const headers = {
+      'Content-Type': 'application/json',
+      ...(context.headers || {})
+    };
+    const payload = context.payload || {};
+
+    try {
+      // Use fetch if available (browser or Node >=18), else fallback
+      let fetchFn = (typeof fetch !== 'undefined') ? fetch : undefined;
+      if (!fetchFn) {
+        try {
+          // Dynamically import node-fetch if not in browser
+          fetchFn = (await import('node-fetch')).default;
+        } catch (e) {
+          console.error('[BugMail] fetch is not available in this environment.');
+          return;
+        }
+      }
+      const res = await fetchFn(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(payload),
+      });
+      if (!res.ok) {
+        const errText = await res.text();
+        console.error(`[BugMail] Failed to report error: ${res.status} ${res.statusText}\n${errText}`);
+        if (typeof this.config.onError === 'function') {
+          this.config.onError({ error, payload, status: res.status, statusText: res.statusText, body: errText });
+        }
+      }
+    } catch (err) {
+      console.error('[BugMail] Error sending error report:', err);
+      if (typeof this.config.onError === 'function') {
+        this.config.onError({ error, payload, exception: err });
+      }
+    }
+  }
+}

package/error-grouping.js

@@ -0,0 +1,4 @@
+// Error grouping utility (core)
+export function generateErrorFingerprint(error) {
+  // ...core logic
+}

package/error-processor.js

@@ -0,0 +1,5 @@
+// Error processor (core, no browser specifics)
+export class CoreErrorProcessor {
+  constructor() {}
+  // ...core error normalization, stack trace parsing
+}

package/index.d.ts

@@ -0,0 +1,8 @@
+export * from './bugmail-core-client';
+declare module '@bugmail-js/core' {
+  export class BugMailCore {
+    constructor(config: any);
+    captureException(error: any, context?: any): void;
+  }
+  export type BugMailConfig = any;
+}

package/index.js

@@ -0,0 +1,10 @@
+// Core logic for BugMail SDK (shared between browser, node, etc)
+// This will be populated by extracting reusable logic from browser SDK.
+
+export { BugMailCoreClient } from './bugmail-core-client.js';
+export { CoreNetworkManager } from './network-manager.js';
+export { CoreErrorProcessor } from './error-processor.js';
+export { CorePluginManager } from './plugin-manager.js';
+export { BreadcrumbTracker } from './breadcrumb-tracker.js';
+export * from './error-grouping.js';
+export * from './source-map.js';

package/network-manager.js

@@ -0,0 +1,8 @@
+// Network manager (core, no browser specifics)
+export class CoreNetworkManager {
+  constructor(config) {
+    this.config = config;
+    // ...core setup (no window, no localStorage)
+  }
+  // ...core methods (send, retry, queue, etc)
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@bugmail-js/core",
+  "version": "0.1.0",
+  "main": "index.js",
+  "module": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./bugmail-core-client": "./bugmail-core-client.js",
+    "./network-manager": "./network-manager.js",
+    "./error-processor": "./error-processor.js",
+    "./plugin-manager": "./plugin-manager.js",
+    "./breadcrumb-tracker": "./breadcrumb-tracker.js",
+    "./error-grouping": "./error-grouping.js",
+    "./source-map": "./source-map.js"
+  },
+  "description": "Core utilities for the BugMail SDK (framework-agnostic)",
+  "license": "MIT",
+  "types": "index.d.ts",
+  "files": [
+    "*.js",
+    "*.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MarcorpAI/Bugmail-SDKs.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/MarcorpAI/Bugmail-SDKs#readme",
+  "bugs": {
+    "url": "https://github.com/MarcorpAI/Bugmail-SDKs/issues"
+  },
+  "sideEffects": false
+}

package/plugin-manager.js

@@ -0,0 +1,7 @@
+// Plugin manager (core, generic)
+export class CorePluginManager {
+  constructor() {
+    // ...core plugin system
+  }
+  // ...core methods
+}

package/source-map.js

@@ -0,0 +1,4 @@
+// Source map utility (core)
+export function parseStackTrace(stack) {
+  // ...core logic
+}