cloreai 4.1.0 → 5.0.0

package/README.md

@@ -103,6 +103,7 @@ await cloreai.setServerSettings({
     'USD-Blockchain': { on_demand: 1, spot: 1 },
     'bitcoin': { on_demand: 1, spot: 1 },
   },
+  'auto_renew_allowed': true,
 })
 ```
 
@@ -136,26 +137,45 @@ await cloreai.cancelOrders({
 
 ```typescript
 await cloreai.createOrder({
-  type: 'on-demand',
   currency: 'CLORE-Blockchain',
   image: 'cloreai/jupyter:ubuntu24.04-v2',
   renting_server: 5738,
+  type: 'on-demand',
   ports: { 22: 'tcp', 8888: 'http' },
   env: { SSH_PASSWORD: 'SSH_PASSWORD', JUPYTER_TOKEN: 'JUPYTER_TOKEN' },
   jupyter_token: 'JUPYTER_TOKEN',
   ssh_password: 'SSH_PASSWORD',
   required_price: 50,
-  remember_passwords: true,
+  remember_password: true,
+  auto_renew: true,
+  auto_renew_max_price: 50,
+})
+```
+
+### 12. set_order_auto_renew
+
+```typescript
+await cloreai.setOrderAutoRenew({
+  order_id: 38,
+  rental_hours: null,
+  auto_renew: true,
+  auto_renew_max_price: 300,
 })
 ```
 
-### 12. poh_balance
+### 13. order_renewals
+
+```typescript
+const orderRenewals = await cloreai.orderRenewals({ order_id: 38 })
+```
+
+### 14. poh_balance
 
 ```typescript
 const pohBalance = await cloreai.pohBalance()
 ```
 
-### 13. renter_fees
+### 15. renter_fees
 
 ```typescript
 const renterFees = await cloreai.renterFees()
