@databricks/appkit-ui 0.60.0 → 0.61.0

package/dist/workspace-client/legacy.js

@@ -0,0 +1,23 @@
+import * as SDK from "@databricks/sdk-experimental";
+
+//#region src/workspace-client/legacy.ts
+const { WorkspaceClient: SdkWorkspaceClientCtor } = SDK;
+/**
+* Construct a legacy `WorkspaceClient` from wrapper options.
+*
+* Centralised so the wrapper facade, the `.toLegacyWorkspaceClient()` escape
+* hatch, and any per-request OBO client all build it the same way.
+*/
+function buildLegacyWorkspaceClient(opts) {
+	return new SdkWorkspaceClientCtor(opts.token !== void 0 ? {
+		host: opts.host,
+		token: opts.token,
+		authType: opts.authType ?? "pat"
+	} : opts.host ? { host: opts.host } : opts.profile ? { profile: opts.profile } : {}, opts.clientOptions);
+}
+const { ConfigError, Context, TimeUnits, loadConfigFile } = SDK;
+const Time = SDK.Time ?? SDK.default.Time;
+
+//#endregion
+export { ConfigError, Context, Time, TimeUnits, buildLegacyWorkspaceClient, loadConfigFile };
+//# sourceMappingURL=legacy.js.map

package/dist/workspace-client/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","names":[],"sources":["../../src/workspace-client/legacy.ts"],"sourcesContent":["/**\n * The single module in AppKit allowed to import `@databricks/sdk-experimental`\n * directly (enforced by the Biome `noRestrictedImports` boundary rule). Every\n * other AppKit module reaches the SDK through the wrapper's re-exports and the\n * {@link WorkspaceClient} facade.\n *\n * Isolating the SDK here is what makes the incremental migration to the modular\n * Databricks SDK a localized change: to migrate a service, swap its getter in\n * `client.ts` from the legacy delegate to the modular client — nothing else in\n * the codebase imports the SDK, so the blast radius is one connector + its test.\n */\n\nimport type {\n  ClientOptions,\n  WorkspaceClient as SdkWorkspaceClient,\n} from \"@databricks/sdk-experimental\";\nimport * as SDK from \"@databricks/sdk-experimental\";\n\nconst { WorkspaceClient: SdkWorkspaceClientCtor } = SDK;\n\n/** The concrete legacy SDK client type. */\nexport type LegacyWorkspaceClient = SdkWorkspaceClient;\n\n/**\n * Options used to construct the wrapper. Mirrors the subset of the old SDK's\n * `Config` + `ClientOptions` that AppKit relies on today; we deliberately do\n * NOT re-expose every old-SDK config knob.\n */\nexport interface WorkspaceClientOptions {\n  /** Databricks host, e.g. https://my-workspace.cloud.databricks.com. Defaults to DATABRICKS_HOST / profile resolution. */\n  host?: string;\n  /** `~/.databrickscfg` profile name. Used when no host/token is provided. */\n  profile?: string;\n  /** Bearer token. When set, `authType` defaults to \"pat\". */\n  token?: string;\n  /** Authentication strategy passed to the legacy client. */\n  authType?: \"pat\";\n  /**\n   * SDK client options (product / productVersion / userAgentExtra) used to\n   * stamp the outbound User-Agent. Produced by `getClientOptions()`; omitted\n   * by build-time callers that don't stamp a User-Agent.\n   */\n  clientOptions?: ClientOptions;\n}\n\n/**\n * Construct a legacy `WorkspaceClient` from wrapper options.\n *\n * Centralised so the wrapper facade, the `.toLegacyWorkspaceClient()` escape\n * hatch, and any per-request OBO client all build it the same way.\n */\nexport function buildLegacyWorkspaceClient(\n  opts: WorkspaceClientOptions,\n): LegacyWorkspaceClient {\n  // Check `token !== undefined`, NOT truthiness: an explicitly-passed token\n  // must stick to the PAT path even when it's an empty string. Falling through\n  // to the default-auth branch on an empty OBO token would silently\n  // authenticate as the service principal instead of failing — a privilege\n  // escalation in the OBO path. An invalid/empty token should blow up loudly.\n  const cfg =\n    opts.token !== undefined\n      ? { host: opts.host, token: opts.token, authType: opts.authType ?? \"pat\" }\n      : opts.host\n        ? { host: opts.host }\n        : opts.profile\n          ? { profile: opts.profile }\n          : {};\n  return new SdkWorkspaceClientCtor(cfg, opts.clientOptions);\n}\n\n// ── SDK type re-exports ──────────────────────────────────────────────\nexport type {\n  CancellationToken,\n  ClientOptions,\n} from \"@databricks/sdk-experimental\";\n// ── SDK value re-exports ─────────────────────────────────────────────\n//\n// AppKit modules import these from the wrapper instead of the SDK so the\n// boundary rule holds. `Context` bridges AbortSignal → CancellationToken\n// (serving/jobs/sql-warehouse); `Time`/`TimeUnits` drive genie polling;\n// `ConfigError` is matched in service-context's auth-failure handling.\n//\n// These are sourced off the namespace import rather than `export { ... } from`\n// because the SDK is CommonJS: its `Time` export is emitted as a getter that\n// calls `__importDefault(...)`, which defeats Node's static named-export\n// detection — a direct `export { Time }` throws \"does not provide an export\n// named 'Time'\" at ESM link time. `Time` is only reachable via the module\n// object, so we fall back to `SDK.default.Time` (matching the original genie\n// connector's `SDK.Time ?? SDK.default.Time` guard).\nexport const { ConfigError, Context, TimeUnits, loadConfigFile } = SDK;\nexport const Time =\n  SDK.Time ?? (SDK as unknown as { default: typeof SDK }).default.Time;\n\n// Deep-import types used by the genie connector's waiter idiom. Not exposed\n// on the SDK's top-level index, so re-exported here to keep the genie\n// connector off a direct `@databricks/sdk-experimental/dist/**` import.\nexport type { GenieMessage } from \"@databricks/sdk-experimental/dist/apis/dashboards\";\nexport type { Waiter } from \"@databricks/sdk-experimental/dist/wait\";\n"],"mappings":";;;AAkBA,MAAM,EAAE,iBAAiB,2BAA2B;;;;;;;AAiCpD,SAAgB,2BACd,MACuB;AAcvB,QAAO,IAAI,uBAPT,KAAK,UAAU,SACX;EAAE,MAAM,KAAK;EAAM,OAAO,KAAK;EAAO,UAAU,KAAK,YAAY;EAAO,GACxE,KAAK,OACH,EAAE,MAAM,KAAK,MAAM,GACnB,KAAK,UACH,EAAE,SAAS,KAAK,SAAS,GACzB,EAAE,EAC2B,KAAK,cAAc;;AAsB5D,MAAa,EAAE,aAAa,SAAS,WAAW,mBAAmB;AACnE,MAAa,OACX,IAAI,QAAS,IAA2C,QAAQ"}

