@artu-ai/compliance-sdk 0.4.1 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artu-ai/compliance-sdk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "TypeScript SDK for the Artu Compliance API",
   "private": false,
   "type": "module",
@@ -43,7 +43,6 @@
   },
   "files": [
     "dist",
-    "src",
     "README.md"
   ],
   "publishConfig": {
@@ -57,7 +56,7 @@
   },
   "license": "UNLICENSED",
   "dependencies": {
-    "@artu-ai/shared": "0.4.1",
+    "@artu-ai/shared": "0.4.2",
     "@trpc/client": "^11.7.2"
   },
   "devDependencies": {
@@ -68,4 +67,4 @@
     "vitest": "^4.0.14",
     "zod": "^4.1.12"
   }
-}
+}

package/src/errors/api.ts

@@ -1,305 +0,0 @@
-/**
- * API error classes
- *
- * Errors thrown when the API returns error responses.
- * Includes specific error types for common scenarios.
- */
-
-import { TRPCClientError } from "@trpc/client";
-import { ComplianceError, type ComplianceErrorOptions } from "./base";
-import { ValidationError, type ValidationIssue } from "./validation";
-
-// ===========================
-// API Error Base Class
-// ===========================
-
-/**
- * Error thrown when the API returns an error response.
- *
- * @example
- * ```typescript
- * try {
- *   await sdk.clients.create({ ... });
- * } catch (error) {
- *   if (error instanceof APIError) {
- *     console.log("Status:", error.statusCode);
- *     console.log("Code:", error.code);
- *   }
- * }
- * ```
- */
-export class APIError extends ComplianceError {
-  /**
-   * HTTP status code (if available)
-   */
-  public readonly statusCode?: number;
-
-  constructor(
-    message: string,
-    code: string,
-    options?: ComplianceErrorOptions & { statusCode?: number }
-  ) {
-    super(message, code, options);
-    this.name = "APIError";
-    this.statusCode = options?.statusCode;
-  }
-}
-
-// ===========================
-// Specific API Errors
-// ===========================
-
-/**
- * Resource not found error (404).
- *
- * @example
- * ```typescript
- * try {
- *   await sdk.clients.retrieve("invalid-id");
- * } catch (error) {
- *   if (error instanceof NotFoundError) {
- *     console.log(`${error.resourceType} '${error.resourceId}' not found`);
- *   }
- * }
- * ```
- */
-export class NotFoundError extends APIError {
-  /**
-   * Type of resource that was not found (e.g., "Client", "Transaction")
-   */
-  public readonly resourceType: string;
-
-  /**
-   * ID of the resource that was not found
-   */
-  public readonly resourceId: string;
-
-  constructor(resourceType: string, resourceId: string, requestId?: string) {
-    super(`${resourceType} with ID '${resourceId}' not found`, "NOT_FOUND", {
-      statusCode: 404,
-      requestId,
-      details: { resourceType, resourceId },
-    });
-    this.name = "NotFoundError";
-    this.resourceType = resourceType;
-    this.resourceId = resourceId;
-  }
-}
-
-/**
- * Authentication failed error (401).
- * Thrown when the API key is invalid or missing.
- */
-export class UnauthorizedError extends APIError {
-  constructor(message = "Invalid or missing API key", requestId?: string) {
-    super(message, "UNAUTHORIZED", { statusCode: 401, requestId });
-    this.name = "UnauthorizedError";
-  }
-}
-
-/**
- * Permission denied error (403).
- * Thrown when the API key lacks permission for the operation.
- *
- * @example
- * ```typescript
- * // Using test API key with live environment
- * const sdk = new ComplianceSDK({
- *   apiKey: "sk_test_...",
- *   environment: "live", // No permission!
- * });
- * ```
- */
-export class ForbiddenError extends APIError {
-  constructor(message = "Permission denied", requestId?: string) {
-    super(message, "FORBIDDEN", { statusCode: 403, requestId });
-    this.name = "ForbiddenError";
-  }
-}
-
-/**
- * Rate limit exceeded error (429).
- * Includes retry information when available.
- *
- * @example
- * ```typescript
- * try {
- *   await sdk.clients.list();
- * } catch (error) {
- *   if (error instanceof RateLimitError) {
- *     console.log(`Rate limited. Retry after ${error.retryAfter}s`);
- *     await sleep(error.retryAfter * 1000);
- *     // Retry...
- *   }
- * }
- * ```
- */
-export class RateLimitError extends APIError {
-  /**
-   * Seconds to wait before retrying (if provided by API)
-   */
-  public readonly retryAfter?: number;
-
-  constructor(retryAfter?: number, requestId?: string) {
-    const message = retryAfter
-      ? `Rate limit exceeded. Retry after ${retryAfter} seconds`
-      : "Rate limit exceeded";
-    super(message, "RATE_LIMITED", {
-      statusCode: 429,
-      requestId,
-      details: retryAfter ? { retryAfter } : undefined,
-    });
-    this.name = "RateLimitError";
-    this.retryAfter = retryAfter;
-  }
-}
-
-/**
- * Server error (5xx).
- * Indicates an unexpected error on the API server.
- */
-export class ServerError extends APIError {
-  constructor(message = "Internal server error", requestId?: string) {
-    super(message, "SERVER_ERROR", { statusCode: 500, requestId });
-    this.name = "ServerError";
-  }
-}
-
-/**
- * Network/connection error.
- * Thrown when the request fails to reach the server.
- */
-export class NetworkError extends APIError {
-  constructor(message = "Network error", cause?: Error) {
-    super(message, "NETWORK_ERROR", { cause });
-    this.name = "NetworkError";
-  }
-}
-
-/**
- * Request timeout error.
- * Thrown when the request exceeds the configured timeout.
- */
-export class TimeoutError extends APIError {
-  /**
-   * Timeout duration in milliseconds
-   */
-  public readonly timeout: number;
-
-  constructor(timeout: number, requestId?: string) {
-    super(`Request timed out after ${timeout}ms`, "TIMEOUT", {
-      requestId,
-      details: { timeout },
-    });
-    this.name = "TimeoutError";
-    this.timeout = timeout;
-  }
-}
-
-// ===========================
-// tRPC Error Mapping
-// ===========================
-
-/**
- * Maps a tRPC client error to an SDK-specific error.
- *
- * This function converts tRPC errors into the appropriate
- * SDK error class for better error handling.
- *
- * @param error - tRPC client error
- * @returns SDK-specific error
- *
- * @example
- * ```typescript
- * try {
- *   await trpcClient.clients.retrieve.query({ id: "..." });
- * } catch (error) {
- *   if (isTRPCError(error)) {
- *     throw mapTRPCError(error);
- *   }
- *   throw error;
- * }
- * ```
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function mapTRPCError(error: TRPCClientError<any>): ComplianceError {
-  // Extract error data from tRPC response
-  const data = error.data as Record<string, unknown> | undefined;
-  const code = data?.code as string | undefined;
-  const requestId = data?.requestId as string | undefined;
-
-  // Handle specific error codes
-  switch (code) {
-    case "NOT_FOUND":
-      return new NotFoundError(
-        (data?.resourceType as string) ?? "Resource",
-        (data?.resourceId as string) ?? "unknown",
-        requestId
-      );
-
-    case "UNAUTHORIZED":
-      return new UnauthorizedError(error.message, requestId);
-
-    case "FORBIDDEN":
-      return new ForbiddenError(error.message, requestId);
-
-    case "BAD_REQUEST": {
-      // Check for Zod validation errors
-      const zodError = data?.zodError as
-        | { issues?: ValidationIssue[] }
-        | undefined;
-      if (zodError?.issues) {
-        return new ValidationError(zodError.issues, requestId);
-      }
-      return new ValidationError(
-        [{ path: [], message: error.message }],
-        requestId
-      );
-    }
-
-    case "TOO_MANY_REQUESTS":
-      return new RateLimitError(
-        data?.retryAfter as number | undefined,
-        requestId
-      );
-
-    case "INTERNAL_SERVER_ERROR":
-      return new ServerError(error.message, requestId);
-
-    case "TIMEOUT":
-      return new TimeoutError((data?.timeout as number) ?? 30000, requestId);
-
-    default:
-      // Check for network errors
-      if (
-        error.message.includes("fetch failed") ||
-        error.message.includes("network") ||
-        error.message.includes("ECONNREFUSED")
-      ) {
-        return new NetworkError(error.message, error);
-      }
-
-      // Generic API error
-      return new APIError(error.message, code ?? "UNKNOWN_ERROR", {
-        requestId,
-        cause: error,
-      });
-  }
-}
-
-/**
- * Type guard to check if an error is a specific API error type.
- *
- * @param error - Error to check
- * @param type - Error class to check against
- * @returns True if error is an instance of the specified type
- */
-export function isAPIError<T extends typeof APIError>(
-  error: unknown,
-  type?: T
-): error is InstanceType<T> {
-  if (type) {
-    return error instanceof type;
-  }
-  return error instanceof APIError;
-}

