@ticatec/restful_service_api 0.5.0 → 0.6.1

package/dist/ApiError.d.ts

@@ -8,19 +8,25 @@ export default class ApiError extends Error {
     /**
      * Error code from the API response
      */
-    get code(): any;
+    get code(): string;
     /**
      * Detailed error information from the API response
      */
-    get details(): any;
+    get details(): ApiErrorPayload;
     /**
      * HTTP status code of the error response
      */
-    get status(): any;
+    get status(): string | number;
     /**
      * Creates a new API error instance
      * @param status HTTP status code
      * @param err Error object containing code and details
      */
-    constructor(status: any, err: any);
+    constructor(status: number | string, err?: ApiErrorPayload | Error | string);
+}
+/** Error details returned by an API or produced by a request failure. */
+export interface ApiErrorPayload {
+    code?: string;
+    message?: string;
+    [key: string]: unknown;
 }

package/dist/ApiError.js

@@ -26,10 +26,22 @@ export default class ApiError extends Error {
      * @param err Error object containing code and details
      */
     constructor(status, err) {
-        super(err.code);
+        var _a, _b;
+        const details = normalizeError(err);
+        const code = (_b = (_a = details.code) !== null && _a !== void 0 ? _a : details.message) !== null && _b !== void 0 ? _b : 'UNKNOWN_ERROR';
+        super(code);
         this.name = this.constructor.name;
-        this._code = err.code;
+        this._code = code;
         this._status = status;
-        this._details = err;
+        this._details = details;
     }
 }
+const normalizeError = (err) => {
+    if (typeof err === 'string') {
+        return { code: err, message: err };
+    }
+    if (err instanceof Error) {
+        return { code: 'UNKNOWN_ERROR', message: err.message, cause: err };
+    }
+    return err !== null && err !== void 0 ? err : { code: 'UNKNOWN_ERROR' };
+};

package/dist/FileService.d.ts

@@ -1,5 +1,6 @@
-import UploadCallback from "./UploadCallback";
-import { DataProcessor } from "./RestService";
+import type UploadCallback from "./UploadCallback.js";
+import type { UploadProgress } from "./UploadCallback.js";
+import type { DataProcessor } from "./RestService.js";
 /**
  * File service interface for file upload and download operations
  */
@@ -60,7 +61,7 @@ export default interface FileService {
      * progress.abort();
      * ```
      */
-    asyncUpload(url: string, params: any, file: File, callback: UploadCallback, fileKey?: string): Promise<import("./UploadCallback").UploadProgress>;
+    asyncUpload(url: string, params: any, file: File, callback: UploadCallback, fileKey?: string): Promise<UploadProgress>;
     /**
      * Performs file download operation
      * @param url The URL path to download the file

package/dist/RestService.d.ts

@@ -14,7 +14,7 @@ export interface PreInterceptorResult {
 /**
  * Data processor function type for transforming response data
  */
-export type DataProcessor = (data: any) => any;
+export type DataProcessor<T = any> = (data: any) => T;
 /**
  * Pre-interceptor function type for modifying requests before sending
  * @param method HTTP method (GET, POST, etc.)
@@ -31,13 +31,13 @@ export type PostInterceptor = (data: any) => Promise<any>;
 /**
  * Error handler function type for handling request errors
  * @param ex The error object
- * @returns Boolean indicating if the error was handled (true) or should be thrown (false)
+ * @returns Optional boolean or void. Errors always reject the returned Promise.
  */
-export type ErrorHandler = (ex: Error) => boolean;
+export type ErrorHandler = (ex: Error) => boolean | void;
 /**
  * RESTful API request options
  */
-export type RestfulOptions = {
+export type RestfulOptions<T = any> = {
     /**
      * Optional Content-Type header, defaults to 'application/json'
      */
@@ -45,7 +45,7 @@ export type RestfulOptions = {
     /**
      * Optional data processing function to transform response data before returning
      */
-    dataProcessor?: DataProcessor;
+    dataProcessor?: DataProcessor<T>;
     /**
      * Optional query parameters object that will be converted to URL query string
      */
@@ -90,7 +90,7 @@ export default interface RestService {
      * const users = await restService.get('/api/users', null, (data) => data.items);
      * ```
      */
-    get(url: string, params?: any, dataProcessor?: DataProcessor): Promise<any>;
+    get<T = any>(url: string, params?: any, dataProcessor?: DataProcessor<T>): Promise<T>;
     /**
      * Performs an HTTP POST request to create a new resource
      * @param url The target URL path for the request
@@ -114,7 +114,7 @@ export default interface RestService {
      * });
      * ```
      */
-    post(url: string, data?: any, options?: RestfulOptions): Promise<any>;
+    post<T = any>(url: string, data?: any, options?: RestfulOptions<T>): Promise<T>;
     /**
      * Performs an HTTP PUT request to update an existing resource
      * @param url The target URL path for the request
@@ -131,7 +131,7 @@ export default interface RestService {
      * const result = await restService.put('/api/users/123/toggle-status');
      * ```
      */
-    put(url: string, data?: any, options?: RestfulOptions): Promise<any>;
+    put<T = any>(url: string, data?: any, options?: RestfulOptions<T>): Promise<T>;
     /**
      * Performs an HTTP DELETE request to delete a resource
      * @param url The target URL path for the request
@@ -148,7 +148,7 @@ export default interface RestService {
      * await restService.del('/api/users/batch', { ids: [1, 2, 3] });
      * ```
      */
-    del(url: string, data?: any, options?: RestfulOptions): Promise<any>;
+    del<T = any>(url: string, data?: any, options?: RestfulOptions<T>): Promise<T>;
     /**
      * Performs an HTTP PATCH request to partially update a resource
      * @param url The target URL path for the request
@@ -167,5 +167,5 @@ export default interface RestService {
      * });
      * ```
      */
-    patch(url: string, data?: any, options?: RestfulOptions): Promise<any>;
+    patch<T = any>(url: string, data?: any, options?: RestfulOptions<T>): Promise<T>;
 }