package/dist/workspace-client/types.d.ts

@@ -0,0 +1,49 @@
+import { LegacyWorkspaceClient } from "./legacy.js";
+import { files, jobs, serving, sql } from "@databricks/sdk-experimental";
+
+//#region src/workspace-client/types.d.ts
+/**
+ * AppKit's workspace client facade. Mirrors the multi-client shape of the
+ * modular Databricks SDK: each service is its own accessor, so services can be
+ * migrated one at a time behind this stable interface.
+ *
+ * Accessors are legacy-typed for now (delegated to the underlying legacy SDK
+ * client); see the module docblock.
+ */
+interface WorkspaceClient$1 {
+  /** UC Volumes / Files API. */
+  readonly files: LegacyWorkspaceClient["files"];
+  /** SQL Warehouses. */
+  readonly warehouses: LegacyWorkspaceClient["warehouses"];
+  /** Genie / dashboards. */
+  readonly genie: LegacyWorkspaceClient["genie"];
+  /** Jobs. */
+  readonly jobs: LegacyWorkspaceClient["jobs"];
+  /** Statement Execution. */
+  readonly statementExecution: LegacyWorkspaceClient["statementExecution"];
+  /** Serving Endpoints. */
+  readonly servingEndpoints: LegacyWorkspaceClient["servingEndpoints"];
+  /** Current user. */
+  readonly currentUser: LegacyWorkspaceClient["currentUser"];
+  /**
+   * SDK `Config` — exposes `host` and `authenticate(headers)`. Used by the
+   * files-upload path and agents auth-header stamping, which bypass the typed
+   * services.
+   */
+  readonly config: LegacyWorkspaceClient["config"];
+  /**
+   * Low-level HTTP transport (`apiClient.request(...)`). Used for endpoints
+   * without a typed service method: SCIM header probe, warehouse listing,
+   * serving SSE streaming, vector search, internal telemetry.
+   */
+  readonly apiClient: LegacyWorkspaceClient["apiClient"];
+  /**
+   * Returns the underlying legacy `@databricks/sdk-experimental`
+   * `WorkspaceClient`, for handoff to code still typed against the old SDK
+   * (`@databricks/lakebase`). Transitional.
+   */
+  toLegacyWorkspaceClient(): LegacyWorkspaceClient;
+}
+//#endregion
+export { WorkspaceClient$1 as WorkspaceClient, type files, type jobs, type serving, type sql };
+//# sourceMappingURL=types.d.ts.map

