@bizjaya/finclient 0.2.0 → 0.2.2

package/README.md

@@ -1,7 +1,7 @@
 # @bizjaya/finclient
 
-The official TypeScript SDK for FinCopy's public API, `https://api.fincopy.pro`. Version 0.2.0 uses numeric ACNO account
-paths under `/v1/fxs` and changes the 0.1 API; see the changelog before upgrading.
+The official TypeScript SDK for FinCopy's public API, `https://api.fincopy.io`. Since version 0.2.0 it uses numeric ACNO
+account paths under `/v1/fxs`, which changed the 0.1 API; see the changelog before upgrading.
 
 ```sh
 npm install @bizjaya/finclient
@@ -18,7 +18,7 @@ for (const account of accounts.items) console.log(account.Fleet?.Account?.ACNO,
 // await fin.copy.orders.make(52014125, { SYM: "EURUSD", ACT: "NEW", OTY: "OP_BUY", LOT: 0.01 });
 ```
 
-The client defaults to `https://api.fincopy.pro`. Account-scoped methods take the numeric ACNO, and paged list methods
+The client defaults to `https://api.fincopy.io`. Account-scoped methods take the numeric ACNO, and paged list methods
 return `{ items, paging, ... }`. DTO fields keep the API's PascalCase names.
 
 - `copy.accounts`: settings and lifecycle, pairs, symbols, quotes, orders, history, DCA, performance, activity, strategy
@@ -43,7 +43,13 @@ const account = await fin.copy.accounts.get(52014125);
 ```
 
 The API accepts browser requests only from FinCopy's own sites. Session trade writes pass the member's trade-PIN gate on
-the server. The main entry uses no Node.js built-ins, so it runs in browsers, Node.js 18+, Deno and Bun.
+the server. The main entry uses no Node.js built-ins, so it runs in browsers, Node.js 20+, Deno and Bun.
+
+`copy.accounts.remove(acno, { TrPin }, options)` disconnects the hosted terminal, forgets its broker password and frees its seat.
+Customer account settings and trade history remain so the login can be restored later; a free demo's account and terminal records
+are deleted. Open orders stay at the broker, and virtual TP, SL and TS stop working while no terminal runs. Include the member's
+trading PIN for a session account when its PIN is enabled; API-key requests do not use a session PIN. Pass an `idempotencyKey`
+in `options` so retries receive the same operation.
 
 ## Results, errors and the stream
 

package/dist/index.cjs

@@ -120,7 +120,7 @@ var FinHttpTransport = class {
   constructor(options) {
     this.apiKey = options.apiKey?.trim() ?? "";
     if (!this.apiKey && !options.fetch) throw new TypeError("apiKey is required unless a custom fetch authenticates the member session.");
-    this.baseUrl = (options.baseUrl ?? "https://api.fincopy.pro").replace(/\/+$/, "");
+    this.baseUrl = (options.baseUrl ?? "https://api.fincopy.io").replace(/\/+$/, "");
     const base = new URL(this.baseUrl);
     if (!/^https?:$/.test(base.protocol) || base.search || base.hash) {
       throw new TypeError("baseUrl must be an absolute HTTP or HTTPS URL without a query or fragment.");
@@ -527,9 +527,11 @@ var AccountsResource = class {
   restart(acno, options = {}) {
     return this.operation(acno, "restart", options);
   }
-  /** Queues account removal. */
-  remove(acno, options = {}) {
-    return this.http.request("DELETE", accountPath(acno), void 0, options);
+  remove(acno, commandOrOptions = {}, options = {}) {
+    const hasCommand = Object.prototype.hasOwnProperty.call(commandOrOptions, "TrPin");
+    const command = hasCommand ? commandOrOptions : { TrPin: null };
+    const requestOptions = hasCommand ? options : commandOrOptions;
+    return this.http.request("DELETE", accountPath(acno), command, requestOptions);
   }
   operation(acno, action, options) {
     return this.http.request("POST", `${accountPath(acno)}/${action}`, void 0, options);
@@ -643,7 +645,7 @@ var FxResource = class {
   }
   /** Searches broker servers available when adding an account. */
   brokers(query, platform, demosOnly, options = {}) {
-    return this.http.request("GET", queryPath("v1/brokers", void 0, { Q: query, Platform: platform, DemosOnly: demosOnly }), void 0, options);
+    return this.http.request("GET", queryPath("v1/brokers", void 0, { query, Platform: platform, DemosOnly: demosOnly }), void 0, options);
   }
 };
 var ChangesResource = class {