@@ -175,9 +195,16 @@ const marketplace = await cloreai.marketplace({
 
 Use the `CloreaiError` class for error handling.
 
-Errors have fields with information `error.statusCode` and `error.description`.
+To check the error type based on its code, use the `statusCodes` constant.
+
+Errors include an `error.data` field, which contains the server
+response—including a code and a description of the error—and, in some cases,
+additional fields with further error details.
 
-Use the constant `statusCodes` to check the error type.
+This class only catches errors when a response has been successfully received,
+but the response code is not equal to `statusCodes.NORMAL` (0). Be sure to
+implement a pattern for propagating unknown exceptions (such as connection
+errors, etc.), as shown in the example below.
 
 ```typescript
 import { CloreaiError, statusCodes } from 'cloreai'
@@ -186,9 +213,9 @@ try {
   const marketplace = await cloreai.marketplace()
 } catch (error) {
   if (error instanceof CloreaiError) {
-    console.log(error.statusCode, error.description)
+    console.log('Error data:', error.data)
 
-    if (error.statusCode === statusCodes.EXCEEDED) {
+    if (error.data.code === statusCodes.EXCEEDED) {
       console.log('Rate limit exceeded error')
     }
   } else {

package/dist/Cloreai.d.ts

@@ -1,13 +1,15 @@
-import PQueue, { type Options as PQueueOptions, type Queue, type QueueAddOptions } from 'p-queue';
+import PQueue, { type Options as QueueOptions } from 'p-queue';
 import type { CancelOrderRequestData, CancelOrderResponseData } from './resources/cancelOrder.ts';
 import type { CancelOrdersRequestData, CancelOrdersResponseData } from './resources/cancelOrders.ts';
 import type { CreateOrderRequestData, CreateOrderResponseData } from './resources/createOrder.ts';
 import type { MarketplaceResponseData } from './resources/marketplace.ts';
 import type { MyOrdersRequestParams, MyOrdersResponseData } from './resources/myOrders.ts';
 import type { MyServersResponseData } from './resources/myServers.ts';
+import type { OrderRenewalsRequestData, OrderRenewalsResponseData } from './resources/orderRenewals.ts';
 import type { PohBalanceResponseData } from './resources/pohBalance.ts';
 import type { RenterFeesResponseData } from './resources/renterFees.ts';
 import type { ServerConfigRequestData, ServerConfigResponseData } from './resources/serverConfig.ts';
+import type { SetOrderAutoRenewRequestData, SetOrderAutoRenewResponseData } from './resources/setOrderAutoRenew.ts';
 import type { SetServerSettingsRequestData, SetServerSettingsResponseData } from './resources/setServerSettings.ts';
 import type { SetSpotPriceRequestData, SetSpotPriceResponseData } from './resources/setSpotPrice.ts';
 import type { SpotMarketplaceRequestParams, SpotMarketplaceResponseData } from './resources/spotMarketplace.ts';
@@ -19,7 +21,6 @@ export interface Options {
     queueOptions?: QueueOptions;
     queueCreateOrderOptions?: QueueOptions;
 }
-export type QueueOptions = PQueueOptions<Queue<() => Promise<unknown>, QueueAddOptions>, QueueAddOptions>;
 declare class Cloreai {
     #private;
     apiKey: string;
@@ -40,6 +41,8 @@ declare class Cloreai {
     cancelOrder(data: CancelOrderRequestData, init?: RequestInit): Promise<CancelOrderResponseData>;
     cancelOrders(data: CancelOrdersRequestData, init?: RequestInit): Promise<CancelOrdersResponseData>;
     createOrder(data: CreateOrderRequestData, init?: RequestInit): Promise<CreateOrderResponseData>;
+    setOrderAutoRenew(data: SetOrderAutoRenewRequestData, init?: RequestInit): Promise<SetOrderAutoRenewResponseData>;
+    orderRenewals(data: OrderRenewalsRequestData, init?: RequestInit): Promise<OrderRenewalsResponseData>;
     pohBalance(init?: RequestInit): Promise<PohBalanceResponseData>;
     renterFees(init?: RequestInit): Promise<RenterFeesResponseData>;
 }

package/dist/Cloreai.js

@@ -47,34 +47,12 @@ class Cloreai {
             headers,
             signal,
         };
-        const url = new URL(input);
-        const request = new Request(url, mergedInit);
-        let response;
-        try {
-            response = await this.fetch(request);
-        }
-        catch (error) {
-            throw new CloreaiError(error instanceof Error ? error.message : String(error), {
-                cause: error,
-                init: mergedInit,
-                request,
-            });
-        }
+        const request = new Request(input, mergedInit);
+        const response = await this.fetch(request);
         const originalJson = response.json;
         // @ts-expect-error: json is readonly
         response.json = async () => {
-            let data;
-            try {
-                data = await originalJson.call(response);
-            }
-            catch (error) {
-                throw new CloreaiError(error instanceof Error ? error.message : String(error), {
-                    cause: error,
-                    init: mergedInit,
-                    request,
-                    response,
-                });
-            }
+            const data = await originalJson.call(response);
             if (data.code === statusCodes.NORMAL) {
                 return data;
             }
@@ -83,11 +61,8 @@ class Cloreai {
                 ? `Code "${data.code}, error "${data.error}"`
                 : `Code "${data.code}"`;
             throw new CloreaiError(errorMessage, {
-                init: mergedInit,
                 request,
                 response,
-                statusCode: data.code,
-                description: data.error ?? '',
                 data,
             });
         };
@@ -248,6 +223,34 @@ class Cloreai {
         });
         return await response.json();
     }