package/dist/workspace-client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/workspace-client/types.ts"],"mappings":";;;;;;;;;;;;UAkCiB,iBAAA;EAWA;EAAA,SATN,KAAA,EAAO,qBAAA;EAYa;EAAA,SATpB,UAAA,EAAY,qBAAA;EAYM;EAAA,SATlB,KAAA,EAAO,qBAAA;EAYM;EAAA,SATb,IAAA,EAAM,qBAAA;EAgBE;EAAA,SAbR,kBAAA,EAAoB,qBAAA;EAoBT;EAAA,SAjBX,gBAAA,EAAkB,qBAAA;EAwBA;EAAA,SArBlB,WAAA,EAAa,qBAAA;EAqB0B;;;;;EAAA,SAdvC,MAAA,EAAQ,qBAAA;;;;;;WAOR,SAAA,EAAW,qBAAA;;;;;;EAOpB,uBAAA,IAA2B,qBAAA;AAAA"}

package/docs/api/appkit/Function.createWorkspaceClient.md

@@ -19,10 +19,10 @@ Host resolution:
 
 ## Parameters[​](#parameters "Direct link to Parameters")
 
-| Parameter | Type                                                                                    |
-| --------- | --------------------------------------------------------------------------------------- |
-| `opts`    | [`WorkspaceClientOptions`](./docs/api/appkit/Interface.WorkspaceClientOptions.md) |
+| Parameter | Type                     |
+| --------- | ------------------------ |
+| `opts`    | `WorkspaceClientOptions` |
 
 ## Returns[​](#returns "Direct link to Returns")
 
-[`WorkspaceClient`](./docs/api/appkit/Interface.WorkspaceClient.md)
+`WorkspaceClient`

package/docs/api/appkit/Interface.WorkspaceClientOptions.md

@@ -37,6 +37,17 @@ Databricks host, e.g. <https://my-workspace.cloud.databricks.com>. Defaults to D
 
 ***
 
+### profile?[​](#profile "Direct link to profile?")
+
+```ts
+optional profile: string;
+
+```
+
+`~/.databrickscfg` profile name. Used when no host/token is provided.
+
+***
+
 ### token?[​](#token "Direct link to token?")
 
 ```ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@databricks/appkit-ui",
   "type": "module",
-  "version": "0.60.0",
+  "version": "0.61.0",
   "license": "Apache-2.0",
   "sideEffects": [
     "**/*.css"
@@ -91,12 +91,14 @@
     "tailwind-merge": "3.4.0",
     "vaul": "1.1.2",
     "@ast-grep/napi": "0.37.0",
-    "@standard-schema/spec": "1.1.0",
     "@clack/prompts": "1.0.1",
+    "@databricks/sdk-experimental": "0.17.0",
+    "@standard-schema/spec": "1.1.0",
     "commander": "12.1.0",
     "dotenv": "16.6.1",
     "js-yaml": "4.2.0",
     "picocolors": "1.1.1",
+    "yaml": "2.8.2",
     "zod": "4.3.6"
   },
   "peerDependencies": {