@devmoods/sentry 0.2.0

package/coverage/sorter.js

@@ -0,0 +1,210 @@
+/* eslint-disable */
+var addSorting = (function() {
+    'use strict';
+    var cols,
+        currentSort = {
+            index: 0,
+            desc: false
+        };
+
+    // returns the summary table element
+    function getTable() {
+        return document.querySelector('.coverage-summary');
+    }
+    // returns the thead element of the summary table
+    function getTableHeader() {
+        return getTable().querySelector('thead tr');
+    }
+    // returns the tbody element of the summary table
+    function getTableBody() {
+        return getTable().querySelector('tbody');
+    }
+    // returns the th element for nth column
+    function getNthColumn(n) {
+        return getTableHeader().querySelectorAll('th')[n];
+    }
+
+    function onFilterInput() {
+        const searchValue = document.getElementById('fileSearch').value;
+        const rows = document.getElementsByTagName('tbody')[0].children;
+
+        // Try to create a RegExp from the searchValue. If it fails (invalid regex),
+        // it will be treated as a plain text search
+        let searchRegex;
+        try {
+            searchRegex = new RegExp(searchValue, 'i'); // 'i' for case-insensitive
+        } catch (error) {
+            searchRegex = null;
+        }
+
+        for (let i = 0; i < rows.length; i++) {
+            const row = rows[i];
+            let isMatch = false;
+
+            if (searchRegex) {
+                // If a valid regex was created, use it for matching
+                isMatch = searchRegex.test(row.textContent);
+            } else {
+                // Otherwise, fall back to the original plain text search
+                isMatch = row.textContent
+                    .toLowerCase()
+                    .includes(searchValue.toLowerCase());
+            }
+
+            row.style.display = isMatch ? '' : 'none';
+        }
+    }
+
+    // loads the search box
+    function addSearchBox() {
+        var template = document.getElementById('filterTemplate');
+        var templateClone = template.content.cloneNode(true);
+        templateClone.getElementById('fileSearch').oninput = onFilterInput;
+        template.parentElement.appendChild(templateClone);
+    }
+
+    // loads all columns
+    function loadColumns() {
+        var colNodes = getTableHeader().querySelectorAll('th'),
+            colNode,
+            cols = [],
+            col,
+            i;
+
+        for (i = 0; i < colNodes.length; i += 1) {
+            colNode = colNodes[i];
+            col = {
+                key: colNode.getAttribute('data-col'),
+                sortable: !colNode.getAttribute('data-nosort'),
+                type: colNode.getAttribute('data-type') || 'string'
+            };
+            cols.push(col);
+            if (col.sortable) {
+                col.defaultDescSort = col.type === 'number';
+                colNode.innerHTML =
+                    colNode.innerHTML + '<span class="sorter"></span>';
+            }
+        }
+        return cols;
+    }
+    // attaches a data attribute to every tr element with an object
+    // of data values keyed by column name
+    function loadRowData(tableRow) {
+        var tableCols = tableRow.querySelectorAll('td'),
+            colNode,
+            col,
+            data = {},
+            i,
+            val;
+        for (i = 0; i < tableCols.length; i += 1) {
+            colNode = tableCols[i];
+            col = cols[i];
+            val = colNode.getAttribute('data-value');
+            if (col.type === 'number') {
+                val = Number(val);
+            }
+            data[col.key] = val;
+        }
+        return data;
+    }
+    // loads all row data
+    function loadData() {
+        var rows = getTableBody().querySelectorAll('tr'),
+            i;
+
+        for (i = 0; i < rows.length; i += 1) {
+            rows[i].data = loadRowData(rows[i]);
+        }
+    }
+    // sorts the table using the data for the ith column
+    function sortByIndex(index, desc) {
+        var key = cols[index].key,
+            sorter = function(a, b) {
+                a = a.data[key];
+                b = b.data[key];
+                return a < b ? -1 : a > b ? 1 : 0;
+            },
+            finalSorter = sorter,
+            tableBody = document.querySelector('.coverage-summary tbody'),
+            rowNodes = tableBody.querySelectorAll('tr'),
+            rows = [],
+            i;
+
+        if (desc) {
+            finalSorter = function(a, b) {
+                return -1 * sorter(a, b);
+            };
+        }
+
+        for (i = 0; i < rowNodes.length; i += 1) {
+            rows.push(rowNodes[i]);
+            tableBody.removeChild(rowNodes[i]);
+        }
+
+        rows.sort(finalSorter);
+
+        for (i = 0; i < rows.length; i += 1) {
+            tableBody.appendChild(rows[i]);
+        }
+    }
+    // removes sort indicators for current column being sorted
+    function removeSortIndicators() {
+        var col = getNthColumn(currentSort.index),
+            cls = col.className;
+
+        cls = cls.replace(/ sorted$/, '').replace(/ sorted-desc$/, '');
+        col.className = cls;
+    }
+    // adds sort indicators for current column being sorted
+    function addSortIndicators() {
+        getNthColumn(currentSort.index).className += currentSort.desc
+            ? ' sorted-desc'
+            : ' sorted';
+    }
+    // adds event listeners for all sorter widgets
+    function enableUI() {
+        var i,
+            el,
+            ithSorter = function ithSorter(i) {
+                var col = cols[i];
+
+                return function() {
+                    var desc = col.defaultDescSort;
+
+                    if (currentSort.index === i) {
+                        desc = !currentSort.desc;
+                    }
+                    sortByIndex(i, desc);
+                    removeSortIndicators();
+                    currentSort.index = i;
+                    currentSort.desc = desc;
+                    addSortIndicators();
+                };
+            };
+        for (i = 0; i < cols.length; i += 1) {
+            if (cols[i].sortable) {
+                // add the click event handler on the th so users
+                // dont have to click on those tiny arrows
+                el = getNthColumn(i).querySelector('.sorter').parentElement;
+                if (el.addEventListener) {
+                    el.addEventListener('click', ithSorter(i));
+                } else {
+                    el.attachEvent('onclick', ithSorter(i));
+                }
+            }
+        }
+    }
+    // adds sorting functionality to the UI
+    return function() {
+        if (!getTable()) {
+            return;
+        }
+        cols = loadColumns();
+        loadData();
+        addSearchBox();
+        addSortIndicators();
+        enableUI();
+    };
+})();
+
+window.addEventListener('load', addSorting);

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { type LoggerAdapter } from '@devmoods/observability';
+import * as Sentry from '@sentry/node';
+import { type ErrorRequestHandler } from 'express';
+declare module '@devmoods/config' {
+    interface Config extends ConfigFromDefs<typeof sentryConfig> {
+    }
+}
+export declare const sentryConfig: import("@devmoods/config").Defs<{
+    SENTRY_DSN: string;
+    SENTRY_TRACES_SAMPLE_RATE: number;
+    SENTRY_PROFILES_SAMPLE_RATE: number;
+    SENTRY_EVENT_LOOP_THRESHOLD: number;
+}>;
+export type { Sentry };
+export interface SentryOptions extends Sentry.NodeOptions {
+}
+export declare function initSentry(options?: SentryOptions): Promise<void>;
+export declare function closeSentry(): Promise<void>;
+export declare function sentryOptions(options?: SentryOptions): Promise<SentryOptions>;
+export declare function sentryErrorHandler(options?: Sentry.NodeOptions): ErrorRequestHandler;
+export declare class SentryLoggerAdapter implements LoggerAdapter {
+    constructor();
+    captureError(error: Error | null, attributes?: Record<string, any>): void;
+    write(log: Record<string, any>): boolean;
+}

