@bernierllc/ai-provider-openai 1.0.0

package/src/utils/error-handling.ts

@@ -0,0 +1,101 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code only within the scope of the project it was delivered for.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { AIProviderError } from '@bernierllc/ai-provider-core';
+import OpenAI from 'openai';
+
+/**
+ * Convert OpenAI API errors to AIProviderError
+ */
+export function handleOpenAIError(error: unknown): AIProviderError {
+  if (error instanceof OpenAI.APIError) {
+    const status = typeof error.status === 'number' ? error.status : undefined;
+    return new AIProviderError(
+      `OpenAI API Error: ${error.message}`,
+      mapOpenAIErrorCode(status),
+      'openai',
+      {
+        status,
+        type: error.type,
+        code: error.code
+      }
+    );
+  }
+
+  if (error instanceof Error) {
+    return new AIProviderError(
+      error.message,
+      'UNKNOWN_ERROR',
+      'openai'
+    );
+  }
+
+  return new AIProviderError(
+    'Unknown error occurred',
+    'UNKNOWN_ERROR',
+    'openai'
+  );
+}
+
+/**
+ * Map OpenAI HTTP status codes to error codes
+ */
+function mapOpenAIErrorCode(status: number | undefined): string {
+  if (!status) return 'UNKNOWN_ERROR';
+
+  switch (status) {
+    case 400:
+      return 'INVALID_REQUEST';
+    case 401:
+      return 'AUTHENTICATION_ERROR';
+    case 403:
+      return 'PERMISSION_DENIED';
+    case 404:
+      return 'NOT_FOUND';
+    case 429:
+      return 'RATE_LIMIT_ERROR';
+    case 500:
+    case 502:
+    case 503:
+      return 'SERVER_ERROR';
+    case 504:
+      return 'TIMEOUT_ERROR';
+    default:
+      return 'UNKNOWN_ERROR';
+  }
+}
+
+/**
+ * Check if error is retryable
+ */
+export function isRetryableError(error: AIProviderError): boolean {
+  const retryableCodes = [
+    'RATE_LIMIT_ERROR',
+    'SERVER_ERROR',
+    'TIMEOUT_ERROR',
+    'NETWORK_ERROR'
+  ];
+  return retryableCodes.includes(error.code);
+}
+
+/**
+ * Get suggested retry delay based on error
+ */
+export function getRetryDelay(error: AIProviderError, attempt: number): number {
+  // Rate limit errors may include retry-after header
+  if (error.code === 'RATE_LIMIT_ERROR') {
+    return Math.min(Math.pow(2, attempt) * 1000, 60000); // Cap at 60 seconds
+  }
+
+  // Exponential backoff for other retryable errors
+  if (isRetryableError(error)) {
+    return Math.min(Math.pow(2, attempt) * 500, 30000); // Cap at 30 seconds
+  }
+
+  return 0; // Non-retryable
+}

package/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "removeComments": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "__tests__", "**/*.test.ts"]
+}