@ceki/sdk 1.9.2 → 1.11.0

package/README.md

@@ -21,7 +21,7 @@ import { connect } from '@ceki/sdk';
 
 const client = await connect(process.env.CEKI_API_KEY!);
 const options = await client.search({ geo: 'US', language: 'en' });
-const browser = await client.rent(options[0].schedule_id);
+const browser = await client.rent(options[0].browser_id);
 
 await browser.navigate('https://example.com');
 const snap = await browser.snapshot();
@@ -53,9 +53,9 @@ Establish a WebSocket connection to the relay. Returns a `Client` instance.
 
 Search for available browsers. Filters: `geo`, `language`, etc.
 
-### `client.rent(scheduleId, opts?) -> Browser`
+### `client.rent(browserId, opts?) -> Browser`
 
-Rent a browser by schedule ID. Waits up to 60s for a match. Options:
+Rent a browser by browser ID. Waits up to 60s for a match. Options:
 - `human` — `'natural'` (default), `'careful'`, or `null` (no humanization)
 - `maskingMode` — enable masking
 - `fingerprint` — `true`, `false`, or fingerprint object
@@ -115,13 +115,13 @@ Browser actions include human-like timing by default — delays before/after act
 
 ```typescript
 // Default: natural profile (enabled by default)
-const browser = await client.rent(scheduleId);
+const browser = await client.rent(browserId);
 
 // Explicit profile
-const browser = await client.rent(scheduleId, { human: 'careful' });
+const browser = await client.rent(browserId, { human: 'careful' });
 
 // Disable humanization
-const browser = await client.rent(scheduleId, { human: null });
+const browser = await client.rent(browserId, { human: null });
 ```
 
 ### Environment overrides
@@ -168,8 +168,8 @@ npm install -g @ceki/sdk
 ```bash
 export CEKI_API_KEY=ag_...
 
-SCHEDULE=$(ceki search --limit 1 | jq -r '.[0].schedule_id')
-SID=$(ceki rent --schedule $SCHEDULE | jq -r .session_id)
+BROWSER=$(ceki search --limit 1 | jq -r '.[0].browser_id')
+SID=$(ceki rent --browser $BROWSER | jq -r .session_id)
 ceki navigate $SID https://example.com
 ceki snapshot $SID -o snap.png
 ceki stop $SID
@@ -185,7 +185,7 @@ The CLI persists session state locally — after `rent` it saves the session ID
 |---|---|
 | `search [--limit N] [--filter K=V]…` | List available browsers |
 | `my-browsers` | List browsers with pre-arranged rent contracts |
-| `rent --schedule ID [--mode incognito\|main] [--fingerprint-from FILE]` | Rent a browser |
+| `rent --browser ID [--mode incognito\|main] [--fingerprint-from FILE]` | Rent a browser |
 | `sessions [--all] [--limit N] [--json]` | List your sessions |
 | `stop SID` | End a session |
 | `wait SID` | Block until the session ends |

package/dist/cli.js

@@ -125,6 +125,9 @@ var ChatSendFailed = class extends CekiBrowserError {
   }
 };
 
+// src/browser.ts
+import mime from "mime-types";
+
 // src/chat.ts
 import * as crypto from "crypto";
 import * as fs from "fs";
@@ -190,7 +193,7 @@ var BrowserChat = class {
     if (buf.length > MAX_IMAGE_SIZE) {
       throw new Error(`Image too large: ${buf.length} bytes (max ${MAX_IMAGE_SIZE})`);
     }
-    const { mime, ext } = detectMime(buf);
+    const { mime: mime2, ext } = detectMime(buf);
     if (!filename.includes(".")) {
       filename = `${filename}.${ext}`;
     }
@@ -201,7 +204,7 @@ var BrowserChat = class {
       session_id: this._browser.sessionId,
       client_msg_id: clientMsgId,
       filename,
-      mime,
+      mime: mime2,
       data_b64
     };
     if (text) msg.text = text;
@@ -557,10 +560,9 @@ function keymapForChar(char) {
 }
 
 // src/browser.ts
-var Browser = class {
+var Browser = class _Browser {
   sessionId;
   browserId;
-  scheduleId;
   chatTopicId;
   browserInfo;
   providerUserId;
@@ -606,8 +608,7 @@ var Browser = class {
   constructor(client, match, humanizer) {
     this._client = client;
     this.sessionId = match.session_id;
-    this.browserId = match.schedule_id;
-    this.scheduleId = match.schedule_id;
+    this.browserId = match.browser_id;
     this.chatTopicId = match.chat_topic_id ?? null;
     this.browserInfo = match.browser_info ?? {};
     this.providerUserId = match.provider_user_id ?? null;
@@ -622,7 +623,7 @@ var Browser = class {
     saveSession(this.sessionId, {
       session_id: this.sessionId,
       chat_topic_id: this.chatTopicId,
-      schedule_id: this.scheduleId,
+      browser_id: this.browserId,
       last_seen_ts: this._lastSeenTs
     });
   }
@@ -797,7 +798,10 @@ var Browser = class {
       ts: /* @__PURE__ */ new Date()
     };
   }
-  async upload(selector, source, filename) {
+  static _detectMime(filename) {
+    return mime.lookup(filename) || "application/octet-stream";
+  }
+  async upload(selector, source, filename, mime2) {
     let buf;
     let resolvedFilename;
     if (typeof source === "string") {
@@ -809,6 +813,8 @@ var Browser = class {
       buf = Buffer.isBuffer(source) ? source : Buffer.from(source);
       resolvedFilename = filename ?? "file";
     }
+    const mimeType = mime2 ?? _Browser._detectMime(resolvedFilename);
+    console.info(`upload: file=${resolvedFilename} mime=${mimeType} size=${buf.length}`);
     const b64 = buf.toString("base64");
     const size = buf.length;
     const expression = `