package/src/errors/base.ts

@@ -1,127 +0,0 @@
-/**
- * Base error class for SDK errors
- *
- * All SDK errors extend this class, providing consistent
- * structure for error handling and serialization.
- */
-
-// ===========================
-// Types
-// ===========================
-
-/**
- * Options for creating a ComplianceError
- */
-export interface ComplianceErrorOptions {
-  /**
-   * Request ID for tracing (from X-Request-ID header)
-   */
-  requestId?: string;
-
-  /**
-   * Additional error details
-   */
-  details?: Record<string, unknown>;
-
-  /**
-   * Original error that caused this error
-   */
-  cause?: Error;
-}
-
-/**
- * JSON representation of a ComplianceError
- */
-export interface ComplianceErrorJSON {
-  name: string;
-  code: string;
-  message: string;
-  requestId?: string;
-  details?: Record<string, unknown>;
-}
-
-// ===========================
-// Base Error Class
-// ===========================
-
-/**
- * Base error class for all SDK errors.
- *
- * Provides consistent structure for:
- * - Error codes for programmatic handling
- * - Request IDs for debugging
- * - Additional details
- * - JSON serialization
- *
- * @example
- * ```typescript
- * try {
- *   await sdk.clients.retrieve("invalid-id");
- * } catch (error) {
- *   if (error instanceof ComplianceError) {
- *     console.log("Error code:", error.code);
- *     console.log("Request ID:", error.requestId);
- *     // Send to logging service
- *     logger.error(error.toJSON());
- *   }
- * }
- * ```
- */
-export class ComplianceError extends Error {
-  /**
-   * Error code for programmatic handling.
-   * Examples: "VALIDATION_ERROR", "NOT_FOUND", "UNAUTHORIZED"
-   */
-  public readonly code: string;
-
-  /**
-   * Request ID for tracing (from X-Request-ID header).
-   * Useful for debugging with support.
-   */
-  public readonly requestId?: string;
-
-  /**
-   * Additional error details.
-   * Structure varies by error type.
-   */
-  public readonly details?: Record<string, unknown>;
-
-  constructor(message: string, code: string, options?: ComplianceErrorOptions) {
-    super(message, { cause: options?.cause });
-    this.name = "ComplianceError";
-    this.code = code;
-    this.requestId = options?.requestId;
-    this.details = options?.details;
-
-    // Maintain proper prototype chain for instanceof checks
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-
-  /**
-   * Serializes the error to a JSON-compatible object.
-   * Useful for logging and error reporting.
-   *
-   * @returns JSON representation of the error
-   */
-  toJSON(): ComplianceErrorJSON {
-    return {
-      name: this.name,
-      code: this.code,
-      message: this.message,
-      requestId: this.requestId,
-      details: this.details,
-    };
-  }
-
-  /**
-   * Returns a string suitable for sending to support.
-   * Includes request ID if available.
-   */
-  toSupportInfo(): string {
-    const parts = [`Error: ${this.message}`, `Code: ${this.code}`];
-    if (this.requestId) {
-      parts.push(`Request ID: ${this.requestId}`);
-    }
-    return parts.join("\n");
-  }
-}

package/src/errors/index.ts

@@ -1,63 +0,0 @@
-/**
- * SDK Error Classes
- *
- * This module exports all error classes used by the SDK.
- * All errors extend ComplianceError and provide consistent
- * structure for error handling and serialization.
- *
- * Error Hierarchy:
- * ```
- * ComplianceError (base)
- * ├── ValidationError      # Zod validation failures
- * ├── APIError             # tRPC/HTTP errors from server
- * │   ├── NotFoundError
- * │   ├── UnauthorizedError
- * │   ├── ForbiddenError
- * │   ├── RateLimitError
- * │   ├── ServerError
- * │   ├── NetworkError
- * │   └── TimeoutError
- * └── UploadError          # File upload failures
- *     ├── FileTooLargeError
- *     ├── UploadTimeoutError
- *     ├── InvalidFileTypeError
- *     ├── UploadAbortedError
- *     └── UploadUrlExpiredError
- * ```
- */
-
-// Base error
-export {
-  ComplianceError,
-  type ComplianceErrorOptions,
-  type ComplianceErrorJSON,
-} from "./base";
-
-// Validation errors
-export { ValidationError, type ValidationIssue } from "./validation";
-
-// API errors
-export {
-  APIError,
-  NotFoundError,
-  UnauthorizedError,
-  ForbiddenError,
-  RateLimitError,
-  ServerError,
-  NetworkError,
-  TimeoutError,
-  mapTRPCError,
-  isAPIError,
-} from "./api";
-
-// Upload errors
-export {
-  UploadError,
-  FileTooLargeError,
-  UploadTimeoutError,
-  InvalidFileTypeError,
-  UploadAbortedError,
-  UploadUrlExpiredError,
-  isUploadError,
-  type UploadStage,
-} from "./upload";