@adhdev/ghostty-vt-node 1.0.78 → 1.0.82-rc.37

package/src/addon.cc

@@ -1,4 +1,7 @@
 #include <algorithm>
+#include <cmath>
+#include <cstdint>
+#include <memory>
 #include <string>
 
 #include <napi.h>
@@ -7,10 +10,34 @@
 
 namespace {
 
+// Native state of one terminal handle. Ownership is shared: the handle's
+// `_native` External and EVERY method function hold a std::shared_ptr to it,
+// each released by that JS object's own finalizer. A method taken off the
+// handle (`const get = t.getViewport`) therefore keeps the state alive after
+// the handle is collected, and the terminal is destroyed only when the last
+// holder goes. Finalizers run in any order (including at env teardown) without
+// one of them leaving the others with a dangling pointer.
+//
+// This is preferred over validating `this` as a wrapped receiver: detached
+// methods are ordinary JS (destructuring, passing `t.write` as a callback) and
+// keep working instead of throwing, and no receiver check is needed on the
+// hot path. A disposed terminal throws ERR_GHOSTTY_DISPOSED.
 struct TerminalBindingState {
   AdhdevGhosttyTerminal* terminal = nullptr;
+
+  TerminalBindingState() = default;
+  TerminalBindingState(const TerminalBindingState&) = delete;
+  TerminalBindingState& operator=(const TerminalBindingState&) = delete;
+  ~TerminalBindingState() {
+    if (terminal) {
+      adhdev_ghostty_terminal_destroy(terminal);
+      terminal = nullptr;
+    }
+  }
 };
 
+using SharedState = std::shared_ptr<TerminalBindingState>;
+
 std::string BuildGhosttyErrorMessage(const char* context, int result) {
   return std::string(context) + ": " + adhdev_ghostty_result_message(result);
 }
@@ -19,29 +46,42 @@ void ThrowGhosttyError(Napi::Env env, const char* context, int result) {
   Napi::Error::New(env, BuildGhosttyErrorMessage(context, result)).ThrowAsJavaScriptException();
 }
 
+void ThrowCodedError(Napi::Env env, const std::string& message, const char* code, bool range = false) {
+  Napi::Error error = range ? Napi::RangeError::New(env, message) : Napi::Error::New(env, message);
+  error.Value().Set("code", Napi::String::New(env, code));
+  error.ThrowAsJavaScriptException();
+}
+
+// info.Data() is the calling function's own SharedState holder, which lives as
+// long as that function object, so the state it points to is always alive here.
 TerminalBindingState* GetState(const Napi::CallbackInfo& info) {
-  if (!info.Data()) {
-    Napi::Error::New(info.Env(), "missing native terminal state").ThrowAsJavaScriptException();
+  auto* holder = static_cast<SharedState*>(info.Data());
+  if (!holder || !*holder) {
+    ThrowCodedError(info.Env(), "missing native terminal state", "ERR_GHOSTTY_NO_STATE");
     return nullptr;
   }
-  return static_cast<TerminalBindingState*>(info.Data());
+  return holder->get();
 }
 
 bool EnsureOpen(Napi::Env env, TerminalBindingState* state) {
-  if (!state || !state->terminal) {
-    Napi::Error::New(env, "ghostty terminal already disposed").ThrowAsJavaScriptException();
+  if (!state) return false;  // GetState already threw
+  if (!state->terminal) {
+    ThrowCodedError(env, "ghostty terminal already disposed", "ERR_GHOSTTY_DISPOSED");
     return false;
   }
   return true;
 }
 
-void FinalizeState(Napi::Env, TerminalBindingState* state) {
-  if (!state) return;
-  if (state->terminal) {
-    adhdev_ghostty_terminal_destroy(state->terminal);
-    state->terminal = nullptr;
-  }
-  delete state;
+void ReleaseSharedState(Napi::Env, SharedState* holder) {
+  delete holder;
+}
+
+// A method function holding its own share of the state.
+Napi::Function NewMethod(Napi::Env env, const SharedState& state, const char* name, Napi::Function::Callback callback) {
+  auto* holder = new SharedState(state);
+  Napi::Function fn = Napi::Function::New(env, callback, name, holder);
+  fn.AddFinalizer(ReleaseSharedState, holder);
+  return fn;
 }
 
 Napi::Value Write(const Napi::CallbackInfo& info) {
@@ -162,9 +202,279 @@ Napi::Value GetCursorPosition(const Napi::CallbackInfo& info) {
   return output;
 }
 
+constexpr uint64_t kMaxSafeInteger = 9007199254740991ULL;
+
+const char* WideKindName(uint8_t wide) {
+  switch (wide) {
+    case ADHDEV_GHOSTTY_WIDE_WIDE:
+      return "wide";
+    case ADHDEV_GHOSTTY_WIDE_SPACER_TAIL:
+      return "spacer-tail";
+    case ADHDEV_GHOSTTY_WIDE_SPACER_HEAD:
+      return "spacer-head";
+    default:
+      return "narrow";
+  }
+}
+
+int WideWidth(uint8_t wide) {
+  switch (wide) {
+    case ADHDEV_GHOSTTY_WIDE_WIDE:
+      return 2;
+    case ADHDEV_GHOSTTY_WIDE_SPACER_TAIL:
+    case ADHDEV_GHOSTTY_WIDE_SPACER_HEAD:
+      return 0;
+    default:
+      return 1;
+  }
+}
+
+Napi::Object RowToObject(Napi::Env env, const AdhdevGhosttyRowData& row, const char* space) {
+  Napi::Object output = Napi::Object::New(env);
+  output.Set("row", Napi::Number::New(env, row.row));
+  output.Set("coordinateSpace", Napi::String::New(env, space));
+  output.Set("text", Napi::String::New(env, row.text ? row.text : "", row.text_len));
+  output.Set("wrapped", Napi::Boolean::New(env, row.wrapped));
+  output.Set("wrapContinuation", Napi::Boolean::New(env, row.wrap_continuation));
+  if (row.cells) {
+    Napi::Array cells = Napi::Array::New(env, row.cell_count);
+    for (size_t i = 0; i < row.cell_count; i++) {
+      const AdhdevGhosttyCellInfo& info = row.cells[i];
+      Napi::Object cell = Napi::Object::New(env);
+      cell.Set("col", Napi::Number::New(env, static_cast<double>(i)));
+      cell.Set("text", Napi::String::New(
+          env,
+          info.text_len ? row.cell_text + info.text_offset : "",
+          info.text_len));
+      cell.Set("width", Napi::Number::New(env, WideWidth(info.wide)));
+      cell.Set("wideKind", Napi::String::New(env, WideKindName(info.wide)));
+      cells.Set(static_cast<uint32_t>(i), cell);
+    }
+    output.Set("cells", cells);
+  }
+  return output;
+}
+
+// Reads an optional boolean option, rejecting non-boolean values instead of
+// coercing them.
+bool ReadBoolOption(Napi::Env env, const Napi::Object& options, const char* name, bool* out) {
+  if (!options.Has(name)) return true;
+  Napi::Value value = options.Get(name);
+  if (value.IsUndefined()) return true;
+  if (!value.IsBoolean()) {
+    Napi::TypeError::New(env, std::string(name) + " must be a boolean").ThrowAsJavaScriptException();
+    return false;
+  }
+  *out = value.As<Napi::Boolean>().Value();
+  return true;
+}
+
+bool ReadOptionsObject(Napi::Env env, const Napi::CallbackInfo& info, size_t index, Napi::Object* out) {
+  if (info.Length() <= index || info[index].IsUndefined() || info[index].IsNull()) {
+    *out = Napi::Object::New(env);
+    return true;
+  }
+  if (!info[index].IsObject()) {
+    Napi::TypeError::New(env, "options must be an object").ThrowAsJavaScriptException();
+    return false;
+  }
+  *out = info[index].As<Napi::Object>();
+  return true;
+}
+
+// Snapshot of the ACTIVE area: metadata, cursor and (optionally) rows all come
+// from one native call, so they describe the same terminal state.
+Napi::Value GetViewport(const Napi::CallbackInfo& info) {
+  Napi::Env env = info.Env();
+  TerminalBindingState* state = GetState(info);
+  if (!EnsureOpen(env, state)) return env.Null();
+
+  Napi::Object options;
+  if (!ReadOptionsObject(env, info, 0, &options)) return env.Null();
+  int include_rows = ADHDEV_GHOSTTY_ROWS_NONE;
+  if (options.Has("includeRows") && !options.Get("includeRows").IsUndefined()) {
+    Napi::Value value = options.Get("includeRows");
+    const std::string mode = value.IsString() ? value.As<Napi::String>().Utf8Value() : "";
+    if (mode == "none") {
+      include_rows = ADHDEV_GHOSTTY_ROWS_NONE;
+    } else if (mode == "cursor") {
+      include_rows = ADHDEV_GHOSTTY_ROWS_CURSOR;
+    } else if (mode == "all") {
+      include_rows = ADHDEV_GHOSTTY_ROWS_ALL;
+    } else {
+      Napi::TypeError::New(env, "includeRows must be 'none', 'cursor' or 'all'").ThrowAsJavaScriptException();
+      return env.Null();
+    }
+  }
+  bool cells = false;
+  if (!ReadBoolOption(env, options, "cells", &cells)) return env.Null();
+
+  AdhdevGhosttyViewport* viewport = nullptr;
+  const int result = adhdev_ghostty_terminal_get_viewport(
+      state->terminal, include_rows, cells ? 1 : 0, &viewport);
+  if (result != ADHDEV_GHOSTTY_SUCCESS) {
+    ThrowGhosttyError(env, "adhdev_ghostty_terminal_get_viewport", result);
+    return env.Null();
+  }
+
+  const uint64_t total = viewport->scrollbar_total;
+  const uint64_t offset = viewport->scrollbar_offset;
+  const uint64_t len = viewport->scrollbar_len;
+  const uint64_t rows = viewport->rows;
+  // The derived origins below are only meaningful for a self-consistent
+  // scrollbar; report the inconsistency instead of clamping it into a
+  // plausible-looking answer.
+  if (total > kMaxSafeInteger || viewport->revision > kMaxSafeInteger || total < rows || len != rows ||
+      offset > total - len) {
+    adhdev_ghostty_viewport_free(viewport);
+    ThrowCodedError(env, "ghostty scrollbar state is inconsistent with the terminal size", "ERR_GHOSTTY_SCROLLBAR_STATE");
+    return env.Null();
+  }
+  const uint64_t active_origin = total - rows;
+  const uint64_t cursor_screen_row = active_origin + viewport->cursor_row;
+
+  Napi::Object output = Napi::Object::New(env);
+  output.Set("revision", Napi::Number::New(env, static_cast<double>(viewport->revision)));
+  output.Set("coordinateSpace", Napi::String::New(env, "active"));
+  output.Set("rows", Napi::Number::New(env, viewport->rows));
+  output.Set("cols", Napi::Number::New(env, viewport->cols));
+  output.Set("cursorRow", Napi::Number::New(env, viewport->cursor_row));
+  output.Set("cursorCol", Napi::Number::New(env, viewport->cursor_col));
+  output.Set("cursorPendingWrap", Napi::Boolean::New(env, viewport->cursor_pending_wrap));
+  output.Set("cursorVisible", Napi::Boolean::New(env, viewport->cursor_visible));
+  output.Set("activeScreen", Napi::String::New(env, viewport->active_screen ? "alternate" : "primary"));
+  Napi::Object scrollbar = Napi::Object::New(env);
+  scrollbar.Set("total", Napi::Number::New(env, static_cast<double>(total)));
+  scrollbar.Set("offset", Napi::Number::New(env, static_cast<double>(offset)));
+  scrollbar.Set("len", Napi::Number::New(env, static_cast<double>(len)));
+  output.Set("scrollbar", scrollbar);
+  output.Set("scrollbackRows", Napi::Number::New(env, static_cast<double>(total - len)));
+  output.Set("activeOriginRow", Napi::Number::New(env, static_cast<double>(active_origin)));
+  output.Set("viewportOriginRow", Napi::Number::New(env, static_cast<double>(offset)));
+  output.Set("viewportScrollbackOffset", Napi::Number::New(env, static_cast<double>(active_origin - offset)));
+  if (cursor_screen_row >= offset && cursor_screen_row - offset < rows) {
+    output.Set("cursorViewportRow", Napi::Number::New(env, static_cast<double>(cursor_screen_row - offset)));
+  } else {
+    output.Set("cursorViewportRow", env.Null());
+  }
+  if (viewport->lines) {
+    Napi::Array lines = Napi::Array::New(env, viewport->line_count);
+    for (size_t i = 0; i < viewport->line_count; i++) {
+      lines.Set(static_cast<uint32_t>(i), RowToObject(env, viewport->lines[i], "active"));
+    }
+    output.Set("lines", lines);
+  }
+  adhdev_ghostty_viewport_free(viewport);
+  return output;
+}
+
+Napi::Value ReadRow(const Napi::CallbackInfo& info) {
+  Napi::Env env = info.Env();
+  TerminalBindingState* state = GetState(info);
+  if (!EnsureOpen(env, state)) return env.Null();
+
+  // Validate before any narrowing cast: a fractional, negative or huge index
+  // must not silently become some other row.
+  if (info.Length() < 1 || !info[0].IsNumber()) {
+    Napi::TypeError::New(env, "readRow expects a row number").ThrowAsJavaScriptException();
+    return env.Null();
+  }
+  const double row_value = info[0].As<Napi::Number>().DoubleValue();
+  if (!std::isfinite(row_value) || std::floor(row_value) != row_value || row_value < 0 || row_value > 65535) {
+    ThrowCodedError(env, "row must be an integer within the terminal", "ERR_GHOSTTY_ROW_OUT_OF_RANGE", true);
+    return env.Null();
+  }
+
+  Napi::Object options;
+  if (!ReadOptionsObject(env, info, 1, &options)) return env.Null();
+  bool cells = false;
+  if (!ReadBoolOption(env, options, "cells", &cells)) return env.Null();
+  int space = ADHDEV_GHOSTTY_SPACE_ACTIVE;
+  const char* space_name = "active";
+  if (options.Has("space") && !options.Get("space").IsUndefined()) {
+    Napi::Value value = options.Get("space");
+    const std::string name = value.IsString() ? value.As<Napi::String>().Utf8Value() : "";
+    if (name == "active") {
+      space = ADHDEV_GHOSTTY_SPACE_ACTIVE;
+    } else if (name == "viewport") {
+      space = ADHDEV_GHOSTTY_SPACE_VIEWPORT;
+      space_name = "viewport";
+    } else {
+      Napi::TypeError::New(env, "space must be 'active' or 'viewport'").ThrowAsJavaScriptException();
+      return env.Null();
+    }
+  }
+  bool has_expected = false;
+  double expected = 0;
+  if (options.Has("expectedRevision") && !options.Get("expectedRevision").IsUndefined()) {
+    Napi::Value value = options.Get("expectedRevision");
+    if (!value.IsNumber()) {
+      Napi::TypeError::New(env, "expectedRevision must be a number").ThrowAsJavaScriptException();
+      return env.Null();
+    }
+    has_expected = true;
+    expected = value.As<Napi::Number>().DoubleValue();
+  }
+
+  if (has_expected) {
+    const double current = static_cast<double>(adhdev_ghostty_terminal_revision(state->terminal));
+    if (current != expected) {
+      ThrowCodedError(env, "terminal changed since the expected revision", "ERR_GHOSTTY_STALE_REVISION");
+      return env.Null();
+    }
+  }
+
+  AdhdevGhosttyRowData row = {};
+  uint64_t revision = 0;
+  const int result = adhdev_ghostty_terminal_read_row(
+      state->terminal, space, static_cast<uint16_t>(row_value), cells ? 1 : 0, &row, &revision);
+  if (result == ADHDEV_GHOSTTY_ROW_OUT_OF_RANGE) {
+    ThrowCodedError(env, "row must be an integer within the terminal", "ERR_GHOSTTY_ROW_OUT_OF_RANGE", true);
+    return env.Null();
+  }
+  if (result != ADHDEV_GHOSTTY_SUCCESS) {
+    ThrowGhosttyError(env, "adhdev_ghostty_terminal_read_row", result);
+    return env.Null();
+  }
+  Napi::Object output = RowToObject(env, row, space_name);
+  output.Set("revision", Napi::Number::New(env, static_cast<double>(revision)));
+  adhdev_ghostty_row_data_release(&row);
+  return output;
+}
+
+Napi::Value ScrollViewport(const Napi::CallbackInfo& info) {
+  Napi::Env env = info.Env();
+  TerminalBindingState* state = GetState(info);
+  if (!EnsureOpen(env, state)) return env.Undefined();
+
+  int behavior = -1;
+  int64_t delta = 0;
+  if (info.Length() >= 1 && info[0].IsString()) {
+    const std::string target = info[0].As<Napi::String>().Utf8Value();
+    if (target == "top") behavior = ADHDEV_GHOSTTY_SCROLL_TOP;
+    if (target == "bottom") behavior = ADHDEV_GHOSTTY_SCROLL_BOTTOM;
+  } else if (info.Length() >= 1 && info[0].IsNumber()) {
+    const double value = info[0].As<Napi::Number>().DoubleValue();
+    if (std::isfinite(value) && std::floor(value) == value && std::fabs(value) <= 1e9) {
+      behavior = ADHDEV_GHOSTTY_SCROLL_DELTA;
+      delta = static_cast<int64_t>(value);
+    }
+  }
+  if (behavior < 0) {
+    Napi::TypeError::New(env, "scrollViewport expects 'top', 'bottom' or an integer row delta").ThrowAsJavaScriptException();
+    return env.Undefined();
+  }
+  const int result = adhdev_ghostty_terminal_scroll_viewport(state->terminal, behavior, delta);
+  if (result != ADHDEV_GHOSTTY_SUCCESS) {
+    ThrowGhosttyError(env, "adhdev_ghostty_terminal_scroll_viewport", result);
+  }
+  return env.Undefined();
+}
+
 Napi::Value Dispose(const Napi::CallbackInfo& info) {
   TerminalBindingState* state = GetState(info);
-  if (state && state->terminal) {
+  if (!state) return info.Env().Undefined();
+  if (state->terminal) {
     adhdev_ghostty_terminal_destroy(state->terminal);
     state->terminal = nullptr;
   }
@@ -185,30 +495,100 @@ Napi::Value CreateTerminal(const Napi::CallbackInfo& info) {
       ? static_cast<size_t>(std::max<int64_t>(0, options.Get("scrollback").ToNumber().Int64Value()))
       : 2000;
 
-  auto* state = new TerminalBindingState();
+  SharedState state = std::make_shared<TerminalBindingState>();
   const int result = adhdev_ghostty_terminal_create(cols, rows, scrollback, &state->terminal);
   if (result != ADHDEV_GHOSTTY_SUCCESS) {
-    delete state;
+    state->terminal = nullptr;
     ThrowGhosttyError(env, "adhdev_ghostty_terminal_create", result);
     return env.Null();
   }
 
   Napi::Object object = Napi::Object::New(env);
-  Napi::External<TerminalBindingState> external = Napi::External<TerminalBindingState>::New(env, state, FinalizeState);
-  object.Set("_native", external);
-  object.Set("write", Napi::Function::New(env, Write, "write", state));
-  object.Set("resize", Napi::Function::New(env, Resize, "resize", state));
-  object.Set("formatPlainText", Napi::Function::New(env, FormatPlainText, "formatPlainText", state));
-  object.Set("formatVT", Napi::Function::New(env, FormatVT, "formatVT", state));
-  object.Set("getCursorPosition", Napi::Function::New(env, GetCursorPosition, "getCursorPosition", state));
-  object.Set("dispose", Napi::Function::New(env, Dispose, "dispose", state));
+  auto* nativeHolder = new SharedState(state);
+  object.Set("_native", Napi::External<SharedState>::New(env, nativeHolder, ReleaseSharedState));
+  object.Set("write", NewMethod(env, state, "write", Write));
+  object.Set("resize", NewMethod(env, state, "resize", Resize));
+  object.Set("formatPlainText", NewMethod(env, state, "formatPlainText", FormatPlainText));
+  object.Set("formatVT", NewMethod(env, state, "formatVT", FormatVT));
+  object.Set("getCursorPosition", NewMethod(env, state, "getCursorPosition", GetCursorPosition));
+  object.Set("getViewport", NewMethod(env, state, "getViewport", GetViewport));
+  object.Set("readRow", NewMethod(env, state, "readRow", ReadRow));
+  object.Set("scrollViewport", NewMethod(env, state, "scrollViewport", ScrollViewport));
+  object.Set("dispose", NewMethod(env, state, "dispose", Dispose));
   return object;
 }
 
+#ifndef ADHDEV_GHOSTTY_SOURCE_DIGEST
+#define ADHDEV_GHOSTTY_SOURCE_DIGEST ""
+#endif
+#ifndef ADHDEV_GHOSTTY_GIT_TAG
+#define ADHDEV_GHOSTTY_GIT_TAG ""
+#endif
+// Build provenance from CMakeLists.txt. A build without it (no CMake
+// definitions) is never release eligible.
+#ifndef ADHDEV_GHOSTTY_RELEASE_ELIGIBLE
+#define ADHDEV_GHOSTTY_RELEASE_ELIGIBLE 0
+#endif
+#ifndef ADHDEV_GHOSTTY_PROVENANCE_PROBLEMS
+#define ADHDEV_GHOSTTY_PROVENANCE_PROBLEMS "no-build-provenance"
+#endif
+#ifndef ADHDEV_GHOSTTY_SOURCE_REVISION
+#define ADHDEV_GHOSTTY_SOURCE_REVISION ""
+#endif
+#ifndef ADHDEV_GHOSTTY_SOURCE_CLEAN
+#define ADHDEV_GHOSTTY_SOURCE_CLEAN 0
+#endif
+#ifndef ADHDEV_GHOSTTY_ZIG_VERSION
+#define ADHDEV_GHOSTTY_ZIG_VERSION ""
+#endif
+#ifndef ADHDEV_GHOSTTY_C_COMPILER
+#define ADHDEV_GHOSTTY_C_COMPILER ""
+#endif
+#ifndef ADHDEV_GHOSTTY_CXX_COMPILER
+#define ADHDEV_GHOSTTY_CXX_COMPILER ""
+#endif
+#ifndef ADHDEV_GHOSTTY_BUILD_TYPE
+#define ADHDEV_GHOSTTY_BUILD_TYPE ""
+#endif
+
+// Provenance of this compiled binary. sourceDigest is computed by CMake from
+// the binding sources at build time (scripts/binding-digest.mjs reproduces it),
+// so a prebuilt can be matched against the sources it claims to implement.
+// ghosttyRevision is the declared pin; ghosttySourceRevision/Clean describe the
+// checkout that was actually built, and zigVersion/cCompiler/cxxCompiler the
+// toolchain. releaseEligible is false for an ADHDEV_GHOSTTY_UNVERIFIED_DEV_BUILD.
+Napi::Value GetBindingInfo(const Napi::CallbackInfo& info) {
+  Napi::Env env = info.Env();
+  Napi::Object output = Napi::Object::New(env);
+  output.Set("apiLevel", Napi::Number::New(env, ADHDEV_GHOSTTY_API_LEVEL));
+  output.Set("sourceDigest", Napi::String::New(env, ADHDEV_GHOSTTY_SOURCE_DIGEST));
+  output.Set("ghosttyRevision", Napi::String::New(env, ADHDEV_GHOSTTY_GIT_TAG));
+  output.Set("napiVersion", Napi::Number::New(env, NAPI_VERSION));
+  output.Set("releaseEligible", Napi::Boolean::New(env, ADHDEV_GHOSTTY_RELEASE_ELIGIBLE != 0));
+  Napi::Array problems = Napi::Array::New(env);
+  std::string problemText = ADHDEV_GHOSTTY_PROVENANCE_PROBLEMS;
+  size_t start = 0;
+  while (start < problemText.size()) {
+    size_t end = problemText.find(',', start);
+    if (end == std::string::npos) end = problemText.size();
+    if (end > start) problems.Set(problems.Length(), Napi::String::New(env, problemText.substr(start, end - start)));
+    start = end + 1;
+  }
+  output.Set("provenanceProblems", problems);
+  output.Set("ghosttySourceRevision", Napi::String::New(env, ADHDEV_GHOSTTY_SOURCE_REVISION));
+  output.Set("ghosttySourceClean", Napi::Boolean::New(env, ADHDEV_GHOSTTY_SOURCE_CLEAN != 0));
+  output.Set("zigVersion", Napi::String::New(env, ADHDEV_GHOSTTY_ZIG_VERSION));
+  output.Set("cCompiler", Napi::String::New(env, ADHDEV_GHOSTTY_C_COMPILER));
+  output.Set("cxxCompiler", Napi::String::New(env, ADHDEV_GHOSTTY_CXX_COMPILER));
+  output.Set("buildType", Napi::String::New(env, ADHDEV_GHOSTTY_BUILD_TYPE));
+  return output;
+}
+
 }  // namespace
 
 Napi::Object InitAddon(Napi::Env env, Napi::Object exports) {
   exports.Set("createTerminal", Napi::Function::New(env, CreateTerminal));
+  exports.Set("getBindingInfo", Napi::Function::New(env, GetBindingInfo));
   return exports;
 }