@dbx-tools/databricks 0.6.168 → 0.6.175

package/README.md

@@ -1,15 +1,17 @@
 # @dbx-tools/databricks
 
-Generic Node-side Databricks workspace and cloud infrastructure helpers.
+Databricks runtime, workspace, filesystem, cloud, and network utilities.
 
 Import this package when backend code needs workspace URL/id discovery, cloud
-provider/region lookup, DNS resolution, or public-IP discovery without requiring
-an AppKit plugin runtime.
+provider/region lookup, App runtime detection, DNS resolution, or public-IP
+discovery without requiring an AppKit plugin runtime.
 
 Key features:
 
 - Workspace URL and numeric workspace id resolution from AppKit context,
   Databricks SDK config, env, and config files.
+- Rust-backed Databricks App detection shared with authentication providers.
+- Cached detection of whether the Databricks CLI auth surface is available.
 - `DatabricksFileSystem` (`FileSystem` over workspace files, UC volumes, and DBFS)
   with intelligent roots: `/Workspace/...`, `/Volumes/...` (also `/Volume/...` and
   `catalog.schema.volume`), `~` → `/Workspace/Users/<userName>`, and `/dbfs/...`.
@@ -21,6 +23,28 @@ Key features:
 - DNS A/AAAA lookup helpers for Databricks and adjacent service hosts.
 - Memoized outbound public-IP discovery for setup and diagnostics.
 
+## Detect The Runtime
+
+```ts
+import { databricksCliAvailable, isDatabricksApp } from "@dbx-tools/databricks";
+
+const inApp = isDatabricksApp();
+const hasDatabricksAuth = databricksCliAvailable();
+```
+
+`isDatabricksApp()` honors `DBX_TOOLS_DATABRICKS_APP_ENV`, then requires a
+valid `DATABRICKS_APP_NAME`, HTTP(S) `DATABRICKS_HOST`, and
+`DATABRICKS_APP_PORT`. `databricksCliAvailable()` caches whether
+`databricks auth --help` succeeds for the process. The generated bindings and
+the package's direct TypeScript modules share this package root.
+
+## Relationship To Native AppKit
+
+Use native AppKit for its standard workspace client and plugin integrations.
+Use this package when code also needs App detection shared with Rust,
+Databricks filesystem root normalization, cloud region discovery, network
+helpers, or workspace identity fallbacks outside an AppKit request.
+
 ## Databricks filesystem
 
 ```ts
@@ -103,6 +127,8 @@ short-lived reuse.
 - `workspace` - workspace URL/id, `tryGetWorkspaceClient` / `getWorkspaceClient`, and current username.
 - `cloud` - provider/region detection from public cloud IP ranges.
 - `net` - DNS A/AAAA resolution and outbound public-IP discovery.
+- package root - Rust-backed `isDatabricksApp` and
+  `databricksCliAvailable`.
 
 Zerobus endpoint construction builds on these helpers in
 [`@dbx-tools/databricks-zerobus`](../databricks-zerobus).

package/index.ts

@@ -3,6 +3,8 @@
 // Hand edits are overwritten on the next watch; this file is read-only.
 
 export const PACKAGE_IDENTIFIER = "@dbx-tools/databricks";
+export const PACKAGE_VERSION = "0.6.175";
+export * from "./src/bindings.ts";
 export * as cloud from "./src/cloud.ts";
 export * as databricksFS from "./src/databricks-fs.ts";
 export * as databricksPath from "./src/databricks-path.ts";