@noverachat/sdk-web 0.0.3

package/src/errors.ts

@@ -0,0 +1,59 @@
+/**
+ * Error taxonomy mirrors noverachat-backend/src/noverachat/core/errors.py.
+ * Keep the list in-sync with the server.
+ */
+
+export const ErrorCode = {
+  INTERNAL: "NC-GEN-001",
+  NOT_FOUND: "NC-GEN-002",
+  VALIDATION: "NC-GEN-003",
+  FORBIDDEN: "NC-GEN-004",
+  UNAUTHORIZED: "NC-AUTH-001",
+  TOKEN_EXPIRED: "NC-AUTH-002",
+  TOKEN_INVALID: "NC-AUTH-003",
+  TOKEN_REVOKED: "NC-AUTH-004",
+  APP_INACTIVE: "NC-APP-001",
+  APP_NOT_FOUND: "NC-APP-002",
+  USER_BANNED: "NC-USER-001",
+  USER_NOT_FOUND: "NC-USER-002",
+  ROOM_NOT_FOUND: "NC-ROOM-001",
+  ROOM_FROZEN: "NC-ROOM-002",
+  NOT_A_MEMBER: "NC-ROOM-003",
+  MESSAGE_TOO_LARGE: "NC-MSG-001",
+  MESSAGE_NOT_FOUND: "NC-MSG-002",
+  MESSAGE_EDIT_FORBID: "NC-MSG-003",
+  RATE_LIMITED: "NC-RATE-001",
+} as const;
+
+export type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+
+export class NoveraChatError extends Error {
+  public readonly code: string;
+  public readonly status: number;
+  public readonly details?: Record<string, unknown>;
+
+  constructor(
+    message: string,
+    code: string = ErrorCode.INTERNAL,
+    status: number = 0,
+    details?: Record<string, unknown>,
+  ) {
+    super(message);
+    this.name = "NoveraChatError";
+    this.code = code;
+    this.status = status;
+    // Under `exactOptionalPropertyTypes`, we cannot assign `undefined` to
+    // an optional field — leave the field unset instead.
+    if (details !== undefined) this.details = details;
+  }
+
+  static fromResponse(status: number, body: unknown): NoveraChatError {
+    const rec = body as { error?: { code?: string; message?: string; details?: Record<string, unknown> } };
+    const code = rec?.error?.code ?? ErrorCode.INTERNAL;
+    const msg = rec?.error?.message ?? `HTTP ${status}`;
+    const details = rec?.error?.details;
+    return details !== undefined
+      ? new NoveraChatError(msg, code, status, details)
+      : new NoveraChatError(msg, code, status);
+  }
+}