package/dist/UploadCallback.d.ts

@@ -35,7 +35,7 @@ export default interface UploadCallback {
     /**
      * HTTP request method, defaults to POST, but allows PUT or other methods in special cases
      */
-    method: string;
+    method?: string;
     /**
      * Optional upload progress update callback function
      */

package/dist/index.d.ts

@@ -1,13 +1,14 @@
-import ApiError from "./ApiError";
-import RestService from "./RestService";
-import FileService from "./FileService";
-import { ErrorHandler, PostInterceptor, PreInterceptor, DataProcessor } from "./RestService";
-import { PreInterceptorResult } from "./RestService";
-import { CONTENT_TYPE_NAME, TYPE_JSON, TYPE_HTML, TYPE_TEXT } from "./RestService";
-import UploadCallback, { UploadProgress, ProgressUpdate, OnCompleted, OnUploaded } from "./UploadCallback";
-import { RestfulOptions } from "./RestService";
+import ApiError from "./ApiError.js";
+import type { ApiErrorPayload } from "./ApiError.js";
+import RestService from "./RestService.js";
+import FileService from "./FileService.js";
+import type { ErrorHandler, PostInterceptor, PreInterceptor, DataProcessor, PreInterceptorResult, RestfulOptions } from "./RestService.js";
+import { CONTENT_TYPE_NAME, TYPE_JSON, TYPE_HTML, TYPE_TEXT } from "./RestService.js";
+import type UploadCallback from "./UploadCallback.js";
+import type { UploadProgress, ProgressUpdate, OnCompleted, OnUploaded } from "./UploadCallback.js";
 export default RestService;
 export { ApiError };
+export type { ApiErrorPayload };
 export { RestService };
 export { FileService };
 export type { ErrorHandler, PostInterceptor, PreInterceptor, DataProcessor };

package/dist/index.js

@@ -1,4 +1,4 @@
-import ApiError from "./ApiError";
-import { CONTENT_TYPE_NAME, TYPE_JSON, TYPE_HTML, TYPE_TEXT } from "./RestService";
+import ApiError from "./ApiError.js";
+import { CONTENT_TYPE_NAME, TYPE_JSON, TYPE_HTML, TYPE_TEXT } from "./RestService.js";
 export { ApiError };
 export { CONTENT_TYPE_NAME, TYPE_JSON, TYPE_HTML, TYPE_TEXT };

package/package.json

@@ -1,8 +1,8 @@
 {
   "type": "module",
   "name": "@ticatec/restful_service_api",
-  "version": "0.5.0",
-  "description": "A lightweight TypeScript RESTful API client for browsers with error handling. (ESM only, v0.5.0+)",
+  "version": "0.6.1",
+  "description": "A lightweight TypeScript RESTful API client for browsers with error handling. (ESM only, v0.6.0+)",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,23 +13,24 @@
   ],
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     },
     "./ApiError": {
+      "types": "./dist/ApiError.d.ts",
       "import": "./dist/ApiError.js",
-      "require": "./dist/ApiError.js",
-      "types": "./dist/ApiError.d.ts"
+      "default": "./dist/ApiError.js"
     },
     "./utils": {
+      "types": "./dist/utils.d.ts",
       "import": "./dist/utils.js",
-      "require": "./dist/utils.js",
-      "types": "./dist/utils.d.ts"
+      "default": "./dist/utils.js"
     }
   },
   "scripts": {
     "build": "tsc",
+    "test": "vitest run",
     "clean": "rm -rf dist",
     "prepare": "npm run clean && npm run build",
     "publish:public": "npm publish --access public"
@@ -55,6 +56,7 @@
   "dependencies": {
   },
   "devDependencies": {
-    "typescript": "^5.4.5"
+    "typescript": "^5.4.5",
+    "vitest": "^3.2.4"
   }
 }