package/dist/index.js

@@ -0,0 +1,87 @@
+import { config, define, t } from '@devmoods/config';
+import {} from '@devmoods/observability';
+import * as Sentry from '@sentry/node';
+import {} from 'express';
+export const sentryConfig = define({
+    SENTRY_DSN: t.string(),
+    SENTRY_TRACES_SAMPLE_RATE: t.number(0.3),
+    SENTRY_PROFILES_SAMPLE_RATE: t.number(0.3),
+    SENTRY_EVENT_LOOP_THRESHOLD: t.number(750),
+});
+/* c8 ignore start */
+export async function initSentry(options = {}) {
+    Sentry.init(await sentryOptions(options));
+}
+export async function closeSentry() {
+    await Sentry.close(5000);
+}
+/* c8 ignore end */
+/**
+ * Safely imports native Sentry integrations if available.
+ * Returns null if native modules are not available (e.g., on unsupported Node.js versions).
+ */
+async function getNativeIntegrations() {
+    const integrations = [];
+    /* v8 ignore next -- @preserve */
+    try {
+        const { nodeProfilingIntegration } = await import('@sentry/profiling-node');
+        integrations.push(nodeProfilingIntegration());
+    }
+    catch {
+        // Native profiling integration not available
+    }
+    /* v8 ignore next -- @preserve */
+    try {
+        const { eventLoopBlockIntegration } = await import('@sentry/node-native');
+        integrations.push(eventLoopBlockIntegration({
+            threshold: config.SENTRY_EVENT_LOOP_THRESHOLD,
+        }));
+    }
+    catch {
+        // Native event loop integration not available
+    }
+    return integrations;
+}
+export async function sentryOptions(options = {}) {
+    const nativeIntegrations = await getNativeIntegrations();
+    return {
+        dsn: config.SENTRY_DSN,
+        tracesSampleRate: config.SENTRY_TRACES_SAMPLE_RATE,
+        profileSessionSampleRate: config.SENTRY_PROFILES_SAMPLE_RATE,
+        integrations: nativeIntegrations,
+        enableLogs: true,
+        ...options,
+    };
+}
+export function sentryErrorHandler(options = {}) {
+    return Sentry.expressErrorHandler({
+        shouldHandleError() {
+            return process.env.NODE_ENV === 'production';
+        },
+        ...options,
+    });
+}
+export class SentryLoggerAdapter {
+    constructor() { }
+    captureError(error, attributes) {
+        /* v8 ignore next -- @preserve */
+        if (error == null) {
+            return;
+        }
+        /* v8 ignore next -- @preserve */
+        if (Sentry.isInitialized()) {
+            Sentry.captureException(error, {
+                tags: attributes,
+            });
+        }
+    }
+    write(log) {
+        const { message, ...attributes } = log;
+        /* v8 ignore next -- @preserve */
+        if (Sentry.isInitialized()) {
+            const fn = log.level;
+            Sentry.logger[fn](message, attributes);
+        }
+        return true;
+    }
+}

