@heroku/heroku-cli-util 9.1.0 → 9.1.1

package/dist/types/pg/tunnel.d.ts

@@ -1,5 +1,4 @@
 import { Server } from 'node:net';
-import * as createTunnel from 'tunnel-ssh';
 import type { ExtendedAddonAttachment } from './data-api';
 export type ConnectionDetails = {
     _tunnel?: Server;
@@ -14,7 +13,15 @@ export type ConnectionDetails = {
 export type ConnectionDetailsWithAttachment = {
     attachment: ExtendedAddonAttachment;
 } & ConnectionDetails;
-export type TunnelConfig = createTunnel.Config;
+export interface TunnelConfig {
+    dstHost: string;
+    dstPort: number;
+    host?: string;
+    localHost: string;
+    localPort: number;
+    privateKey?: string;
+    username: string;
+}
 export interface BastionConfigResponse {
     host: string;
     private_key: string;

package/dist/utils/pg/bastion.d.ts

@@ -1,6 +1,5 @@
 import type { APIClient } from '@heroku-cli/command';
 import { Server } from 'node:net';
-import * as createTunnel from 'tunnel-ssh';
 import { ExtendedAddonAttachment } from '../../types/pg/data-api';
 import { BastionConfig, ConnectionDetailsWithAttachment, TunnelConfig } from '../../types/pg/tunnel';
 /**
@@ -46,7 +45,7 @@ export declare const getBastionConfig: (config: Record<string, string>, baseName
  */
 export declare function getPsqlConfigs(connectionDetails: ConnectionDetailsWithAttachment): {
     dbEnv: NodeJS.ProcessEnv;
-    dbTunnelConfig: createTunnel.Config;
+    dbTunnelConfig: TunnelConfig;
 };
 export type PsqlConfigs = ReturnType<typeof getPsqlConfigs>;
 /**
@@ -55,8 +54,18 @@ export type PsqlConfigs = ReturnType<typeof getPsqlConfigs>;
  * @param connectionDetails - The database connection details with attachment information
  * @param dbTunnelConfig - The tunnel configuration object
  * @param timeout - The timeout in milliseconds (default: 10000)
- * @param createSSHTunnel - The function to create the SSH tunnel (default: promisified createTunnel.default)
+ * @param createSSHTunnel - The function to create the SSH tunnel
  * @returns Promise that resolves to the tunnel server or null if no bastion key is provided
  * @throws Error if unable to establish the tunnel
  */
-export declare function sshTunnel(connectionDetails: ConnectionDetailsWithAttachment, dbTunnelConfig: TunnelConfig, timeout?: number, createSSHTunnel?: (arg1: createTunnel.Config | undefined) => Promise<Server>): Promise<Server | void>;
+export declare function sshTunnel(connectionDetails: ConnectionDetailsWithAttachment, dbTunnelConfig: TunnelConfig, timeout?: number, createSSHTunnel?: typeof createSSHTunnelAdapter): Promise<Server | void>;
+/**
+ * Adapter for tunnel-ssh v5 API. Translates our TunnelConfig into the v5
+ * createTunnel(tunnelOptions, serverOptions, sshOptions, forwardOptions) call
+ * and returns the created local Server.
+ *
+ * @param config - The tunnel configuration to translate for v5 API
+ * @returns Promise that resolves to the created local TCP Server
+ */
+declare function createSSHTunnelAdapter(config: TunnelConfig): Promise<Server>;
+export {};

package/dist/utils/pg/bastion.js

@@ -8,8 +8,7 @@ exports.sshTunnel = sshTunnel;
 const tslib_1 = require("tslib");
 const debug_1 = tslib_1.__importDefault(require("debug"));
 const node_events_1 = require("node:events");
-const node_util_1 = require("node:util");
-const createTunnel = tslib_1.__importStar(require("tunnel-ssh"));
+const tunnelSsh = tslib_1.__importStar(require("tunnel-ssh"));
 const host_1 = tslib_1.__importDefault(require("./host"));
 const pgDebug = (0, debug_1.default)('pg');
 /**
@@ -140,11 +139,11 @@ function tunnelConfig(connectionDetails) {
  * @param connectionDetails - The database connection details with attachment information
  * @param dbTunnelConfig - The tunnel configuration object
  * @param timeout - The timeout in milliseconds (default: 10000)
- * @param createSSHTunnel - The function to create the SSH tunnel (default: promisified createTunnel.default)
+ * @param createSSHTunnel - The function to create the SSH tunnel
  * @returns Promise that resolves to the tunnel server or null if no bastion key is provided
  * @throws Error if unable to establish the tunnel
  */
-async function sshTunnel(connectionDetails, dbTunnelConfig, timeout = 10000, createSSHTunnel = (0, node_util_1.promisify)(createTunnel.default)) {
+async function sshTunnel(connectionDetails, dbTunnelConfig, timeout = 10000, createSSHTunnel = createSSHTunnelAdapter) {
     if (!connectionDetails.bastionKey) {
         return;
     }
@@ -205,3 +204,34 @@ class Timeout {
         }
     }
 }
+/**
+ * Adapter for tunnel-ssh v5 API. Translates our TunnelConfig into the v5
+ * createTunnel(tunnelOptions, serverOptions, sshOptions, forwardOptions) call
+ * and returns the created local Server.
+ *
+ * @param config - The tunnel configuration to translate for v5 API
+ * @returns Promise that resolves to the created local TCP Server
+ */
+async function createSSHTunnelAdapter(config) {
+    const tunnelOptions = {
+        autoClose: true,
+        reconnectOnError: false,
+    };
+    const serverOptions = {
+        host: config.localHost,
+        port: config.localPort,
+    };
+    const sshOptions = {
+        host: config.host,
+        privateKey: config.privateKey,
+        username: config.username,
+    };
+    const forwardOptions = {
+        dstAddr: config.dstHost,
+        dstPort: config.dstPort,
+        srcAddr: config.localHost,
+        srcPort: config.localPort,
+    };
+    const [server] = await tunnelSsh.createTunnel(tunnelOptions, serverOptions, sshOptions, forwardOptions);
+    return server;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heroku/heroku-cli-util",
-  "version": "9.1.0",
+  "version": "9.1.1",
   "description": "Set of helpful CLI utilities",
   "author": "Heroku",
   "license": "ISC",
@@ -19,7 +19,6 @@
     "@types/node": "^22.15.3",
     "@types/sinon": "^17.0.4",
     "@types/sinon-chai": "^4.0.0",
-    "@types/tunnel-ssh": "4.1.1",
     "chai": "^4.4.1",
     "chai-as-promised": "^7.1.2",
     "eslint": "^8.57.0",
@@ -45,7 +44,7 @@
     "@heroku/http-call": "^5.4.0",
     "@oclif/core": "^2.16.0",
     "debug": "^4.4.0",
-    "tunnel-ssh": "4.1.6"
+    "tunnel-ssh": "5.2.0"
   },
   "engines": {
     "node": ">=20"