New error handling & SquareCloudAPI returns apiManager

Author: joaotonaco

src/APIManager.ts

@@ -2,15 +2,17 @@ import { APIResponse, RawUserData } from './typings';
 import axios, { AxiosRequestConfig } from 'axios';
 
 export class SquareCloudAPIError extends Error {
-  constructor(code: string) {
+  constructor(code: string, message?: string) {
     super();
 
     this.name = 'SquareCloudAPIError';
 
-    this.message = code
-      .replaceAll('_', ' ')
-      .toLowerCase()
-      .replace(/(^|\s)\S/g, (L) => L.toUpperCase());
+    this.message =
+      code
+        .replaceAll('_', ' ')
+        .toLowerCase()
+        .replace(/(^|\s)\S/g, (L) => L.toUpperCase()) +
+      (message ? `: ${message}` : '');
   }
 }
 

src/Assertions.ts

@@ -1,22 +1,58 @@
+import { SquareCloudAPIError } from './APIManager';
 import { ReadStream } from 'fs';
 import z from 'zod';
 
-export function validateString(value: any): asserts value is string {
-  z.string().parse(value);
+export function validateString(
+  value: any,
+  code?: string,
+  starts: string = ''
+): asserts value is string {
+  if (starts) validateString(starts);
+
+  handleParser(
+    () => z.string().parse(value),
+    'Expect string, got ' + typeof value,
+    code
+  );
 }
 
-export function validateBoolean(value: any): asserts value is boolean {
-  z.boolean().parse(value);
+export function validateBoolean(
+  value: any,
+  code?: string
+): asserts value is boolean {
+  handleParser(
+    () => z.boolean().parse(value),
+    'Expect boolean, got ' + typeof value,
+    code
+  );
 }
 
 export function validateCommitLike(
-  value: any
-): asserts value is string | ReadStream {
-  z.string()
-    .or(
+  value: any,
+  code?: string
+): asserts value is string | ReadStream | Buffer {
+  handleParser(
+    () =>
       z
-        .custom((value) => value instanceof ReadStream)
-        .or(z.custom((value) => value instanceof Buffer))
-    )
-    .parse(value);
+        .string()
+        .or(
+          z
+            .custom((value) => value instanceof ReadStream)
+            .or(z.custom((value) => value instanceof Buffer))
+        )
+        .parse(value),
+    'Expect string, ReadStream or Buffer, got ' + typeof value,
+    code
+  );
+}
+
+function handleParser(func: any, message: string, code?: string) {
+  try {
+    func();
+  } catch {
+    throw new SquareCloudAPIError(
+      code ? `INVALID_${code}` : 'VALIDATION_ERROR',
+      message
+    );
+  }
 }

src/index.ts

@@ -9,15 +9,15 @@ export class SquareCloudAPI {
     baseUrl: 'https://api.squarecloud.app/v1/public/',
   };
 
-  private apiManager: APIManager;
+  public readonly apiManager: APIManager;
 
   /**
    * Creates an API instance
    *
    * @param apiKey - Your API Token (you can get it at [SquareCloud Dashboard](https://squarecloud.app/dashboard))
    */
   constructor(apiKey: string) {
-    validateString(apiKey);
+    validateString(apiKey, 'API_KEY');
 
     this.apiManager = new APIManager(apiKey);
   }
@@ -30,7 +30,7 @@ export class SquareCloudAPI {
   async getUser(): Promise<FullUser>;
   async getUser(userId: string): Promise<User>;
   async getUser(userId?: string): Promise<User> {
-    if (userId) validateString(userId);
+    if (userId) validateString(userId, 'USER_ID');
 
     const userData = await this.apiManager.user(userId);
     const hasAccess = userData.user.email !== 'Access denied';
@@ -44,7 +44,7 @@ export class SquareCloudAPI {
    * @param appId - The application id, you must own the application
    */
   async getApplication(appId: string): Promise<Application> {
-    validateString(appId);
+    validateString(appId, 'APP_ID');
 
     const { applications } = await this.apiManager.user();
     const appData = applications.find((app) => app.id === appId);

src/structures/Application.ts

@@ -85,7 +85,7 @@ export class Application {
    * @param full - Whether you want the complete logs (true) or the recent ones (false)
    */
   async getLogs(full: boolean = false) {
-    validateBoolean(full);
+    validateBoolean(full, '[LOGS_FULL]');
 
     return (
       await this.apiManager.application(`${full ? 'full-' : ''}logs`, this.id)
@@ -138,7 +138,7 @@ export class Application {
    * Commit changes to a specific file inside your application folder
    *
    * - This action is irreversible.
-   * - Tip: use this to get an absolute path. 
+   * - Tip: use this to get an absolute path.
    * ```ts
    * require('path').join(__dirname, 'fileName')
    * ```
@@ -150,20 +150,20 @@ export class Application {
   async commit(
     file: Buffer,
     fileName: string,
-    fileExtension: string
+    fileExtension: `.${string}`
   ): Promise<boolean>;
   async commit(
     file: string | ReadStream | Buffer,
     fileName?: string,
-    fileExtension?: string
+    fileExtension?: `.${string}`
   ): Promise<boolean> {
-    validateCommitLike(file);
+    validateCommitLike(file, 'COMMIT_DATA');
 
     const formData = new FormData();
 
     if (file instanceof Buffer) {
-      validateString(fileName);
-      validateString(fileExtension);
+      validateString(fileName, 'FILE_NAME');
+      validateString(fileExtension, 'FILE_EXTENSION');
 
       formData.append('file', file, { filename: fileName + fileExtension });
     } else {