@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/src/core/trace/linear-api-wrapper.js

@@ -0,0 +1,178 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { trace } from "./debug-trace.js";
+import { logger } from "../monitoring/logger.js";
+function TraceLinearAPI(target, propertyKey, descriptor) {
+  const originalMethod = descriptor.value;
+  const isAsync = originalMethod.constructor.name === "AsyncFunction";
+  if (isAsync) {
+    descriptor.value = async function(...args) {
+      const className = target.constructor.name;
+      const methodName = `${className}.${propertyKey}`;
+      const context = extractAPIContext(propertyKey, args);
+      return trace.traceAsync("api", methodName, context, async () => {
+        const startTime = Date.now();
+        try {
+          logger.debug(`Linear API Call: ${methodName}`, context);
+          const result = await originalMethod.apply(this, args);
+          const duration = Date.now() - startTime;
+          logger.info(`Linear API Success: ${methodName}`, {
+            duration,
+            resultType: Array.isArray(result) ? `array[${result.length}]` : typeof result,
+            hasData: result != null
+          });
+          if (duration > 1e3) {
+            logger.warn(
+              `Slow Linear API call: ${methodName} took ${duration}ms`,
+              {
+                ...context,
+                duration
+              }
+            );
+          }
+          return result;
+        } catch (error) {
+          const duration = Date.now() - startTime;
+          logger.error(`Linear API Failed: ${methodName}`, error, {
+            ...context,
+            duration,
+            errorCode: error.code,
+            statusCode: error.statusCode,
+            graphQLErrors: error.errors
+          });
+          if (error.message?.includes("rate limit")) {
+            logger.warn("Rate limit hit - consider implementing backoff", {
+              method: methodName,
+              suggestion: "Implement exponential backoff or request queuing"
+            });
+          } else if (error.message?.includes("network")) {
+            logger.warn("Network error - check connectivity", {
+              method: methodName,
+              suggestion: "Verify API endpoint and network connectivity"
+            });
+          } else if (error.message?.includes("unauthorized")) {
+            logger.warn("Authorization error - check API key", {
+              method: methodName,
+              suggestion: "Verify LINEAR_API_KEY is set and valid"
+            });
+          }
+          throw error;
+        }
+      });
+    };
+  } else {
+    descriptor.value = function(...args) {
+      const className = target.constructor.name;
+      const methodName = `${className}.${propertyKey}`;
+      const context = extractAPIContext(propertyKey, args);
+      return trace.traceSync("api", methodName, context, () => {
+        return originalMethod.apply(this, args);
+      });
+    };
+  }
+  return descriptor;
+}
+function extractAPIContext(methodName, args) {
+  const context = {};
+  if (methodName === "createIssue" && args[0]) {
+    context.title = args[0].title;
+    context.teamId = args[0].teamId;
+    context.priority = args[0].priority;
+  } else if (methodName === "updateIssue" && args[0]) {
+    context.issueId = args[0];
+    context.updates = Object.keys(args[1] || {});
+  } else if (methodName === "getIssue") {
+    context.issueId = args[0];
+  } else if (methodName === "getIssues" && args[0]) {
+    context.filter = args[0];
+  } else if (methodName === "graphql") {
+    const query = args[0];
+    if (query) {
+      const match = query.match(/(?:query|mutation)\s+(\w+)/);
+      context.operation = match ? match[1] : "unknown";
+      context.queryLength = query.length;
+      context.variables = args[1] ? Object.keys(args[1]) : [];
+    }
+  }
+  return context;
+}
+function createTracedFetch(baseFetch = fetch) {
+  return async function tracedFetch(input, init) {
+    const url = typeof input === "string" ? input : input.toString();
+    const method = init?.method || "GET";
+    const headers = init?.headers ? { ...init.headers } : {};
+    if (headers.Authorization) {
+      headers.Authorization = headers.Authorization.substring(0, 20) + "...[MASKED]";
+    }
+    const context = {
+      method,
+      url: url.length > 100 ? url.substring(0, 100) + "..." : url,
+      headers: Object.keys(headers),
+      bodySize: init?.body ? JSON.stringify(init.body).length : 0
+    };
+    return trace.api(method, url, context, async () => {
+      const startTime = Date.now();
+      try {
+        const response = await baseFetch(input, init);
+        const duration = Date.now() - startTime;
+        logger.debug(`HTTP ${method} ${response.status}`, {
+          url: url.substring(0, 100),
+          status: response.status,
+          duration,
+          headers: {
+            "content-type": response.headers.get("content-type"),
+            "x-ratelimit-remaining": response.headers.get(
+              "x-ratelimit-remaining"
+            ),
+            "x-ratelimit-reset": response.headers.get("x-ratelimit-reset")
+          }
+        });
+        const remaining = response.headers.get("x-ratelimit-remaining");
+        if (remaining && parseInt(remaining) < 10) {
+          logger.warn(`Low rate limit remaining: ${remaining}`, {
+            url: url.substring(0, 100),
+            resetAt: response.headers.get("x-ratelimit-reset")
+          });
+        }
+        if (duration > 2e3) {
+          logger.warn(`Slow HTTP response: ${duration}ms`, {
+            method,
+            url: url.substring(0, 100),
+            status: response.status
+          });
+        }
+        return response;
+      } catch (error) {
+        const duration = Date.now() - startTime;
+        logger.error(`HTTP ${method} failed`, error, {
+          url: url.substring(0, 100),
+          duration,
+          errorType: error.constructor.name,
+          errno: error.errno,
+          code: error.code
+        });
+        throw error;
+      }
+    });
+  };
+}
+function wrapGraphQLClient(client) {
+  const prototype = Object.getPrototypeOf(client);
+  const propertyNames = Object.getOwnPropertyNames(prototype);
+  for (const propertyName of propertyNames) {
+    if (propertyName === "constructor") continue;
+    const descriptor = Object.getOwnPropertyDescriptor(prototype, propertyName);
+    if (!descriptor || typeof descriptor.value !== "function") continue;
+    TraceLinearAPI(prototype, propertyName, descriptor);
+    Object.defineProperty(prototype, propertyName, descriptor);
+  }
+  return client;
+}
+export {
+  TraceLinearAPI,
+  createTracedFetch,
+  wrapGraphQLClient
+};
+//# sourceMappingURL=linear-api-wrapper.js.map