package/dist/setupTests.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/setupTests.js

@@ -0,0 +1,3 @@
+import { loadConfig } from '@devmoods/config';
+import { sentryConfig } from './index.js';
+loadConfig(sentryConfig);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@devmoods/sentry",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "lint": "eslint",
+    "test": "vitest",
+    "test:coverage": "pnpm run test --coverage",
+    "build": "pnpm run clean && tsgo",
+    "prepublishOnly": "pnpm run clean && pnpm run build"
+  },
+  "dependencies": {
+    "@devmoods/config": "0.2.3",
+    "@devmoods/observability": "0.2.0",
+    "@sentry/node": "^10.48.0",
+    "@sentry/node-native": "^10.48.0",
+    "@sentry/profiling-node": "^10.48.0",
+    "express": "^4.21.2"
+  },
+  "peerDependencies": {
+    "express": ">=4.21.2 <5.0.0"
+  },
+  "gitHead": "ea4f51756aca98bd050cf98128bf4d4b3da1bf38"
+}

package/src/__tests__/index.spec.ts

@@ -0,0 +1,28 @@
+import { overrideConfig } from '@devmoods/config';
+
+import { sentryOptions } from '../index.js';
+
+test('sentryOptions', async () => {
+  vi.spyOn(console, 'warn').mockImplementation(() => {});
+
+  const reset = overrideConfig({
+    SENTRY_DSN: 'https://example.com/sentry',
+    SENTRY_TRACES_SAMPLE_RATE: 0.3,
+    SENTRY_PROFILES_SAMPLE_RATE: 0.3,
+    SENTRY_EVENT_LOOP_THRESHOLD: 750,
+  });
+
+  const options = await sentryOptions();
+
+  expect(options).toEqual(
+    expect.objectContaining({
+      dsn: 'https://example.com/sentry',
+      enableLogs: true,
+      integrations: expect.any(Array),
+      profileSessionSampleRate: 0.3,
+      tracesSampleRate: 0.3,
+    }),
+  );
+
+  reset();
+});

package/src/index.ts

