@fabricorg/databricks-testkit 0.2.2 → 0.2.4

package/dist/index.d.cts

@@ -131,7 +131,8 @@ declare function toNamedParameters(sql: string, params: readonly unknown[]): {
 declare function parseStatementRows(response: StatementResponse): Record<string, unknown>[];
 /**
  * Auth precedence (ADR-0006): DATABRICKS_BEARER (pre-minted, CI) →
- * DATABRICKS_CLIENT_ID/SECRET (OAuth M2M) → DATABRICKS_TOKEN (PAT).
+ * explicit env/file OIDC federation → DATABRICKS_CLIENT_ID/SECRET (OAuth
+ * M2M) → DATABRICKS_TOKEN (legacy PAT).
  */
 declare function createClientFromEnv(env: Record<string, string | undefined>, fetchImpl?: typeof fetch): DatabricksRestClient;
 declare function resolveTokenProvider(host: string, env: Record<string, string | undefined>, fetchImpl?: typeof fetch): string | (() => Promise<string>);

package/dist/index.d.ts

@@ -131,7 +131,8 @@ declare function toNamedParameters(sql: string, params: readonly unknown[]): {
 declare function parseStatementRows(response: StatementResponse): Record<string, unknown>[];
 /**
  * Auth precedence (ADR-0006): DATABRICKS_BEARER (pre-minted, CI) →
- * DATABRICKS_CLIENT_ID/SECRET (OAuth M2M) → DATABRICKS_TOKEN (PAT).
+ * explicit env/file OIDC federation → DATABRICKS_CLIENT_ID/SECRET (OAuth
+ * M2M) → DATABRICKS_TOKEN (legacy PAT).
  */
 declare function createClientFromEnv(env: Record<string, string | undefined>, fetchImpl?: typeof fetch): DatabricksRestClient;
 declare function resolveTokenProvider(host: string, env: Record<string, string | undefined>, fetchImpl?: typeof fetch): string | (() => Promise<string>);

package/dist/index.js

@@ -1,8 +1,8 @@
 import { compareToGolden } from './chunk-MLBZCHRM.js';
 export { compareToGolden } from './chunk-MLBZCHRM.js';
 export { createDuckDbContext, normalizeRow } from './chunk-7JVDOSBO.js';
-import { createClientFromEnv, createWorkspaceContext, resolveTokenProvider } from './chunk-FBADA7LQ.js';
-export { createClientFromEnv, createWorkspaceContext, parseStatementRows, resolveTokenProvider, toNamedParameters } from './chunk-FBADA7LQ.js';
+import { createClientFromEnv, createWorkspaceContext, resolveTokenProvider } from './chunk-SCVVMUAF.js';
+export { createClientFromEnv, createWorkspaceContext, parseStatementRows, resolveTokenProvider, toNamedParameters } from './chunk-SCVVMUAF.js';
 export { parseFixtureColumns, resolveFixtureRows } from './chunk-F3KU6VZS.js';
 import { mkdir, writeFile, readFile } from 'fs/promises';
 import { dirname, resolve, basename } from 'path';
@@ -31,7 +31,7 @@ async function createExecutionContext(options = {}) {
     const { createDuckDbContext: createDuckDbContext2 } = await import('./duckdb-context-FX23RUBV.js');
     return createDuckDbContext2({ schema: options.schema });
   }
-  const { createWorkspaceContext: createWorkspaceContext2 } = await import('./workspace-context-AIUYISUS.js');
+  const { createWorkspaceContext: createWorkspaceContext2 } = await import('./workspace-context-VLBKMX3V.js');
   return createWorkspaceContext2({
     env,
     schema: options.schema,
@@ -150,7 +150,7 @@ async function runLiveSuite(spec, runtime = {}) {
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   const ownedWarehouse = runtime.warehouse === void 0;
   const client = runtime.client ?? createClientFromEnv(env);
-  const warehouse = runtime.warehouse ?? await createWorkspaceContext({ env, client });
+  const warehouse = runtime.warehouse ?? (hasWarehouseConfig(env) ? await createWorkspaceContext({ env, client }) : unavailableWarehouseContext());
   const results = [];
   try {
     for (const check of spec.checks) {
@@ -204,6 +204,24 @@ async function runLiveSuite(spec, runtime = {}) {
   if (spec.junitPath) await writeReport(spec.junitPath, renderJUnit(evidence));
   return evidence;
 }
+function hasWarehouseConfig(env) {
+  return Boolean(env.DATABRICKS_WAREHOUSE_ID || env.DATABRICKS_HTTP_PATH);
+}
+function unavailableWarehouseContext() {
+  const unavailable = async () => {
+    throw new Error(
+      "This live check requires DATABRICKS_WAREHOUSE_ID or DATABRICKS_HTTP_PATH; REST-only checks can run without SQL warehouse configuration"
+    );
+  };
+  return {
+    profile: "live",
+    qual: (table) => table,
+    exec: unavailable,
+    query: unavailable,
+    loadFixture: unavailable,
+    close: async () => void 0
+  };
+}
 async function writeReport(path, contents) {
   await mkdir(dirname(path), { recursive: true });
   await writeFile(path, contents, "utf8");
@@ -278,6 +296,7 @@ function sqlRoundTripCheck() {
   return {
     id: "sql",
     description: "SQL Statement Execution round-trip",
+    configured: (env) => Boolean(env.DATABRICKS_WAREHOUSE_ID || env.DATABRICKS_HTTP_PATH),
     async run({ warehouse }) {
       const rows = await warehouse.query("SELECT 1 AS dbx_test_ok");
       if (Number(rows[0]?.dbx_test_ok) !== 1)
@@ -881,6 +900,7 @@ function failureRecoveryCheck() {
   return {
     id: "failure-recovery",
     description: "A failed statement is isolated and a subsequent statement recovers",
+    configured: (env) => Boolean(env.DATABRICKS_WAREHOUSE_ID || env.DATABRICKS_HTTP_PATH),
     async run({ warehouse }) {
       let failedAsExpected = false;
       try {
@@ -926,6 +946,7 @@ function backupRestoreCheck() {
   return {
     id: "backup-restore",
     description: "Delta DEEP CLONE backup restores a dropped scratch table",
+    configured: (env) => Boolean(env.DATABRICKS_WAREHOUSE_ID || env.DATABRICKS_HTTP_PATH),
     async run({ warehouse }) {
       const source = warehouse.qual(safeName("backup_source"));
       const backup = warehouse.qual(safeName("backup_clone"));
@@ -948,6 +969,7 @@ function rollbackCheck() {
   return {
     id: "rollback",
     description: "Delta time-travel rollback restores a known-good table version",
+    configured: (env) => Boolean(env.DATABRICKS_WAREHOUSE_ID || env.DATABRICKS_HTTP_PATH),
     async run({ warehouse }) {
       const table = warehouse.qual(safeName("rollback_probe"));
       try {
@@ -1036,7 +1058,10 @@ function classicComputeCheck() {
       });
       const result = run.state?.result_state;
       if (result !== "SUCCESS") {
-        throw new Error(`Classic compute run ended in ${result ?? "UNKNOWN"}`);
+        const message = run.state?.state_message;
+        throw new Error(
+          `Classic compute run ${submitted.run_id} ended in ${result ?? "UNKNOWN"}${message ? `: ${message}` : ""}`
+        );
       }
       return {
         runId: submitted.run_id,