@@ -819,7 +825,7 @@ var Browser = class {
         var binary = atob(b64);
         var bytes = new Uint8Array(binary.length);
         for (var i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
-        var file = new File([bytes], ${JSON.stringify(resolvedFilename)}, {type: 'application/octet-stream'});
+        var file = new File([bytes], ${JSON.stringify(resolvedFilename)}, {type: ${JSON.stringify(mimeType)}});
         var dt = new DataTransfer();
         dt.items.add(file);
         input.files = dt.files;
@@ -832,6 +838,17 @@ var Browser = class {
       params: { expression, returnByValue: true }
     });
     const resultObj = result?.result;
+    try {
+      await this.send({
+        method: "Input.dispatchKeyEvent",
+        params: { type: "keyDown", key: "Escape", code: "Escape", windowsVirtualKeyCode: 27, nativeVirtualKeyCode: 27 }
+      });
+      await this.send({
+        method: "Input.dispatchKeyEvent",
+        params: { type: "keyUp", key: "Escape", code: "Escape", windowsVirtualKeyCode: 27, nativeVirtualKeyCode: 27 }
+      });
+    } catch {
+    }
     if (resultObj?.value) {
       return JSON.parse(String(resultObj.value));
     }
@@ -1375,7 +1392,7 @@ var Client = class _Client {
   _pongTimer = null;
   _lastPongAt = 0;
   _pendingRents = /* @__PURE__ */ new Map();
-  // keyed by `rent:<scheduleId>` or eventId
+  // keyed by `rent:<browserId>` or eventId
   _pendingResumes = /* @__PURE__ */ new Map();
   // keyed by sessionId
   _connectResolve = null;
@@ -1466,18 +1483,18 @@ var Client = class _Client {
     const items = body.browsers ?? body.data ?? body;
     return Array.isArray(items) ? items : [];
   }
-  async rent(scheduleId, opts) {
-    const rentMsg = { type: "rent", browser_id: scheduleId };
+  async rent(browserId, opts) {
+    const rentMsg = { type: "rent", browser_id: browserId };
     if (opts?.mode) rentMsg.mode = opts.mode;
     this._wsSend(rentMsg);
-    const key = `rent:${scheduleId}`;
+    const key = `rent:${browserId}`;
     return new Promise((resolve2, reject) => {
       const timer = setTimeout(() => {
         this._pendingRents.delete(key);
         reject(new TimeoutError("Rent timed out after 90s"));
       }, 9e4);
       this._pendingRents.set(key, {
-        scheduleId,
+        browserId,
         eventId: null,
         opts,
         resolve: (match) => {
@@ -1782,7 +1799,7 @@ var Client = class _Client {
   }
   _onMatch(msg) {
     const eventId = String(msg.event_id ?? "");
-    const scheduleId = Number(msg.schedule_id ?? 0);
+    const browserId = Number(msg.browser_id ?? 0);
     const sessionId = String(msg.session_id ?? "");
     if (msg.requires_ack) {
       try {
@@ -1792,15 +1809,15 @@ var Client = class _Client {
     }
     let pending = this._pendingRents.get(`event:${eventId}`);
     if (!pending) {
-      pending = this._pendingRents.get(`rent:${scheduleId}`);
+      pending = this._pendingRents.get(`rent:${browserId}`);
     }
     if (pending) {
       clearTimeout(pending.timer);
-      const key = pending.eventId ? `event:${pending.eventId}` : `rent:${pending.scheduleId}`;
+      const key = pending.eventId ? `event:${pending.eventId}` : `rent:${pending.browserId}`;
       this._pendingRents.delete(key);
       const match = {
         session_id: sessionId,
-        schedule_id: scheduleId,
+        browser_id: browserId,
         event_id: eventId || null,
         chat_topic_id: msg.chat_topic_id ? String(msg.chat_topic_id) : null,
         provider_user_id: msg.provider_user_id != null ? Number(msg.provider_user_id) : null,
@@ -1842,7 +1859,7 @@ var Client = class _Client {
     const match = {
       session_id: sessionId,
       event_id: msg.event_id != null ? String(msg.event_id) : null,
-      schedule_id: Number(msg.schedule_id ?? 0),
+      browser_id: Number(msg.browser_id ?? 0),
       chat_topic_id: msg.chat_topic_id ? String(msg.chat_topic_id) : null,
       provider_user_id: msg.provider_user_id != null ? Number(msg.provider_user_id) : null,
       started_at: Date.now(),
@@ -1997,11 +2014,11 @@ function parseBool(val) {
   return val === "true" || val === "1" || val === "yes";
 }
 async function cmdRent(args) {
-  let scheduleId = null;
+  let browserId = null;
   let fingerprintFrom = null;
   let mode = "incognito";
   for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--schedule" && args[i + 1]) scheduleId = parseInt(args[++i], 10);
+    if (args[i] === "--browser" && args[i + 1]) browserId = parseInt(args[++i], 10);
     if (args[i] === "--fingerprint-from" && args[i + 1]) fingerprintFrom = args[++i];
     if (args[i] === "--mode" && args[i + 1]) {
       const v = args[++i];
@@ -2012,8 +2029,8 @@ async function cmdRent(args) {
       mode = v;
     }
   }
-  if (scheduleId == null) {
-    err("--schedule is required", "args");
+  if (browserId == null) {
+    err("--browser is required", "args");
     process.exit(1);
   }
   const apiKey = getApiKey();
@@ -2024,17 +2041,17 @@ async function cmdRent(args) {
   }
   const client = await connect(apiKey, connectOptions());
   try {
-    const browser = await client.rent(scheduleId, { human: null, fingerprint: fpData, mode });
+    const browser = await client.rent(browserId, { human: null, fingerprint: fpData, mode });
     saveSession(browser.sessionId, {
       session_id: browser.sessionId,
       chat_topic_id: browser.chatTopicId,
-      schedule_id: browser.scheduleId,
+      browser_id: browser.browserId,
       last_seen_ts: null
     });
     out({
       session_id: browser.sessionId,
       chat_topic_id: browser.chatTopicId,
-      schedule_id: browser.scheduleId
+      browser_id: browser.browserId
     });
   } finally {
     await closeClient(client);
@@ -2079,7 +2096,7 @@ async function cmdSessions(args) {
         process.stdout.write("No sessions found.\n");
         return;
       }
-      const header = "SID".padEnd(8) + "SCHEDULE".padEnd(10) + "STARTED".padEnd(22) + "DURATION".padEnd(10) + "EARNED".padEnd(9) + "STATUS".padEnd(10) + "RENTER".padEnd(16) + "PROVIDER";
+      const header = "SID".padEnd(8) + "BROWSER".padEnd(10) + "STARTED".padEnd(22) + "DURATION".padEnd(10) + "EARNED".padEnd(9) + "STATUS".padEnd(10) + "RENTER".padEnd(16) + "PROVIDER";
       process.stdout.write(header + "\n");
       for (const s of results) {
         const started = s.started_at ?? "\u2014";
@@ -2089,7 +2106,7 @@ async function cmdSessions(args) {
         const earned = `$${s.earned.toFixed(2)}`;
         const renter = s.renter?.name ?? "\u2014";
         const provider = s.provider?.name ?? "\u2014";
-        const line = String(s.id).padEnd(8) + String(s.schedule_id).padEnd(10) + started.padEnd(22) + dur.padEnd(10) + earned.padEnd(9) + s.status.padEnd(10) + renter.padEnd(16) + provider;
+        const line = String(s.id).padEnd(8) + String(s.browser_id).padEnd(10) + started.padEnd(22) + dur.padEnd(10) + earned.padEnd(9) + s.status.padEnd(10) + renter.padEnd(16) + provider;
         process.stdout.write(line + "\n");
       }
     }
@@ -2482,10 +2499,12 @@ async function cmdUpload(sid, args) {
   let selector = null;
   let filePath = null;
   let filename;
+  let mime2;
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--selector" && args[i + 1]) selector = args[++i];
     if (args[i] === "--file" && args[i + 1]) filePath = args[++i];
     if (args[i] === "--filename" && args[i + 1]) filename = args[++i];
+    if (args[i] === "--mime" && args[i + 1]) mime2 = args[++i];
   }
   if (!selector || !filePath) {
     err("--selector and --file are required", "args");
@@ -2498,7 +2517,7 @@ async function cmdUpload(sid, args) {
   const apiKey = getApiKey();
   const [client, browser] = await resumeBrowser(apiKey, sid);
   try {
-    const result = await browser.upload(selector, filePath, filename);
+    const result = await browser.upload(selector, filePath, filename, mime2);
     out(result);
   } finally {
     await closeClient(client);
@@ -2510,7 +2529,7 @@ function printHelp() {
 Usage: ceki <command> [options]
 
 Commands:
-  rent --schedule N [--fingerprint-from PATH]
+  rent --browser N [--fingerprint-from PATH]
   my-browsers
   search [--limit N] [--filter k=v]...
   snapshot <sid> -o PATH
@@ -2522,7 +2541,7 @@ Commands:
   switch-tab <sid>
   configure <sid> [--masking-mode true|false] [--fingerprint true|false]
   cdp <sid> --method <M> [--params JSON]
-  upload <sid> --selector CSS --file PATH [--filename NAME]
+  upload <sid> --selector CSS --file PATH [--filename NAME] [--mime TYPE]
   request-captcha <sid> [--acceptance N] [--completion M] [--manual]
   wait <sid>
   chat <sid> send "<text>"