package/dist/src/core/trace/linear-api-wrapper.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/trace/linear-api-wrapper.ts"],
+  "sourcesContent": ["/**\n * Linear API Trace Wrapper\n * Wraps Linear API client with comprehensive tracing for debugging\n */\n\nimport { trace, Trace } from './debug-trace.js';\nimport { logger } from '../monitoring/logger.js';\n\n/**\n * Decorator to trace Linear API GraphQL calls\n */\nexport function TraceLinearAPI(\n  target: any,\n  propertyKey: string,\n  descriptor: PropertyDescriptor\n) {\n  const originalMethod = descriptor.value;\n  const isAsync = originalMethod.constructor.name === 'AsyncFunction';\n\n  if (isAsync) {\n    descriptor.value = async function (...args: any[]) {\n      const className = target.constructor.name;\n      const methodName = `${className}.${propertyKey}`;\n\n      // Extract meaningful context from arguments\n      const context = extractAPIContext(propertyKey, args);\n\n      return trace.traceAsync('api', methodName, context, async () => {\n        const startTime = Date.now();\n\n        try {\n          // Log API call start\n          logger.debug(`Linear API Call: ${methodName}`, context);\n\n          const result = await originalMethod.apply(this, args);\n\n          const duration = Date.now() - startTime;\n\n          // Log successful completion with timing\n          logger.info(`Linear API Success: ${methodName}`, {\n            duration,\n            resultType: Array.isArray(result)\n              ? `array[${result.length}]`\n              : typeof result,\n            hasData: result != null,\n          });\n\n          // Warn about slow API calls\n          if (duration > 1000) {\n            logger.warn(\n              `Slow Linear API call: ${methodName} took ${duration}ms`,\n              {\n                ...context,\n                duration,\n              }\n            );\n          }\n\n          return result;\n        } catch (error: any) {\n          const duration = Date.now() - startTime;\n\n          // Enhanced error logging for API failures\n          logger.error(`Linear API Failed: ${methodName}`, error, {\n            ...context,\n            duration,\n            errorCode: error.code,\n            statusCode: error.statusCode,\n            graphQLErrors: error.errors,\n          });\n\n          // Add debugging hints based on error type\n          if (error.message?.includes('rate limit')) {\n            logger.warn('Rate limit hit - consider implementing backoff', {\n              method: methodName,\n              suggestion: 'Implement exponential backoff or request queuing',\n            });\n          } else if (error.message?.includes('network')) {\n            logger.warn('Network error - check connectivity', {\n              method: methodName,\n              suggestion: 'Verify API endpoint and network connectivity',\n            });\n          } else if (error.message?.includes('unauthorized')) {\n            logger.warn('Authorization error - check API key', {\n              method: methodName,\n              suggestion: 'Verify LINEAR_API_KEY is set and valid',\n            });\n          }\n\n          throw error;\n        }\n      });\n    };\n  } else {\n    descriptor.value = function (...args: any[]) {\n      const className = target.constructor.name;\n      const methodName = `${className}.${propertyKey}`;\n      const context = extractAPIContext(propertyKey, args);\n\n      return trace.traceSync('api', methodName, context, () => {\n        return originalMethod.apply(this, args);\n      });\n    };\n  }\n\n  return descriptor;\n}\n\n/**\n * Extract meaningful context from API method arguments\n */\nfunction extractAPIContext(\n  methodName: string,\n  args: any[]\n): Record<string, any> {\n  const context: Record<string, any> = {};\n\n  // Handle different Linear API methods\n  if (methodName === 'createIssue' && args[0]) {\n    context.title = args[0].title;\n    context.teamId = args[0].teamId;\n    context.priority = args[0].priority;\n  } else if (methodName === 'updateIssue' && args[0]) {\n    context.issueId = args[0];\n    context.updates = Object.keys(args[1] || {});\n  } else if (methodName === 'getIssue') {\n    context.issueId = args[0];\n  } else if (methodName === 'getIssues' && args[0]) {\n    context.filter = args[0];\n  } else if (methodName === 'graphql') {\n    // For raw GraphQL queries\n    const query = args[0];\n    if (query) {\n      // Extract operation name from query\n      const match = query.match(/(?:query|mutation)\\s+(\\w+)/);\n      context.operation = match ? match[1] : 'unknown';\n      context.queryLength = query.length;\n      context.variables = args[1] ? Object.keys(args[1]) : [];\n    }\n  }\n\n  return context;\n}\n\n/**\n * Wrap fetch with tracing for HTTP-level debugging\n */\nexport function createTracedFetch(baseFetch = fetch): typeof fetch {\n  return async function tracedFetch(\n    input: string | URL | Request,\n    init?: RequestInit\n  ): Promise<Response> {\n    const url = typeof input === 'string' ? input : input.toString();\n    const method = init?.method || 'GET';\n\n    // Mask sensitive headers\n    const headers: any = init?.headers ? { ...init.headers } : {};\n    if (headers.Authorization) {\n      headers.Authorization =\n        headers.Authorization.substring(0, 20) + '...[MASKED]';\n    }\n\n    const context = {\n      method,\n      url: url.length > 100 ? url.substring(0, 100) + '...' : url,\n      headers: Object.keys(headers),\n      bodySize: init?.body ? JSON.stringify(init.body).length : 0,\n    };\n\n    return trace.api(method, url, context, async () => {\n      const startTime = Date.now();\n\n      try {\n        const response = await baseFetch(input, init);\n        const duration = Date.now() - startTime;\n\n        // Log response details\n        logger.debug(`HTTP ${method} ${response.status}`, {\n          url: url.substring(0, 100),\n          status: response.status,\n          duration,\n          headers: {\n            'content-type': response.headers.get('content-type'),\n            'x-ratelimit-remaining': response.headers.get(\n              'x-ratelimit-remaining'\n            ),\n            'x-ratelimit-reset': response.headers.get('x-ratelimit-reset'),\n          },\n        });\n\n        // Warn about rate limiting\n        const remaining = response.headers.get('x-ratelimit-remaining');\n        if (remaining && parseInt(remaining) < 10) {\n          logger.warn(`Low rate limit remaining: ${remaining}`, {\n            url: url.substring(0, 100),\n            resetAt: response.headers.get('x-ratelimit-reset'),\n          });\n        }\n\n        // Warn about slow responses\n        if (duration > 2000) {\n          logger.warn(`Slow HTTP response: ${duration}ms`, {\n            method,\n            url: url.substring(0, 100),\n            status: response.status,\n          });\n        }\n\n        return response;\n      } catch (error: any) {\n        const duration = Date.now() - startTime;\n\n        logger.error(`HTTP ${method} failed`, error, {\n          url: url.substring(0, 100),\n          duration,\n          errorType: error.constructor.name,\n          errno: error.errno,\n          code: error.code,\n        });\n\n        throw error;\n      }\n    });\n  };\n}\n\n/**\n * Create a traced GraphQL client wrapper\n */\nexport function wrapGraphQLClient<T>(client: T): T {\n  const prototype = Object.getPrototypeOf(client);\n  const propertyNames = Object.getOwnPropertyNames(prototype);\n\n  for (const propertyName of propertyNames) {\n    if (propertyName === 'constructor') continue;\n\n    const descriptor = Object.getOwnPropertyDescriptor(prototype, propertyName);\n    if (!descriptor || typeof descriptor.value !== 'function') continue;\n\n    // Apply tracing to all methods\n    TraceLinearAPI(prototype, propertyName, descriptor);\n    Object.defineProperty(prototype, propertyName, descriptor);\n  }\n\n  return client;\n}\n"],
+  "mappings": "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",
+  "names": []
+}