@scalekit-sdk/node 2.0.0 → 2.1.0

package/lib/user.js.map

@@ -1 +1 @@
-{"version":3,"file":"user.js","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.0.0",
+  "version": "2.1.0",
   "name": "@scalekit-sdk/node",
   "description": "Official Scalekit Node SDK",
   "main": "lib/index.js",
@@ -11,7 +11,8 @@
   "scripts": {
     "generate": "npx buf generate $npm_config_src",
     "build": "rm -rf lib && tsc",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "jest",
+    "test:watch": "jest --watch"
   },
   "keywords": [
     "sso",
@@ -34,9 +35,12 @@
     "@bufbuild/buf": "^1.36.0",
     "@bufbuild/protoc-gen-es": "^1.10.0",
     "@connectrpc/protoc-gen-connect-es": "^1.4.0",
+    "@types/jest": "^29.5.14",
     "@types/node": "^20.14.10",
     "@types/qs": "^6.9.15",
     "dotenv": "^16.4.7",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.5.3"
   },

package/src/core.ts

@@ -4,8 +4,8 @@ import { JWK } from 'jose';
 import os from "os";
 import QueryString from "qs";
 import { GrantType } from './types/scalekit';
-import { ErrorInfo } from './pkg/grpc/scalekit/v1/errdetails/errdetails_pb';
 import { TokenResponse } from './types/auth';
+import { ScalekitException, ScalekitServerException } from './errors/base-exception';
 
 export const headers = {
   "user-agent": "user-agent",
@@ -20,8 +20,8 @@ export default class CoreClient {
   public keys: JWK[] = [];
   public accessToken: string | null = null;
   public axios: Axios;
-  public sdkVersion = `Scalekit-Node/2.0.0`;
-  public apiVersion = "20240430";
+  public sdkVersion = `Scalekit-Node/2.1.0`;
+  public apiVersion = "20250815";
   public userAgent = `${this.sdkVersion} Node/${process.version} (${process.platform}; ${os.arch()})`;
   constructor(
     readonly envUrl: string,
@@ -81,7 +81,7 @@ export default class CoreClient {
   }
 
   /**
-   * 
+   * Execute a function with error handling and retry logic
    * @param fn Function to execute
    * @param data Data to pass to the function
    * @param retryLeft Number of retries left
@@ -96,39 +96,38 @@ export default class CoreClient {
       const res = await fn(data);
       return res;
     } catch (error) {
-      if (retryLeft > 0) {
-        let isUnAuthenticatedError = false;
-        if (error instanceof AxiosError) {
-          if (error.status == HttpStatusCode.Unauthorized) {
-            isUnAuthenticatedError = true;
-          } else {
-            throw new Error(error.message);
+      // Handle gRPC Connect errors 
+      if (error instanceof ConnectError) {
+        if (retryLeft > 0) {
+          const serverException = new ScalekitServerException(error);
+          if (serverException.httpStatus === 401) {
+            await this.authenticateClient();
+            return this.connectExec(fn, data, retryLeft - 1);
           }
         }
-        // ConnectError is a custom error class that extends Error class and has a code property
-        if (error instanceof ConnectError) {
-          if (error.code == Code.Unauthenticated) {
-            isUnAuthenticatedError = true;
-          }
-          if (error.code == Code.InvalidArgument) {
-            const messages = [error.message]
-            error.findDetails(ErrorInfo).forEach((detail) => {
-              if (detail.validationErrorInfo) {
-                detail.validationErrorInfo.fieldViolations.forEach((fv) => {
-                  messages.push(`${fv.field}: ${fv.description}`)
-                })
-              }
-            })
-
-            throw new Error(messages.join("\n"));
+        throw ScalekitServerException.promote(error);
+      }
+      // Handle HTTP/Axios errors
+      if (error instanceof AxiosError) {
+        if (error.response) {
+          if (retryLeft > 0) {
+            const serverException = new ScalekitServerException(error.response);
+            if (serverException.httpStatus === 401) {
+              await this.authenticateClient();
+              return this.connectExec(fn, data, retryLeft - 1);
+            }
           }
+          throw ScalekitServerException.promote(error.response);
+        } else {
+          throw new ScalekitException(error);
         }
-        if (isUnAuthenticatedError) {
-          await this.authenticateClient();
-          return this.connectExec(fn, data, retryLeft - 1);
-        }
       }
-      throw error;
+      // Handle existing ScalekitException instances
+      if (error instanceof ScalekitException) {
+        throw error;
+      }
+      // Handle generic errors
+      throw new ScalekitException(error);
     }
   }
 }

package/src/errors/base-exception.ts

@@ -0,0 +1,262 @@
+import { ConnectError, Code } from '@connectrpc/connect';
+import { AxiosResponse } from 'axios';
+import { ErrorInfo } from '../pkg/grpc/scalekit/v1/errdetails/errdetails_pb';
+
+// gRPC to HTTP status mapping
+const GRPC_TO_HTTP: Record<number, number> = {
+  [Code.InvalidArgument]: 400,
+  [Code.FailedPrecondition]: 400,
+  [Code.OutOfRange]: 400,
+  [Code.Unauthenticated]: 401,
+  [Code.PermissionDenied]: 403,
+  [Code.NotFound]: 404,
+  [Code.AlreadyExists]: 409,
+  [Code.Aborted]: 409,
+  [Code.ResourceExhausted]: 429,
+  [Code.Canceled]: 499,
+  [Code.DataLoss]: 500,
+  [Code.Unknown]: 500,
+  [Code.Internal]: 500,
+  [Code.Unimplemented]: 501,
+  [Code.Unavailable]: 503,
+  [Code.DeadlineExceeded]: 504,
+};
+
+// HTTP to gRPC status mapping
+const HTTP_TO_GRPC: Record<number, number> = {
+  200: Code.Unknown, // No direct mapping for 200
+  400: Code.InvalidArgument,
+  401: Code.Unauthenticated,
+  403: Code.PermissionDenied,
+  404: Code.NotFound,
+  409: Code.AlreadyExists,
+  429: Code.ResourceExhausted,
+  500: Code.Internal,
+  501: Code.Unimplemented,
+  503: Code.Unavailable,
+  504: Code.DeadlineExceeded,
+};
+
+// HTTP status constants
+const HTTP_STATUS = {
+  'OK': 200,
+  'BAD_REQUEST': 400,
+  'UNAUTHORIZED': 401,
+  'FORBIDDEN': 403,
+  'NOT_FOUND': 404,
+  'CONFLICT': 409,
+  'TOO_MANY_REQUESTS': 429,
+  'INTERNAL_SERVER_ERROR': 500,
+  'NOT_IMPLEMENTED': 501,
+  'SERVICE_UNAVAILABLE': 503,
+  'GATEWAY_TIMEOUT': 504,
+};
+
+// Base exception class
+export class ScalekitException extends Error {
+  constructor(error: any) {
+    super(error?.message || error?.toString() || 'Unknown error');
+    this.name = 'ScalekitException';
+  }
+}
+
+// Webhook verification error
+export class WebhookVerificationError extends ScalekitException {
+  constructor(error: any) {
+    super(error);
+    this.name = 'WebhookVerificationError';
+  }
+}
+
+// Token validation failure exception
+export class ScalekitValidateTokenFailureException extends ScalekitException {
+  constructor(error: any) {
+    super(error);
+    this.name = 'ScalekitValidateTokenFailureException';
+  }
+}
+
+// Base server exception
+export class ScalekitServerException extends ScalekitException {
+  private _grpcStatus: Code;
+  private _httpStatus: number;
+  private _message: string | null;
+  private _errDetails: any;
+  private _errorCode: string | null;
+  private _unpackedDetails: ErrorInfo[];
+
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    
+    this._unpackedDetails = [];
+    
+    if (this.isAxiosResponse(error)) {
+      // Handle HTTP Response errors
+      if (error.statusText && typeof error.statusText === 'string') {
+        this._httpStatus = HTTP_STATUS[error.statusText.toUpperCase() as keyof typeof HTTP_STATUS] || HTTP_STATUS.INTERNAL_SERVER_ERROR;
+      } else {
+        this._httpStatus = HTTP_STATUS.INTERNAL_SERVER_ERROR;
+      }
+      this._grpcStatus = HTTP_TO_GRPC[error.status] || Code.Unknown;
+      this._errorCode = error.statusText;
+      this._errDetails = error.data;
+      this._message = null;
+    } else {
+      // Handle gRPC ConnectError
+      this._grpcStatus = error.code;
+      this._httpStatus = GRPC_TO_HTTP[error.code] || 500;
+      this._message = error.message;
+      this._errDetails = error.findDetails(ErrorInfo);
+      this._errorCode = null;
+
+      // Unpack error details
+      for (const detail of this._errDetails) {
+        this._unpackedDetails.push(detail);
+        if (!this._errorCode) {
+          this._errorCode = detail.errorCode;
+        }
+      }
+    }
+
+    this.name = 'ScalekitServerException';
+  }
+
+  private isAxiosResponse(error: any): error is AxiosResponse {
+    return error && typeof error.status === 'number' && typeof error.statusText === 'string';
+  }
+
+  // String representation
+  toString(): string {
+    const border = '='.repeat(40);
+    
+    if (this._unpackedDetails.length > 0) {
+      let detailsStr = JSON.stringify(this._unpackedDetails, null, 2);
+      
+      // Format the JSON string for better readability
+      
+      if (detailsStr.startsWith("[") && detailsStr.includes("\n")) {
+        detailsStr = "[\n" + detailsStr.substring(1);
+      }
+      
+      return `\n${border}\n` +
+             `Error Code: ${this._errorCode}\n` +
+             `GRPC: (${this.getGrpcStatusName()}: ${this._grpcStatus})\n` +
+             `HTTP: (${this.getHttpStatusName()}: ${this._httpStatus})\n` +
+             `Error Details:\n` +
+             `${this._message}: ${detailsStr}\n${border}\n`;
+    } else {
+      return `\n${border}\n` +
+             `Error Code: ${this._errorCode}\n` +
+             `GRPC: (${this.getGrpcStatusName()}: ${this._grpcStatus})\n` +
+             `HTTP: (${this.getHttpStatusName()}: ${this._httpStatus})\n` +
+             `Error Details: ${this._errDetails}\n${border}\n`;
+    }
+  }
+
+  // Helper method to get gRPC status name
+  private getGrpcStatusName(): string {
+    switch (this._grpcStatus) {
+      case Code.InvalidArgument: return 'INVALID_ARGUMENT';
+      case Code.FailedPrecondition: return 'FAILED_PRECONDITION';
+      case Code.OutOfRange: return 'OUT_OF_RANGE';
+      case Code.Unauthenticated: return 'UNAUTHENTICATED';
+      case Code.PermissionDenied: return 'PERMISSION_DENIED';
+      case Code.NotFound: return 'NOT_FOUND';
+      case Code.AlreadyExists: return 'ALREADY_EXISTS';
+      case Code.Aborted: return 'ABORTED';
+      case Code.ResourceExhausted: return 'RESOURCE_EXHAUSTED';
+      case Code.Canceled: return 'CANCELED';
+      case Code.DataLoss: return 'DATA_LOSS';
+      case Code.Unknown: return 'UNKNOWN';
+      case Code.Internal: return 'INTERNAL';
+      case Code.Unimplemented: return 'UNIMPLEMENTED';
+      case Code.Unavailable: return 'UNAVAILABLE';
+      case Code.DeadlineExceeded: return 'DEADLINE_EXCEEDED';
+      default: return 'UNKNOWN';
+    }
+  }
+
+  // Helper method to get HTTP status name
+  private getHttpStatusName(): string {
+    switch (this._httpStatus) {
+      case 200: return 'OK';
+      case 400: return 'BAD_REQUEST';
+      case 401: return 'UNAUTHORIZED';
+      case 403: return 'FORBIDDEN';
+      case 404: return 'NOT_FOUND';
+      case 409: return 'CONFLICT';
+      case 429: return 'TOO_MANY_REQUESTS';
+      case 500: return 'INTERNAL_SERVER_ERROR';
+      case 501: return 'NOT_IMPLEMENTED';
+      case 503: return 'SERVICE_UNAVAILABLE';
+      case 504: return 'GATEWAY_TIMEOUT';
+      default: return 'INTERNAL_SERVER_ERROR';
+    }
+  }
+
+  // Getters
+  get grpcStatus(): Code {
+    return this._grpcStatus;
+  }
+
+  get httpStatus(): number {
+    return this._httpStatus;
+  }
+
+  get errorCode(): string | null {
+    return this._errorCode;
+  }
+
+  get message(): string {
+    return this._message || super.message;
+  }
+
+  get errDetails(): any {
+    return this._errDetails;
+  }
+
+  get unpackedDetails(): ErrorInfo[] {
+    return this._unpackedDetails;
+  }
+
+  static promote(error: AxiosResponse | ConnectError): ScalekitServerException {
+    // Use dynamic import to avoid circular dependency
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const specific = require('./specific-exceptions');
+    const grpcStatus = error instanceof ConnectError
+      ? error.code
+      : HTTP_TO_GRPC[error.status] || Code.Unknown;
+
+    switch (grpcStatus) {
+      case Code.InvalidArgument:
+      case Code.FailedPrecondition:
+      case Code.OutOfRange:
+        return new specific.ScalekitBadRequestException(error);
+      case Code.Unauthenticated:
+        return new specific.ScalekitUnauthorizedException(error);
+      case Code.PermissionDenied:
+        return new specific.ScalekitForbiddenException(error);
+      case Code.NotFound:
+        return new specific.ScalekitNotFoundException(error);
+      case Code.AlreadyExists:
+      case Code.Aborted:
+        return new specific.ScalekitConflictException(error);
+      case Code.ResourceExhausted:
+        return new specific.ScalekitTooManyRequestsException(error);
+      case Code.Canceled:
+        return new specific.ScalekitCancelledException(error);
+      case Code.DataLoss:
+      case Code.Unknown:
+      case Code.Internal:
+        return new specific.ScalekitInternalServerException(error);
+      case Code.Unimplemented:
+        return new specific.ScalekitNotImplementedException(error);
+      case Code.Unavailable:
+        return new specific.ScalekitServiceUnavailableException(error);
+      case Code.DeadlineExceeded:
+        return new specific.ScalekitGatewayTimeoutException(error);
+      default:
+        return new specific.ScalekitUnknownException(error);
+    }
+  }
+} 

package/src/errors/index.ts

@@ -0,0 +1,3 @@
+// Export base exceptions
+export * from './base-exception';
+export * from './specific-exceptions'; 

package/src/errors/specific-exceptions.ts

@@ -0,0 +1,88 @@
+import { ConnectError } from '@connectrpc/connect';
+import { AxiosResponse } from 'axios';
+import { ScalekitServerException } from './base-exception';
+
+// Specific exception classes 
+export class ScalekitBadRequestException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitBadRequestException';
+  }
+}
+
+export class ScalekitUnauthorizedException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitUnauthorizedException';
+  }
+}
+
+export class ScalekitForbiddenException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitForbiddenException';
+  }
+}
+
+export class ScalekitNotFoundException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitNotFoundException';
+  }
+}
+
+export class ScalekitConflictException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitConflictException';
+  }
+}
+
+export class ScalekitTooManyRequestsException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitTooManyRequestsException';
+  }
+}
+
+export class ScalekitInternalServerException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitInternalServerException';
+  }
+}
+
+export class ScalekitNotImplementedException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitNotImplementedException';
+  }
+}
+
+export class ScalekitServiceUnavailableException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitServiceUnavailableException';
+  }
+}
+
+export class ScalekitGatewayTimeoutException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitGatewayTimeoutException';
+  }
+}
+
+export class ScalekitCancelledException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitCancelledException';
+  }
+}
+
+export class ScalekitUnknownException extends ScalekitServerException {
+  constructor(error: AxiosResponse | ConnectError) {
+    super(error);
+    this.name = 'ScalekitUnknownException';
+  }
+} 

package/src/index.ts

@@ -5,4 +5,6 @@ export { ScalekitClient as Scalekit };
 export default ScalekitClient;
 
 export * from "./types/scalekit";
-export * from "./types/auth";
+export * from "./types/auth";
+
+export * from "./errors";