@goniglep57/node 1.0.0 → 1.0.1

package/index.js

@@ -4,4 +4,5 @@ exports.dropbox = require('./dropbox.js')
 exports.ncrypt = require('./ncrypt.js')
 exports.secret = require('./secret.js')
 exports.server = require('./server.js')
+exports.slack = require('./slack.js')
 exports.util = require('./util.js')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goniglep57/node",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A package full of utility functions",
   "main": "index.js",
   "scripts": {

package/slack.js

@@ -0,0 +1,184 @@
+/**
+ * Slack notification module for error alerting across all services
+ * 
+ * Usage:
+ *   const { slack } = require('@goniglep57/node')
+ *   
+ *   // Configure once at startup
+ *   slack.configure({
+ *     webhookUrl: process.env.SLACK_ERROR_WEBHOOK,
+ *     serviceName: 'tonomo-front-end',
+ *     environment: process.env.NODE_ENV || 'development'
+ *   })
+ *   
+ *   // Send error notifications
+ *   await slack.error('Database connection failed', { userId: 123 })
+ *   await slack.warn('Rate limit approaching', { current: 90, max: 100 })
+ *   await slack.info('Deployment complete')
+ */
+
+let config = null
+
+/**
+ * Configure the Slack module
+ * @param {Object} options
+ * @param {string} options.webhookUrl - Slack incoming webhook URL
+ * @param {string} options.serviceName - Name of the service (e.g., 'tonomo-front-end')
+ * @param {string} [options.environment='production'] - Environment name
+ */
+const configure = (options) => {
+    const { webhookUrl, serviceName, environment = 'production' } = options
+
+    if (!webhookUrl) {
+        console.warn('[slack] No webhook URL provided, notifications will be disabled')
+        config = null
+        return { configured: false }
+    }
+
+    if (!serviceName) {
+        throw new Error('slack.configure requires serviceName')
+    }
+
+    config = {
+        webhookUrl,
+        serviceName,
+        environment
+    }
+
+    return { configured: true }
+}
+
+/**
+ * Check if Slack is configured
+ */
+const isConfigured = () => config !== null
+
+/**
+ * Send a notification to Slack
+ * @param {string} level - 'error', 'warn', or 'info'
+ * @param {string} message - The message
+ * @param {Object} [context={}] - Additional context
+ */
+const send = async (level, message, context = {}) => {
+    if (!config) {
+        return { sent: false, reason: 'not configured' }
+    }
+
+    const emoji = {
+        error: '🚨',
+        warn: '⚠️',
+        info: 'ℹ️'
+    }[level] || '📢'
+
+    const color = {
+        error: '#dc3545',
+        warn: '#ffc107',
+        info: '#17a2b8'
+    }[level] || '#6c757d'
+
+    try {
+        const contextLines = Object.entries(context)
+            .filter(([_, v]) => v !== undefined && v !== null)
+            .map(([key, value]) => {
+                const displayValue = typeof value === 'object' 
+                    ? JSON.stringify(value).substring(0, 200) 
+                    : String(value).substring(0, 200)
+                return `• *${key}:* ${displayValue}`
+            })
+            .join('\n')
+
+        const payload = {
+            attachments: [
+                {
+                    color,
+                    blocks: [
+                        {
+                            type: 'header',
+                            text: {
+                                type: 'plain_text',
+                                text: `${emoji} ${config.serviceName} - ${level.toUpperCase()}`,
+                                emoji: true
+                            }
+                        },
+                        {
+                            type: 'section',
+                            text: {
+                                type: 'mrkdwn',
+                                text: `*Message:*\n${message}`
+                            }
+                        }
+                    ]
+                }
+            ]
+        }
+
+        if (contextLines) {
+            payload.attachments[0].blocks.push({
+                type: 'section',
+                text: {
+                    type: 'mrkdwn',
+                    text: `*Context:*\n${contextLines}`
+                }
+            })
+        }
+
+        payload.attachments[0].blocks.push({
+            type: 'context',
+            elements: [
+                {
+                    type: 'mrkdwn',
+                    text: `🌍 ${config.environment} | ⏰ ${new Date().toISOString()}`
+                }
+            ]
+        })
+
+        const response = await fetch(config.webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload)
+        })
+
+        if (!response.ok) {
+            console.error('[slack] Failed to send notification:', response.status)
+            return { sent: false, reason: `HTTP ${response.status}` }
+        }
+
+        return { sent: true }
+    } catch (err) {
+        // Don't let Slack errors break the main flow
+        console.error('[slack] Error sending notification:', err.message)
+        return { sent: false, reason: err.message }
+    }
+}
+
+/**
+ * Send an error notification
+ */
+const error = (message, context = {}) => send('error', message, context)
+
+/**
+ * Send a warning notification
+ */
+const warn = (message, context = {}) => send('warn', message, context)
+
+/**
+ * Send an info notification
+ */
+const info = (message, context = {}) => send('info', message, context)
+
+/**
+ * Reset configuration (useful for testing)
+ */
+const reset = () => {
+    config = null
+}
+
+module.exports = {
+    configure,
+    isConfigured,
+    send,
+    error,
+    warn,
+    info,
+    reset
+}