+    async setOrderAutoRenew(data, init = {}) {
+        const url = new URL(this.baseURL + '/set_order_auto_renew');
+        const response = await this.queue.add(async () => {
+            return await this.#fetch(url, {
+                ...init,
+                method: 'POST',
+                body: JSON.stringify(data),
+            });
+        }, {
+            priority: priorityLevels.NORMAL,
+            signal: init.signal ?? undefined,
+        });
+        return await response.json();
+    }
+    async orderRenewals(data, init = {}) {
+        const url = new URL(this.baseURL + '/order_renewals');
+        const response = await this.queue.add(async () => {
+            return await this.#fetch(url, {
+                ...init,
+                method: 'POST',
+                body: JSON.stringify(data),
+            });
+        }, {
+            priority: priorityLevels.NORMAL,
+            signal: init.signal ?? undefined,
+        });
+        return await response.json();
+    }
     async pohBalance(init = {}) {
         const url = new URL(this.baseURL + '/poh_balance');
         const response = await this.queue.add(async () => {

package/dist/CloreaiError.d.ts

@@ -1,17 +1,18 @@
+import type { ResponseData } from './types.ts';
+export interface ErrorData extends ResponseData {
+    max_step?: number;
+    time_to_lowering?: number;
+    min_price?: number;
+    [key: string]: unknown;
+}
 export interface CloreaiErrorOptions extends ErrorOptions {
-    init?: RequestInit;
-    request?: Request;
-    response?: Response;
-    statusCode?: number;
-    description?: string;
-    data?: unknown;
+    request: Request;
+    response: Response;
+    data: ErrorData;
 }
 export declare class CloreaiError extends Error {
-    init?: RequestInit;
-    request?: Request;
-    response?: Response;
-    statusCode?: number;
-    description?: string;
-    data?: unknown;
-    constructor(message?: string, options?: CloreaiErrorOptions);
+    request: Request;
+    response: Response;
+    data: ErrorData;
+    constructor(message: string, options: CloreaiErrorOptions);
 }

package/dist/CloreaiError.js

@@ -1,13 +1,12 @@
 export class CloreaiError extends Error {
-    init;
     request;
     response;
-    statusCode;
-    description;
     data;
     constructor(message, options) {
         super(message, options);
         this.name = 'CloreaiError';
-        Object.assign(this, options);
+        this.request = options.request;
+        this.response = options.response;
+        this.data = options.data;
     }
 }

package/dist/index.d.ts

@@ -8,9 +8,11 @@ export type * from './resources/createOrder.ts';
 export type * from './resources/marketplace.ts';
 export type * from './resources/myOrders.ts';
 export type * from './resources/myServers.ts';
+export type * from './resources/orderRenewals.ts';
 export type * from './resources/pohBalance.ts';
 export type * from './resources/renterFees.ts';
 export type * from './resources/serverConfig.ts';
+export type * from './resources/setOrderAutoRenew.ts';
 export type * from './resources/setServerSettings.ts';
 export type * from './resources/setSpotPrice.ts';
 export type * from './resources/spotMarketplace.ts';

package/dist/resources/createOrder.d.ts

@@ -1,17 +1,10 @@
 import type { Currency, OrderType, ResponseData } from '../types.ts';
-export type CreateOrderRequestData = CreateOrderOnDemand | CreateOrderSpot;
-export interface CreateOrderOnDemand extends CreateOrderBase {
-    type: 'on-demand';
-}
-export interface CreateOrderSpot extends CreateOrderBase {
-    type: 'spot';
-    spotprice: number;
-}
-export interface CreateOrderBase {
-    type: OrderType;
+export interface CreateOrderRequestData {
     currency: Currency;
     image: string;
     renting_server: number;
+    type: OrderType;
+    spotprice?: number;
     ports?: Record<string, string>;
     env?: Record<string, string>;
     jupyter_token?: string;
@@ -20,11 +13,12 @@ export interface CreateOrderBase {
     command?: string;
     required_price?: number;
     autossh_entrypoint?: boolean;
-    remember_passwords?: boolean;
+    remember_password?: boolean;
     dockerhub_auth?: string;
     gpu_count?: number;
     gpu_indices?: number[];
+    rental_hours?: number;
+    auto_renew?: boolean;
+    auto_renew_max_price?: number;
 }
-export interface CreateOrderResponseData extends ResponseData {
-    min_price?: number;
-}
+export type CreateOrderResponseData = ResponseData;

package/dist/resources/marketplace.d.ts

@@ -13,6 +13,7 @@ export interface MarketplaceServer {
     partial_gpu_rental: false | MarketplaceServerPartialGpuRental;
     reliability: number;
     allowed_coins: Currency[];
+    auto_renew_allowed: boolean;
     rating: Rating;
     gpu_array: string[];
     oc?: boolean;

package/dist/resources/myOrders.d.ts

@@ -23,6 +23,16 @@ export interface MyOrdersOrder {
     total_gpus: number;
     gpu_array: string[];
     si: number;
+    rental_hours: number;
+    rental_end: number;
+    term_start: number;
+    term_end: number;
+    term_mrl: number;
+    last_renewal_at: number;
+    auto_renew: boolean;
+    auto_renew_max_price: number;
+    renewals_count: number;
+    ssh_auth: string;
     my_past_rating?: number;
     auto_login: string;
     mon_container: number;
@@ -38,4 +48,5 @@ export interface MyOrdersOrder {
     expired?: boolean;
     paused?: boolean;
     online: boolean;
+    autossh: boolean;
 }

package/dist/resources/myServers.d.ts

@@ -13,6 +13,7 @@ export interface MyServersServer {
     init_token?: string;
     specs: Specs;
     allowed_currencies: Currency[];
+    auto_renew_allowed: boolean;
     rented: boolean;
     remaining_time: number;
     rented_currency: Currency;

package/dist/resources/orderRenewals.d.ts

@@ -0,0 +1,21 @@
+import type { ResponseData } from '../types.ts';
+export interface OrderRenewalsRequestData {
+    order_id: number;
+}
+export interface OrderRenewalsResponseData extends ResponseData {
+    renewals: OrderRenewal;
+}
+export interface OrderRenewal {
+    order_id: number;
+    renewal_no: number;
+    outcome: string;
+    reason: string;
+    decided_at: number;
+    applied_at: number;
+    old_price: number;
+    new_price: number;
+    cap: number;
+    term_seconds: number;
+    term_start: number;
+    term_end: number;
+}

package/dist/resources/orderRenewals.js

@@ -0,0 +1 @@
+export {};

package/dist/resources/serverConfig.d.ts

@@ -18,6 +18,7 @@ export interface ServerConfig {
     id: number;
     rental_status: number;
     partial_rental_enabled: boolean;
+    auto_renew_allowed: boolean;
     specs: Specs;
     background_job: ServerConfigBackgroundJob;
     init_communication_token: string;

package/dist/resources/setOrderAutoRenew.d.ts

@@ -0,0 +1,8 @@
+import type { ResponseData } from '../types.ts';
+export interface SetOrderAutoRenewRequestData {
+    order_id: number;
+    rental_hours?: number | null;
+    auto_renew?: boolean;
+    auto_renew_max_price?: number;
+}
+export type SetOrderAutoRenewResponseData = ResponseData;

package/dist/resources/setOrderAutoRenew.js

@@ -0,0 +1 @@
+export {};

package/dist/resources/setServerSettings.d.ts

@@ -14,5 +14,6 @@ export interface SetServerSettingsRequestData {
     'enabled-bitcoin'?: boolean;
     'autoprice'?: AutoPrice;
     'usd_pricing'?: PricingInOriginalUsd;
+    'auto_renew_allowed'?: boolean;
 }
 export type SetServerSettingsResponseData = ResponseData;

package/dist/resources/setSpotPrice.d.ts

@@ -3,8 +3,4 @@ export interface SetSpotPriceRequestData {
     order_id: number;
     desired_price: number;
 }
-export interface SetSpotPriceResponseData extends ResponseData {
-    max_step?: number;
-    time_to_lowering?: number;
-    min_price?: number;
-}
+export type SetSpotPriceResponseData = ResponseData;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloreai",
-  "version": "4.1.0",
+  "version": "5.0.0",
   "description": "CLORE.AI API client",
   "keywords": [
     "cloreai",
@@ -29,15 +29,15 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "p-queue": "^9.3.4"
+    "p-queue": "^10.0.0"
   },
   "devDependencies": {
     "@tsconfig/node-lts": "^24.0.1",
     "@tsconfig/node-ts": "^23.6.4",
     "@tsconfig/strictest": "^2.0.8",
     "@types/node": "^26.6.5",
-    "eslint": "^10.12.0",
-    "eslint-config-vladpuz": "^4.3.0",
+    "eslint": "^10.13.0",
+    "eslint-config-vladpuz": "^4.4.1",
     "husky": "^9.1.7",
     "prettier": "^3.9.10",
     "prettier-config-vladpuz": "^3.0.2",