modality-kit 0.0.0 → 0.0.2

package/dist/index.js

@@ -54,8 +54,119 @@ function formatErrorResponse(errorData, operation, meta) {
   }
   return JSON.stringify(errorResponse);
 }
+// src/util_logger.ts
+class ModalityLogger {
+  options;
+  logLevel;
+  constructor(options = {}, logLevel = "info") {
+    this.options = options;
+    this.logLevel = logLevel;
+  }
+  getTimestamp() {
+    if (this.options.timestampFormat === false)
+      return;
+    const now = new Date;
+    if (this.options.timestampFormat === "locale")
+      return now.toLocaleString();
+    return now.toISOString();
+  }
+  shouldLog(level) {
+    const levels = ["debug", "info", "warn", "error", "success"];
+    return levels.indexOf(level) >= levels.indexOf(this.logLevel);
+  }
+  format(level, message, context = {}, extra) {
+    const timestamp = this.getTimestamp();
+    const ctx = { ...this.options.context || {}, ...context };
+    const base = {
+      level,
+      message,
+      ...timestamp ? { timestamp } : {},
+      ...Object.keys(ctx).length ? { context: ctx } : {},
+      ...extra ? { ...extra } : {}
+    };
+    if (this.options.json)
+      return JSON.stringify(base);
+    let prefix = "";
+    switch (level) {
+      case "debug":
+        prefix = "\uD83D\uDD0D";
+        break;
+      case "info":
+        prefix = "ℹ️";
+        break;
+      case "warn":
+        prefix = "⚠️";
+        break;
+      case "error":
+        prefix = "❌";
+        break;
+      case "success":
+        prefix = "✅";
+        break;
+      default:
+        prefix = "";
+    }
+    let out = `${prefix} ${message}`;
+    if (timestamp)
+      out = `[${timestamp}] ` + out;
+    if (Object.keys(ctx).length)
+      out += ` | context: ${JSON.stringify(ctx)}`;
+    return extra ? [out, extra] : [out];
+  }
+  withContext(context) {
+    return new ModalityLogger({ ...this.options, context: { ...this.options.context || {}, ...context } }, this.logLevel);
+  }
+  setLogLevel(level) {
+    this.logLevel = level;
+  }
+  setOptions(options) {
+    this.options = { ...this.options, ...options };
+  }
+  log(level, message, context = {}, extra) {
+    if (!this.shouldLog(level))
+      return;
+    const formatted = this.format(level, message, context, extra);
+    switch (level) {
+      case "debug":
+        this.options.json ? console.debug(formatted) : console.debug(...formatted);
+        break;
+      case "info":
+        this.options.json ? console.info(formatted) : console.info(...formatted);
+        break;
+      case "warn":
+        this.options.json ? console.warn(formatted) : console.warn(...formatted);
+        break;
+      case "error":
+        this.options.json ? console.error(formatted) : console.error(...formatted);
+        break;
+      case "success":
+        this.options.json ? console.log(formatted) : console.log(...formatted);
+        break;
+      default:
+        this.options.json ? console.log(formatted) : console.log(...formatted);
+    }
+  }
+  debug(message, context, error) {
+    const extra = error ? { error: error.message, stack: error.stack } : undefined;
+    this.log("debug", message, context, extra);
+  }
+  info(message, context) {
+    this.log("info", message, context);
+  }
+  warn(message, context) {
+    this.log("warn", message, context);
+  }
+  error(message, context, error) {
+    const extra = error ? { error: error.message, stack: error.stack } : undefined;
+    this.log("error", message, context, extra);
+  }
+  success(message, context) {
+    this.log("success", message, context);
+  }
+}
 export {
   setupAITools,
   formatSuccessResponse,
-  formatErrorResponse
+  formatErrorResponse,
+  ModalityLogger
 };

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
 export { setupAITools } from "./util_mcp_tools_converter";
 export type { AITools, AITool } from "./schemas/schemas_tool_config";
 export { formatErrorResponse, formatSuccessResponse } from "./util_response";
+export { ModalityLogger } from "./util_logger";

package/dist/types/util_logger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Storage Logger for structured logging
+ * Provides consistent logging across storage operations with configurable levels
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'success';
+export interface LoggerOptions {
+    timestampFormat?: 'iso' | 'locale' | false;
+    color?: boolean;
+    json?: boolean;
+    context?: Record<string, any>;
+}
+export declare class ModalityLogger {
+    private options;
+    private logLevel;
+    constructor(options?: LoggerOptions, logLevel?: LogLevel);
+    private getTimestamp;
+    private shouldLog;
+    private format;
+    withContext(context: Record<string, any>): ModalityLogger;
+    setLogLevel(level: LogLevel): void;
+    setOptions(options: LoggerOptions): void;
+    log(level: LogLevel, message: string, context?: Record<string, any>, extra?: any): void;
+    debug(message: string, context?: Record<string, any>, error?: Error): void;
+    info(message: string, context?: Record<string, any>): void;
+    warn(message: string, context?: Record<string, any>): void;
+    error(message: string, context?: Record<string, any>, error?: Error): void;
+    success(message: string, context?: Record<string, any>): void;
+}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.0",
+  "version": "0.0.2",
   "name": "modality-kit",
   "repository": {
     "type": "git",
@@ -19,15 +19,17 @@
   },
   "exports": {
     "require": "./dist/index.js",
+    "import": "./dist/index.js",
     "types": "./dist/types/index.d.ts"
   },
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
     "update-compile-sh": "yo reshow:compile-sh",
+    "build:clean": "find ./dist -name '*.*' | xargs rm -rf",
     "build:types": "bunx tsc -p ./",
     "build:src": "bun build src/index.ts --outdir dist",
-    "build": "bun run build:src && bun run build:types",
+    "build": "bun run build:clean && bun run build:src && bun run build:types",
     "test": "npm run build",
     "prepublishOnly": "npm run test"
   },