@@ -0,0 +1,122 @@
+import { config, define, t, type ConfigFromDefs } from '@devmoods/config';
+import { type LoggerAdapter } from '@devmoods/observability';
+import * as Sentry from '@sentry/node';
+import { type ErrorRequestHandler } from 'express';
+
+declare module '@devmoods/config' {
+  interface Config extends ConfigFromDefs<typeof sentryConfig> {}
+}
+
+export const sentryConfig = define({
+  SENTRY_DSN: t.string(),
+  SENTRY_TRACES_SAMPLE_RATE: t.number(0.3),
+  SENTRY_PROFILES_SAMPLE_RATE: t.number(0.3),
+  SENTRY_EVENT_LOOP_THRESHOLD: t.number(750),
+});
+
+export type { Sentry };
+
+export interface SentryOptions extends Sentry.NodeOptions {}
+
+/* c8 ignore start */
+export async function initSentry(options: SentryOptions = {}) {
+  Sentry.init(await sentryOptions(options));
+}
+
+export async function closeSentry() {
+  await Sentry.close(5000);
+}
+/* c8 ignore end */
+
+/**
+ * Safely imports native Sentry integrations if available.
+ * Returns null if native modules are not available (e.g., on unsupported Node.js versions).
+ */
+async function getNativeIntegrations() {
+  const integrations = [];
+
+  /* v8 ignore next -- @preserve */
+  try {
+    const { nodeProfilingIntegration } = await import('@sentry/profiling-node');
+    integrations.push(nodeProfilingIntegration());
+  } catch {
+    // Native profiling integration not available
+  }
+
+  /* v8 ignore next -- @preserve */
+  try {
+    const { eventLoopBlockIntegration } = await import('@sentry/node-native');
+    integrations.push(
+      eventLoopBlockIntegration({
+        threshold: config.SENTRY_EVENT_LOOP_THRESHOLD,
+      }),
+    );
+  } catch {
+    // Native event loop integration not available
+  }
+
+  return integrations;
+}
+
+export async function sentryOptions(
+  options: SentryOptions = {},
+): Promise<SentryOptions> {
+  const nativeIntegrations = await getNativeIntegrations();
+
+  return {
+    dsn: config.SENTRY_DSN,
+    tracesSampleRate: config.SENTRY_TRACES_SAMPLE_RATE,
+    profileSessionSampleRate: config.SENTRY_PROFILES_SAMPLE_RATE,
+    integrations: nativeIntegrations,
+    enableLogs: true,
+    ...options,
+  };
+}
+
+export function sentryErrorHandler(
+  options: Sentry.NodeOptions = {},
+): ErrorRequestHandler {
+  return Sentry.expressErrorHandler({
+    shouldHandleError() {
+      return process.env.NODE_ENV === 'production';
+    },
+    ...options,
+  }) as unknown as ErrorRequestHandler;
+}
+
+export class SentryLoggerAdapter implements LoggerAdapter {
+  constructor() {}
+
+  captureError(error: Error | null, attributes?: Record<string, any>) {
+    /* v8 ignore next -- @preserve */
+    if (error == null) {
+      return;
+    }
+
+    /* v8 ignore next -- @preserve */
+    if (Sentry.isInitialized()) {
+      Sentry.captureException(error, {
+        tags: attributes,
+      });
+    }
+  }
+
+  write(log: Record<string, any>) {
+    const { message, ...attributes } = log;
+
+    /* v8 ignore next -- @preserve */
+    if (Sentry.isInitialized()) {
+      const fn = log.level as
+        | 'trace'
+        | 'debug'
+        | 'info'
+        | 'warn'
+        | 'error'
+        | 'fatal';
+
+      Sentry.logger[fn](message, attributes);
+    }
+
+    return true;
+  }
+}

package/src/setupTests.ts

@@ -0,0 +1,5 @@
+import { loadConfig } from '@devmoods/config';
+
+import { sentryConfig } from './index.js';
+
+loadConfig(sentryConfig);

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "noEmit": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "node_modules", "**/*.test.ts", "**/*.spec.ts"]
+}

package/vitest.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    setupFiles: ['./src/setupTests.ts'],
+    globals: true,
+    restoreMocks: true,
+    coverage: {
+      thresholds: {
+        100: true,
+      },
+    },
+  },
+});