@saptools/cf-debugger 0.1.11 → 0.1.13

package/README.md

@@ -12,7 +12,7 @@ Signal the remote process, enable SSH if needed, forward `9229` to a free local
 [![install size](https://packagephobia.com/badge?p=@saptools/cf-debugger)](https://packagephobia.com/result?p=@saptools/cf-debugger)
 [![types](https://img.shields.io/npm/types/@saptools/cf-debugger.svg?style=flat&color=3178C6&logo=typescript&logoColor=white)](https://www.typescriptlang.org)
 
-[Install](#-install) • [Quick Start](#-quick-start) • [CLI](#-cli) • [API](#-programmatic-usage) • [How it works](#-how-it-works) • [FAQ](#-faq)
+[Install](#-install) • [Quick Start](#-quick-start) • [CLI](#-cli) • [How it works](#-how-it-works) • [FAQ](#-faq)
 
 </div>
 
@@ -136,70 +136,6 @@ cf-debugger status --region eu10 --org my-org --space dev --app my-app
 
 ---
 
-## 🧑‍💻 Programmatic Usage
-
-```ts
-import {
-  startDebugger,
-  stopDebugger,
-  listSessions,
-  getSession,
-  resolveApiEndpoint,
-} from "@saptools/cf-debugger";
-
-const handle = await startDebugger({
-  region: "eu10",
-  org: "my-org",
-  space: "dev",
-  app: "my-app",
-  email: process.env["SAP_EMAIL"],
-  password: process.env["SAP_PASSWORD"],
-  verbose: true,
-  onStatus: (status, message) => {
-    console.log(`[${status}]`, message ?? "");
-  },
-});
-
-console.log(`Attach your debugger to localhost:${handle.session.localPort}`);
-
-// Later — shut the tunnel down and clean up state:
-await handle.dispose();
-```
-
-<details>
-<summary><b>📚 Full export list</b></summary>
-
-| Export | Description |
-| --- | --- |
-| `startDebugger(options)` | Open a tunnel; returns a `DebuggerHandle` |
-| `stopDebugger({ sessionId?, key? })` | Stop one session by id or by key |
-| `stopAllDebuggers()` | Stop every session owned by this process/machine |
-| `listSessions()` | Return every live session as `ActiveSession[]` |
-| `getSession(key)` | Return one session matching `{ region, org, space, app }` |
-| `resolveApiEndpoint(key, override?)` | Map a region key to its API endpoint |
-| `sessionKeyString(key)` | Stable string form of a session key |
-| `CfDebuggerError` | Rich error class with typed `code` |
-
-</details>
-
-<details>
-<summary><b>🧪 Error codes</b></summary>
-
-| Code | When |
-| --- | --- |
-| `MISSING_CREDENTIALS` | No `SAP_EMAIL` / `SAP_PASSWORD` in env or options |
-| `SESSION_ALREADY_RUNNING` | A session already exists for the same `region/org/space/app` |
-| `CF_LOGIN_FAILED` | `cf api` / `cf auth` rejected the credentials |
-| `CF_TARGET_FAILED` | Org or space not reachable |
-| `SSH_NOT_ENABLED` | SSH disabled at space or app level and could not be enabled |
-| `USR1_SIGNAL_FAILED` | Remote `kill -s USR1` failed, timed out, or was terminated by a signal |
-| `TUNNEL_NOT_READY` | Inspector didn't respond on port 9229 before timeout |
-| `PORT_UNAVAILABLE` | Preferred local port is taken and could not be freed |
-
-</details>
-
----
-
 ## 🔭 How it works
 
 ```

package/dist/cli.js

@@ -24,24 +24,41 @@ var REGION_API_ENDPOINTS = {
   ca10: "https://api.cf.ca10.hana.ondemand.com",
   ca20: "https://api.cf.ca20.hana.ondemand.com",
   ch20: "https://api.cf.ch20.hana.ondemand.com",
+  cn20: "https://api.cf.cn20.platform.sapcloud.cn",
+  cn40: "https://api.cf.cn40.platform.sapcloud.cn",
+  eu01: "https://api.cf.eu01.hana.ondemand.com",
+  eu02: "https://api.cf.eu02.hana.ondemand.com",
   eu10: "https://api.cf.eu10.hana.ondemand.com",
+  "eu10-002": "https://api.cf.eu10-002.hana.ondemand.com",
+  "eu10-003": "https://api.cf.eu10-003.hana.ondemand.com",
+  "eu10-004": "https://api.cf.eu10-004.hana.ondemand.com",
+  "eu10-005": "https://api.cf.eu10-005.hana.ondemand.com",
   eu11: "https://api.cf.eu11.hana.ondemand.com",
-  eu12: "https://api.cf.eu12.hana.ondemand.com",
+  eu13: "https://api.cf.eu13.hana.ondemand.com",
   eu20: "https://api.cf.eu20.hana.ondemand.com",
-  eu21: "https://api.cf.eu21.hana.ondemand.com",
+  "eu20-001": "https://api.cf.eu20-001.hana.ondemand.com",
+  "eu20-002": "https://api.cf.eu20-002.hana.ondemand.com",
+  eu22: "https://api.cf.eu22.hana.ondemand.com",
   eu30: "https://api.cf.eu30.hana.ondemand.com",
-  eu31: "https://api.cf.eu31.hana.ondemand.com",
+  il30: "https://api.cf.il30.hana.ondemand.com",
   in30: "https://api.cf.in30.hana.ondemand.com",
+  jp01: "https://api.cf.jp01.hana.ondemand.com",
   jp10: "https://api.cf.jp10.hana.ondemand.com",
   jp20: "https://api.cf.jp20.hana.ondemand.com",
   jp30: "https://api.cf.jp30.hana.ondemand.com",
-  kr30: "https://api.cf.kr30.hana.ondemand.com",
+  jp31: "https://api.cf.jp31.hana.ondemand.com",
+  sa30: "https://api.cf.sa30.hana.ondemand.com",
+  sa31: "https://api.cf.sa31.hana.ondemand.com",
+  uk20: "https://api.cf.uk20.hana.ondemand.com",
+  us01: "https://api.cf.us01.hana.ondemand.com",
+  us02: "https://api.cf.us02.hana.ondemand.com",
   us10: "https://api.cf.us10.hana.ondemand.com",
+  "us10-001": "https://api.cf.us10-001.hana.ondemand.com",
+  "us10-002": "https://api.cf.us10-002.hana.ondemand.com",
   us11: "https://api.cf.us11.hana.ondemand.com",
   us20: "https://api.cf.us20.hana.ondemand.com",
   us21: "https://api.cf.us21.hana.ondemand.com",
-  us30: "https://api.cf.us30.hana.ondemand.com",
-  us31: "https://api.cf.us31.hana.ondemand.com"
+  us30: "https://api.cf.us30.hana.ondemand.com"
 };
 function resolveApiEndpoint(regionKey, override) {
   if (override !== void 0 && override !== "") {
@@ -245,11 +262,19 @@ function parseTargetFields(stdout) {
 }
 function regionKeyForApiEndpoint(apiEndpoint) {
   const normalized = normalizeApiEndpoint(apiEndpoint);
-  return listKnownRegionKeys().find((key) => normalizeApiEndpoint(resolveApiEndpoint(key)) === normalized);
+  const known = listKnownRegionKeys().find((key) => normalizeApiEndpoint(resolveApiEndpoint(key)) === normalized);
+  if (known !== void 0) {
+    return known;
+  }
+  return regionKeyFromSapApiEndpoint(normalized);
 }
 function normalizeApiEndpoint(apiEndpoint) {
   return apiEndpoint.trim().replace(/\/+$/, "").toLowerCase();
 }
+function regionKeyFromSapApiEndpoint(apiEndpoint) {
+  const match = /^https:\/\/api\.cf\.([a-z]{2}\d{2}(?:-\d{3})?)\.(?:hana\.ondemand\.com|platform\.sapcloud\.cn)$/.exec(apiEndpoint);
+  return match?.[1];
+}
 function isPresent(value) {
   return value !== void 0 && value.length > 0;
 }
@@ -338,6 +363,7 @@ function sessionCfHomeDir(sessionId) {
 
 // src/network/ports.ts
 import { execFile as execFile3 } from "child_process";
+import { readdir, readFile, readlink } from "fs/promises";
 import { createConnection, createServer } from "net";
 import { promisify as promisify3 } from "util";
 var execFileAsync3 = promisify3(execFile3);
@@ -372,11 +398,75 @@ async function findListeningPidsWithLsof(port) {
     return [];
   }
 }
+async function findListeningPidsWithProc(port) {
+  const inodes = await findListeningSocketInodesWithProc(port);
+  if (inodes.size === 0) {
+    return [];
+  }
+  try {
+    const entries = await readdir("/proc", { withFileTypes: true });
+    const pids = /* @__PURE__ */ new Set();
+    for (const entry of entries) {
+      if (!entry.isDirectory() || !/^\d+$/.test(entry.name)) {
+        continue;
+      }
+      if (await processHasSocketInode(entry.name, inodes)) {
+        pids.add(Number.parseInt(entry.name, 10));
+      }
+    }
+    return [...pids];
+  } catch {
+    return [];
+  }
+}
+async function findListeningSocketInodesWithProc(port) {
+  const inodes = /* @__PURE__ */ new Set();
+  await collectListeningSocketInodes("/proc/net/tcp", port, inodes);
+  await collectListeningSocketInodes("/proc/net/tcp6", port, inodes);
+  return inodes;
+}
+async function collectListeningSocketInodes(path, port, inodes) {
+  try {
+    const content = await readFile(path, "utf8");
+    for (const line of content.split("\n").slice(1)) {
+      const fields = line.trim().split(/\s+/);
+      const localAddress = fields[1];
+      const state = fields[3];
+      const inode = fields[9];
+      if (localAddress === void 0 || state === void 0 || inode === void 0) {
+        continue;
+      }
+      const localPort = Number.parseInt(localAddress.split(":")[1] ?? "", 16);
+      if (localPort === port && state === "0A") {
+        inodes.add(inode);
+      }
+    }
+  } catch {
+  }
+}
+async function processHasSocketInode(pid, inodes) {
+  try {
+    const descriptors = await readdir(`/proc/${pid}/fd`);
+    for (const descriptor of descriptors) {
+      try {
+        const link = await readlink(`/proc/${pid}/fd/${descriptor}`);
+        const match = /^socket:\[(\d+)\]$/.exec(link);
+        if (match?.[1] !== void 0 && inodes.has(match[1])) {
+          return true;
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return false;
+}
 async function findListeningPids(port) {
   if (process.platform === "win32") {
     return await findListeningPidsWithNetstat(port);
   }
-  return await findListeningPidsWithLsof(port);
+  const lsofPids = await findListeningPidsWithLsof(port);
+  return lsofPids.length > 0 ? lsofPids : await findListeningPidsWithProc(port);
 }
 async function isPortFree(port) {
   return await new Promise((resolve) => {
@@ -459,7 +549,7 @@ async function killProcessOnPort(port) {
 
 // src/session-state/store.ts
 import { randomUUID } from "crypto";
-import { mkdir as mkdir2, readFile, rename, writeFile } from "fs/promises";
+import { mkdir as mkdir2, readFile as readFile2, rename, writeFile } from "fs/promises";
 import { hostname as getHostname } from "os";
 import { dirname as dirname2 } from "path";
 import process2 from "process";
@@ -516,7 +606,7 @@ async function withFileLock(lockPath, work, options) {
 async function readJsonFile(path) {
   let raw;
   try {
-    raw = await readFile(path, "utf8");
+    raw = await readFile2(path, "utf8");
   } catch (err) {
     const code = err.code;
     if (code === "ENOENT") {