@ceki/sdk 1.10.0 → 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

@@ -563,7 +563,6 @@ function keymapForChar(char) {
 var Browser = class _Browser {
   sessionId;
   browserId;
-  scheduleId;
   chatTopicId;
   browserInfo;
   providerUserId;
@@ -609,8 +608,7 @@ var Browser = class _Browser {
   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;
@@ -625,7 +623,7 @@ var Browser = class _Browser {
     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
     });
   }
@@ -1394,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;
@@ -1485,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) => {
@@ -1801,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 {
@@ -1811,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,
@@ -1861,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(),
@@ -2016,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];
@@ -2031,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();
@@ -2043,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);
@@ -2098,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";
@@ -2108,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");
       }
     }
@@ -2531,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