@csaimonitor/sdk 0.1.0

package/dist/utils.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Utility functions for CSMonitor SDK.
+ *
+ * This module provides helper functions for logging, serialization, and data handling.
+ */
+/**
+ * Get current timestamp in ISO 8601 format.
+ * @returns ISO 8601 formatted timestamp string (UTC)
+ */
+export declare function getIsoTimestamp(): string;
+/**
+ * Safely serialize data to JSON-compatible format.
+ * @param data - Data to serialize (object, array, primitive, or any value)
+ * @returns JSON-serializable object
+ */
+export declare function safeSerialize(data: unknown): Record<string, unknown>;
+/**
+ * Redact sensitive fields from data recursively.
+ * @param data - Dictionary to redact from
+ * @param redactKeys - List of keys to redact (case-insensitive)
+ * @returns Dictionary with redacted values
+ */
+export declare function redactSensitiveData(data: Record<string, unknown>, redactKeys: string[]): Record<string, unknown>;
+/**
+ * Validate API key format.
+ * @param apiKey - API key to validate
+ * @returns True if valid, False otherwise
+ */
+export declare function validateApiKey(apiKey: string): boolean;
+/**
+ * Validate agent ID format.
+ * @param agentId - Agent ID to validate
+ * @returns True if valid, False otherwise
+ */
+export declare function validateAgentId(agentId: string): boolean;
+/**
+ * Format an exception as a clean error message.
+ * @param error - Error to format
+ * @returns Formatted error message string
+ */
+export declare function formatErrorMessage(error: unknown): string;
+/**
+ * Setup a simple logger for the SDK.
+ * @param debug - Enable debug logging
+ * @returns Logger object with log methods
+ */
+export declare function setupLogger(debug?: boolean): {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAkCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAWtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAWxD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAE,OAAe;qBAE7B,MAAM,WAAW,OAAO,EAAE;oBAK3B,MAAM,WAAW,OAAO,EAAE;oBAG1B,MAAM,WAAW,OAAO,EAAE;qBAGzB,MAAM,WAAW,OAAO,EAAE;EAI9C"}

package/dist/utils.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Utility functions for CSMonitor SDK.
+ *
+ * This module provides helper functions for logging, serialization, and data handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIsoTimestamp = getIsoTimestamp;
+exports.safeSerialize = safeSerialize;
+exports.redactSensitiveData = redactSensitiveData;
+exports.validateApiKey = validateApiKey;
+exports.validateAgentId = validateAgentId;
+exports.formatErrorMessage = formatErrorMessage;
+exports.setupLogger = setupLogger;
+/**
+ * Get current timestamp in ISO 8601 format.
+ * @returns ISO 8601 formatted timestamp string (UTC)
+ */
+function getIsoTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Serialize a value for JSON encoding.
+ * Handles common JavaScript/TypeScript types that might need special handling.
+ */
+function serializeValue(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (value instanceof Error) {
+        return {
+            name: value.name,
+            message: value.message,
+            stack: value.stack,
+        };
+    }
+    if (typeof value === 'object' && 'toJSON' in value && typeof value.toJSON === 'function') {
+        return value.toJSON();
+    }
+    return value;
+}
+/**
+ * Safely serialize data to JSON-compatible format.
+ * @param data - Data to serialize (object, array, primitive, or any value)
+ * @returns JSON-serializable object
+ */
+function safeSerialize(data) {
+    if (data === null || data === undefined) {
+        return {};
+    }
+    if (typeof data === 'object') {
+        if (Array.isArray(data)) {
+            return { items: data.map(serializeValue) };
+        }
+        if (data instanceof Map) {
+            return { items: Array.from(data.entries()).map(([k, v]) => ({ key: serializeValue(k), value: serializeValue(v) })) };
+        }
+        if (data instanceof Set) {
+            return { items: Array.from(data).map(serializeValue) };
+        }
+        // Plain object
+        const result = {};
+        for (const [key, value] of Object.entries(data)) {
+            result[key] = serializeValue(value);
+        }
+        return result;
+    }
+    // Primitive types
+    return { value: serializeValue(data) };
+}
+/**
+ * Redact sensitive fields from data recursively.
+ * @param data - Dictionary to redact from
+ * @param redactKeys - List of keys to redact (case-insensitive)
+ * @returns Dictionary with redacted values
+ */
+function redactSensitiveData(data, redactKeys) {
+    if (!data || !redactKeys || redactKeys.length === 0) {
+        return data;
+    }
+    const redactKeysLower = redactKeys.map((key) => key.toLowerCase());
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (redactKeysLower.includes(key.toLowerCase())) {
+            result[key] = '[REDACTED]';
+        }
+        else if (value && typeof value === 'object' && !Array.isArray(value) && !(value instanceof Date)) {
+            result[key] = redactSensitiveData(value, redactKeys);
+        }
+        else if (Array.isArray(value)) {
+            result[key] = value.map((item) => item && typeof item === 'object' && !Array.isArray(item) && !(item instanceof Date)
+                ? redactSensitiveData(item, redactKeys)
+                : item);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Validate API key format.
+ * @param apiKey - API key to validate
+ * @returns True if valid, False otherwise
+ */
+function validateApiKey(apiKey) {
+    if (!apiKey || typeof apiKey !== 'string') {
+        return false;
+    }
+    // API key must be at least 32 characters
+    if (apiKey.length < 32) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Validate agent ID format.
+ * @param agentId - Agent ID to validate
+ * @returns True if valid, False otherwise
+ */
+function validateAgentId(agentId) {
+    if (!agentId || typeof agentId !== 'string') {
+        return false;
+    }
+    // Agent ID should be non-empty
+    if (agentId.trim().length === 0) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Format an exception as a clean error message.
+ * @param error - Error to format
+ * @returns Formatted error message string
+ */
+function formatErrorMessage(error) {
+    if (error instanceof Error) {
+        const errorType = error.constructor.name;
+        const errorMsg = error.message;
+        return errorMsg ? `${errorType}: ${errorMsg}` : errorType;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return 'Unknown error';
+}
+/**
+ * Setup a simple logger for the SDK.
+ * @param debug - Enable debug logging
+ * @returns Logger object with log methods
+ */
+function setupLogger(debug = false) {
+    return {
+        debug: (message, ...args) => {
+            if (debug) {
+                console.debug(`[CSMonitor] ${message}`, ...args);
+            }
+        },
+        info: (message, ...args) => {
+            console.info(`[CSMonitor] ${message}`, ...args);
+        },
+        warn: (message, ...args) => {
+            console.warn(`[CSMonitor] ${message}`, ...args);
+        },
+        error: (message, ...args) => {
+            console.error(`[CSMonitor] ${message}`, ...args);
+        },
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAMH,0CAEC;AAuCD,sCA4BC;AAQD,kDA4BC;AAOD,wCAWC;AAOD,0CAWC;AAOD,gDAYC;AAOD,kCAiBC;AA5LD;;;GAGG;AACH,SAAgB,eAAe;IAC7B,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACzF,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAa;IACzC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7C,CAAC;QAED,IAAI,IAAI,YAAY,GAAG,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACvH,CAAC;QAED,IAAI,IAAI,YAAY,GAAG,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACzD,CAAC;QAED,eAAe;QACf,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,IAA6B,EAC7B,UAAoB;IAEpB,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,EAAE,CAAC;YACnG,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,KAAgC,EAAE,UAAU,CAAC,CAAC;QAClF,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC;gBACjF,CAAC,CAAC,mBAAmB,CAAC,IAA+B,EAAE,UAAU,CAAC;gBAClE,CAAC,CAAC,IAAI,CACT,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,MAAc;IAC3C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yCAAyC;IACzC,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;QAC/B,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAC,QAAiB,KAAK;IAChD,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;YAC7C,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;YAC5C,OAAO,CAAC,IAAI,CAAC,eAAe,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;YAC5C,OAAO,CAAC,IAAI,CAAC,eAAe,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;YAC7C,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@csaimonitor/sdk",
+  "version": "0.1.0",
+  "description": "Production-ready Node.js/TypeScript SDK for Customer Support AI Monitor",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:integration": "jest tests/integration.test.ts",
+    "test:e2e": "ts-node test-e2e.ts",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts"
+  },
+  "keywords": [
+    "ai",
+    "monitoring",
+    "customer-support",
+    "sdk",
+    "typescript",
+    "observability"
+  ],
+  "author": "Customer Support AI Monitor Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/csaimonitor/sdk-nodejs.git"
+  }
+}