@fabricorg/databricks-bdd 0.3.0 → 0.3.2

package/README.md

@@ -75,8 +75,9 @@ Then: `table {string} has {int} rows` · `table {string} contains rows matching:
 `row count of {string} is within {int}% of {int}` · `the job run reaches {runState}` ·
 `the pipeline update completes within {duration}` · schema-contract assertions.
 
-The World supplies Behave-style scenario cleanup, typed userdata, run-level
-live preflight, redacted failure attachments, per-step process-output capture,
+The World supplies Behave-style scenario cleanup, retry-safe run/feature
+fixtures with reverse-order `AfterAll` cleanup, typed userdata, run-level live
+preflight, redacted failure attachments, per-step process-output capture,
 custom parameter types, Scenario Outlines, serial live execution, and parallel
 local execution. Evidence JSON schema v2 includes structured SQL, statement ID,
 and captured-output failure records. Capture defaults to 32 KiB per step; use
@@ -84,6 +85,18 @@ and captured-output failure records. Capture defaults to 32 KiB per step; use
 disable it. Generate the complete catalog, including unused definitions, with
 `pnpm steps:catalog`.
 
+```ts
+const seeded = await this.featureFixture('reference-data', async () => ({
+  value: await seedReferenceData(),
+  cleanup: deleteReferenceData,
+}))
+```
+
+Feature fixtures are keyed by feature URI and cleaned at run end because
+cucumber-js has no safe `after_feature` event when filters, retries, and
+parallel workers are involved. Use `this.addCleanup()` for scenario scope and
+`sharedFixtures.runFixture()` for run scope.
+
 Keep feature text engine-neutral. The shipped framework is TypeScript end to
 end; Python adapters are optional ecosystem bridges and are not required or
 currently included.

package/dist/{chunk-FNTI2VUP.js → chunk-355WDWP3.js}

@@ -1,9 +1,9 @@
+import { sharedFixtures } from './chunk-SZL3KWW7.js';
 import { World } from '@cucumber/cucumber';
 import { resolveProfile, createExecutionContext } from '@fabricorg/databricks-testkit';
 export { waitForPipelineUpdate } from '@fabricorg/databricks-testkit';
 import { waitForDatabricksRun } from '@fabric-harness/databricks';
 
-// src/world.ts
 var DatabricksWorld = class extends World {
   profile;
   /** Rows from the last `When I run the SQL` / `When I query table` step. */
@@ -18,6 +18,7 @@ var DatabricksWorld = class extends World {
   catalogOverride;
   lastSql;
   lastStatementId;
+  featureUri;
   stepOutputCapture;
   lakebasePool;
   ctx;
@@ -56,6 +57,20 @@ var DatabricksWorld = class extends World {
   addCleanup(cleanup) {
     this.cleanups.push(cleanup);
   }
+  /** Setup a resource once for this Cucumber run and clean it up in AfterAll. */
+  runFixture(key, setup) {
+    return sharedFixtures.runFixture(key, setup);
+  }
+  /**
+   * Setup a resource once per feature file. It is isolated by feature URI and
+   * cleaned in AfterAll because cucumber-js has no reliable after-feature hook.
+   */
+  featureFixture(key, setup) {
+    if (!this.featureUri) {
+      throw new Error("featureFixture is only available after the scenario Before hook");
+    }
+    return sharedFixtures.featureFixture(this.featureUri, key, setup);
+  }
   /** Resolve runner userdata from worldParameters first, then DBX_TEST_USERDATA_* env. */
   userdata(name) {
     const configured = this.parameters.userdata?.[name];
@@ -198,5 +213,5 @@ async function startPipelineUpdate(client, pipelineId, options = {}) {
 }
 
 export { DatabricksWorld, LIVE_ONLY_TAGS, coerceMatchRows, inferFixture, liveOnlyReason, resolveJobId, resolvePipelineId, runJobToTerminal, startPipelineUpdate };
-//# sourceMappingURL=chunk-FNTI2VUP.js.map
-//# sourceMappingURL=chunk-FNTI2VUP.js.map
+//# sourceMappingURL=chunk-355WDWP3.js.map
+//# sourceMappingURL=chunk-355WDWP3.js.map

package/dist/chunk-355WDWP3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/world.ts","../src/profile.ts","../src/infer.ts","../src/jobs.ts","../src/pipelines.ts"],"names":[],"mappings":"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","file":"chunk-355WDWP3.js","sourcesContent":["import { type IWorldOptions, World } from '@cucumber/cucumber';\nimport {\n  type ExecutionContext,\n  type TestProfile,\n  createExecutionContext,\n  resolveProfile,\n} from '@fabricorg/databricks-testkit';\nimport { type FixtureSetup, sharedFixtures } from './fixtures.js';\nimport type { StepOutputCapture } from './output-capture.js';\n\nexport interface DatabricksWorldParameters {\n  /** Default schema for the execution context; overridable per scenario via the catalog/schema step. */\n  schema?: string;\n  /** Arbitrary typed runner configuration, comparable to behave `-D` userdata. */\n  userdata?: Record<string, string | number | boolean>;\n}\n\ntype Cleanup = () => void | Promise<void>;\n\n/**\n * Cucumber World holding one ExecutionContext per scenario. The context is\n * created lazily on first use so `Given catalog ... and schema ...` can run\n * first; it is closed by the After hook registered in ./steps.ts.\n */\nexport class DatabricksWorld extends World<DatabricksWorldParameters> {\n  readonly profile: TestProfile;\n  /** Rows from the last `When I run the SQL` / `When I query table` step. */\n  lastRows: Record<string, unknown>[] | null = null;\n  /** Error captured from the last statement, for `Then the statement fails ...`. */\n  lastError: Error | null = null;\n  /** Terminal run record from the last `When I run job ...` step. */\n  lastRun: Record<string, unknown> | null = null;\n  /** Pipeline update handle from `When I start a full refresh of pipeline ...`. */\n  lastPipelineUpdate: { pipelineId: string; updateId: string } | null = null;\n  schemaOverride: string | undefined;\n  catalogOverride: string | undefined;\n  lastSql: string | undefined;\n  lastStatementId: string | undefined;\n  featureUri: string | undefined;\n  stepOutputCapture: StepOutputCapture | undefined;\n  lakebasePool:\n    | { query<T extends Record<string, unknown>>(sql: string): Promise<{ rows: T[] }> }\n    | undefined;\n  private ctx: ExecutionContext | undefined;\n  private activeCtx: ExecutionContext | undefined;\n  private readonly cleanups: Cleanup[] = [];\n\n  constructor(options: IWorldOptions<DatabricksWorldParameters>) {\n    super(options);\n    this.profile = resolveProfile();\n  }\n\n  async context(): Promise<ExecutionContext> {\n    if (this.activeCtx) return this.activeCtx;\n    if (!this.ctx) {\n      const env = this.catalogOverride\n        ? { ...process.env, DBX_TEST_CATALOG: this.catalogOverride }\n        : process.env;\n      this.ctx = await createExecutionContext({\n        profile: this.profile,\n        env,\n        schema: this.schemaOverride ?? this.parameters.schema,\n        onStatement: ({ sql, statementId }) => {\n          this.lastSql = sql;\n          this.lastStatementId = statementId;\n        },\n      });\n    }\n    return this.ctx;\n  }\n\n  /** Route subsequent steps through a scenario-owned secondary identity. */\n  useExecutionContext(context: ExecutionContext): void {\n    if (this.activeCtx) throw new Error('A secondary execution context is already active');\n    this.activeCtx = context;\n    this.addCleanup(async () => {\n      await context.close();\n      this.activeCtx = undefined;\n    });\n  }\n\n  /** Register scenario-scoped cleanup. Cleanups run in reverse order. */\n  addCleanup(cleanup: Cleanup): void {\n    this.cleanups.push(cleanup);\n  }\n\n  /** Setup a resource once for this Cucumber run and clean it up in AfterAll. */\n  runFixture<T>(key: string, setup: FixtureSetup<T>): Promise<T> {\n    return sharedFixtures.runFixture(key, setup);\n  }\n\n  /**\n   * Setup a resource once per feature file. It is isolated by feature URI and\n   * cleaned in AfterAll because cucumber-js has no reliable after-feature hook.\n   */\n  featureFixture<T>(key: string, setup: FixtureSetup<T>): Promise<T> {\n    if (!this.featureUri) {\n      throw new Error('featureFixture is only available after the scenario Before hook');\n    }\n    return sharedFixtures.featureFixture(this.featureUri, key, setup);\n  }\n\n  /** Resolve runner userdata from worldParameters first, then DBX_TEST_USERDATA_* env. */\n  userdata(name: string): string | number | boolean | undefined {\n    const configured = this.parameters.userdata?.[name];\n    if (configured !== undefined) return configured;\n    return process.env[`DBX_TEST_USERDATA_${name.replace(/[^A-Za-z0-9]/g, '_').toUpperCase()}`];\n  }\n\n  scopeTo(catalog: string, schema: string): void {\n    if (this.ctx) {\n      throw new Error(\n        'Given catalog/schema must run before any step that touches the warehouse in the scenario',\n      );\n    }\n    // Feature files stay portable and readable with illustrative names. A live\n    // runner may redirect every scenario into its provisioned scratch scope.\n    this.catalogOverride =\n      this.profile === 'live' ? (process.env.DBX_TEST_CATALOG ?? catalog) : catalog;\n    this.schemaOverride =\n      this.profile === 'live' ? (process.env.DBX_TEST_SCHEMA ?? schema) : schema;\n  }\n\n  async dispose(): Promise<void> {\n    this.stepOutputCapture?.stop();\n    this.stepOutputCapture = undefined;\n    const errors: unknown[] = [];\n    for (const cleanup of this.cleanups.splice(0).reverse()) {\n      try {\n        await cleanup();\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n    try {\n      await this.ctx?.close();\n    } catch (error) {\n      errors.push(error);\n    }\n    this.ctx = undefined;\n    if (errors.length > 0) throw new AggregateError(errors, 'Scenario cleanup failed');\n  }\n}\n","import type { TestProfile } from '@fabricorg/databricks-testkit';\n\n/**\n * Tags that require a live workspace (or a long budget). Scenarios carrying\n * any of them are skipped under the `local` profile — see ADR-0006.\n */\nexport const LIVE_ONLY_TAGS = [\n  '@live',\n  '@jobs',\n  '@dlt',\n  '@pipeline',\n  '@autoloader',\n  '@lakebase',\n  '@slow',\n] as const;\n\n/** Returns a skip reason when the scenario cannot run under the given profile, else null. */\nexport function liveOnlyReason(tags: readonly string[], profile: TestProfile): string | null {\n  if (profile === 'live') return null;\n  const blocking = tags.filter((t) => (LIVE_ONLY_TAGS as readonly string[]).includes(t));\n  if (blocking.length === 0) return null;\n  return `requires a live workspace (${blocking.join(', ')}); running under DBX_TEST_PROFILE=local`;\n}\n","import type { TableFixture } from '@fabricorg/databricks-testkit';\n\nconst INT_RE = /^-?\\d+$/;\nconst FLOAT_RE = /^-?\\d+\\.\\d+$/;\nconst TIMESTAMP_RE = /^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}(:\\d{2})?/;\nconst BOOL_RE = /^(true|false)$/i;\n\n/**\n * Turn a Gherkin data table (header row + string cells) into a TableFixture,\n * inferring portable column types from the values: BIGINT, DOUBLE,\n * TIMESTAMP, BOOLEAN, else STRING. Empty cells become NULL.\n */\nexport function inferFixture(table: string, raw: readonly (readonly string[])[]): TableFixture {\n  if (raw.length < 2) {\n    throw new Error(`Data table for ${table} needs a header row and at least one data row`);\n  }\n  const [header, ...body] = raw as [readonly string[], ...(readonly string[])[]];\n  const types = header.map((_, col) => inferColumnType(body.map((row) => row[col] ?? '')));\n  const schema = header.map((name, i) => `\"${name}\" ${types[i]}`).join(', ');\n  const rows = body.map((row) => row.map((cell, i) => coerceCell(cell, types[i] ?? 'STRING')));\n  return { table, schema, rows };\n}\n\n/** Coerce data-table string cells to typed values for row matching (no header row). */\nexport function coerceMatchRows(raw: readonly (readonly string[])[]): Record<string, unknown>[] {\n  if (raw.length < 2) {\n    throw new Error('Match table needs a header row and at least one data row');\n  }\n  const [header, ...body] = raw as [readonly string[], ...(readonly string[])[]];\n  return body.map((row) => {\n    const out: Record<string, unknown> = {};\n    header.forEach((name, i) => {\n      out[name] = coerceCell(row[i] ?? '', inferColumnType([row[i] ?? '']));\n    });\n    return out;\n  });\n}\n\nfunction inferColumnType(cells: readonly string[]): string {\n  const present = cells.filter((c) => c !== '');\n  if (present.length === 0) return 'STRING';\n  if (present.every((c) => INT_RE.test(c))) return 'BIGINT';\n  if (present.every((c) => FLOAT_RE.test(c) || INT_RE.test(c))) return 'DOUBLE';\n  if (present.every((c) => TIMESTAMP_RE.test(c))) return 'TIMESTAMP';\n  if (present.every((c) => BOOL_RE.test(c))) return 'BOOLEAN';\n  return 'STRING';\n}\n\nfunction coerceCell(cell: string, type: string): unknown {\n  if (cell === '') return null;\n  if (type === 'BIGINT' || type === 'DOUBLE') return Number(cell);\n  if (type === 'BOOLEAN') return /^true$/i.test(cell);\n  return cell;\n}\n","import { type DatabricksRestClient, waitForDatabricksRun } from '@fabric-harness/databricks';\nimport type { WorkspaceClientLike } from '@fabricorg/databricks-testkit';\n\nexport interface RunJobOptions {\n  pollIntervalMs?: number;\n  timeoutMs?: number;\n}\n\nexport interface JobRunResult {\n  runId: number;\n  lifeCycleState: string;\n  resultState: string;\n  run: Record<string, unknown>;\n}\n\n/** Resolve a job by numeric id or by exact name via /api/2.1/jobs/list. */\nexport async function resolveJobId(client: WorkspaceClientLike, nameOrId: string): Promise<number> {\n  if (/^\\d+$/.test(nameOrId)) return Number(nameOrId);\n  const response = await client.get<{ jobs?: { job_id: number; settings?: { name?: string } }[] }>(\n    '/api/2.1/jobs/list',\n    { name: nameOrId },\n  );\n  const match = (response.jobs ?? []).find((j) => j.settings?.name === nameOrId);\n  if (!match) throw new Error(`No Databricks job named '${nameOrId}' found`);\n  return match.job_id;\n}\n\n/** run-now a job and poll its run to a terminal state. */\nexport async function runJobToTerminal(\n  client: WorkspaceClientLike,\n  nameOrId: string,\n  options: RunJobOptions = {},\n): Promise<JobRunResult> {\n  const jobId = await resolveJobId(client, nameOrId);\n  const submitted = await client.post<{ run_id: number }>('/api/2.1/jobs/run-now', {\n    job_id: jobId,\n  });\n  const run = await waitForDatabricksRun(client as DatabricksRestClient, submitted.run_id, {\n    pollIntervalMs: options.pollIntervalMs,\n    timeoutMs: options.timeoutMs,\n  });\n  const state = (run as { state?: { life_cycle_state?: string; result_state?: string } }).state;\n  return {\n    runId: submitted.run_id,\n    lifeCycleState: state?.life_cycle_state ?? 'UNKNOWN',\n    resultState: state?.result_state ?? 'UNKNOWN',\n    run,\n  };\n}\n","import {\n  type PollOptions,\n  type WorkspaceClientLike,\n  waitForPipelineUpdate,\n} from '@fabricorg/databricks-testkit';\n\nexport type PipelineWaitOptions = PollOptions;\n\n/** Resolve a DLT/Lakeflow pipeline by id or exact name via /api/2.0/pipelines. */\nexport async function resolvePipelineId(\n  client: WorkspaceClientLike,\n  nameOrId: string,\n): Promise<string> {\n  if (/^[0-9a-f]{8}-[0-9a-f-]{27,}$/i.test(nameOrId)) return nameOrId;\n  const response = await client.get<{ statuses?: { pipeline_id: string; name?: string }[] }>(\n    '/api/2.0/pipelines',\n    { filter: `name LIKE '${nameOrId}'` },\n  );\n  const match = (response.statuses ?? []).find((p) => p.name === nameOrId);\n  if (!match) throw new Error(`No Databricks pipeline named '${nameOrId}' found`);\n  return match.pipeline_id;\n}\n\n/** Start a pipeline update; returns the update id to poll. */\nexport async function startPipelineUpdate(\n  client: WorkspaceClientLike,\n  pipelineId: string,\n  options: { fullRefresh?: boolean } = {},\n): Promise<string> {\n  const response = await client.post<{ update_id: string }>(\n    `/api/2.0/pipelines/${encodeURIComponent(pipelineId)}/updates`,\n    { full_refresh: options.fullRefresh ?? false },\n  );\n  return response.update_id;\n}\n\n/** Poll an update to a terminal state; throws on timeout or non-COMPLETED terminal states. */\nexport { waitForPipelineUpdate };\n"]}

package/dist/chunk-SZL3KWW7.js

@@ -0,0 +1,62 @@
+// src/fixtures.ts
+function isFixtureResult(value) {
+  return typeof value === "object" && value !== null && Object.prototype.hasOwnProperty.call(value, "value") && typeof value.cleanup === "function";
+}
+var SharedFixtureRegistry = class {
+  runEntries = /* @__PURE__ */ new Map();
+  featureEntries = /* @__PURE__ */ new Map();
+  cleanupOrder = [];
+  runFixture(key, setup) {
+    return this.resolve(this.runEntries, key, setup);
+  }
+  featureFixture(featureUri, key, setup) {
+    if (!featureUri) throw new Error("featureFixture requires a feature URI");
+    let feature = this.featureEntries.get(featureUri);
+    if (!feature) {
+      feature = /* @__PURE__ */ new Map();
+      this.featureEntries.set(featureUri, feature);
+    }
+    return this.resolve(feature, key, setup);
+  }
+  resolve(entries, key, setup) {
+    if (!key.trim()) throw new Error("Fixture key must not be empty");
+    const existing = entries.get(key);
+    if (existing) return existing.value;
+    const entry = {
+      value: Promise.resolve().then(setup).then((result) => {
+        if (isFixtureResult(result)) {
+          entry.cleanup = result.cleanup;
+          return result.value;
+        }
+        return result;
+      }).catch((error) => {
+        entries.delete(key);
+        const index = this.cleanupOrder.indexOf(entry);
+        if (index >= 0) this.cleanupOrder.splice(index, 1);
+        throw error;
+      })
+    };
+    entries.set(key, entry);
+    this.cleanupOrder.push(entry);
+    return entry.value;
+  }
+  async dispose() {
+    const errors = [];
+    for (const entry of this.cleanupOrder.splice(0).reverse()) {
+      try {
+        await entry.value.catch(() => void 0);
+        await entry.cleanup?.();
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    this.runEntries.clear();
+    this.featureEntries.clear();
+    if (errors.length > 0) throw new AggregateError(errors, "Shared fixture cleanup failed");
+  }
+};
+var sharedFixtures = new SharedFixtureRegistry();
+
+export { SharedFixtureRegistry, sharedFixtures };
+//# sourceMappingURL=chunk-SZL3KWW7.js.map
+//# sourceMappingURL=chunk-SZL3KWW7.js.map

package/dist/chunk-SZL3KWW7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fixtures.ts"],"names":[],"mappings":"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","file":"chunk-SZL3KWW7.js","sourcesContent":["/**\n * Behave-style shared fixtures for expensive Databricks resources.\n *\n * Cucumber Worlds are scenario-scoped. These registries provide the two\n * broader scopes users commonly need when migrating Behave suites:\n *\n * - runFixture: setup once for the entire Cucumber run;\n * - featureFixture: setup once per feature URI.\n *\n * Both scopes are drained by the package AfterAll hook. Deferring feature\n * cleanup until AfterAll is intentional: cucumber-js may interleave scenarios\n * and does not expose an after-feature hook. The resource is still isolated by\n * feature URI and is never reused by another feature.\n */\n\nexport type FixtureCleanup = () => void | Promise<void>;\nexport type FixtureSetup<T> = () =>\n  | T\n  | Promise<T>\n  | { value: T; cleanup: FixtureCleanup }\n  | Promise<{ value: T; cleanup: FixtureCleanup }>;\n\ninterface FixtureEntry<T = unknown> {\n  value: Promise<T>;\n  cleanup?: FixtureCleanup;\n}\n\nfunction isFixtureResult<T>(value: T | { value: T; cleanup: FixtureCleanup }): value is {\n  value: T;\n  cleanup: FixtureCleanup;\n} {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    Object.prototype.hasOwnProperty.call(value, 'value') &&\n    typeof (value as { cleanup?: unknown }).cleanup === 'function'\n  );\n}\n\nexport class SharedFixtureRegistry {\n  private readonly runEntries = new Map<string, FixtureEntry>();\n  private readonly featureEntries = new Map<string, Map<string, FixtureEntry>>();\n  private readonly cleanupOrder: FixtureEntry[] = [];\n\n  runFixture<T>(key: string, setup: FixtureSetup<T>): Promise<T> {\n    return this.resolve(this.runEntries, key, setup);\n  }\n\n  featureFixture<T>(featureUri: string, key: string, setup: FixtureSetup<T>): Promise<T> {\n    if (!featureUri) throw new Error('featureFixture requires a feature URI');\n    let feature = this.featureEntries.get(featureUri);\n    if (!feature) {\n      feature = new Map();\n      this.featureEntries.set(featureUri, feature);\n    }\n    return this.resolve(feature, key, setup);\n  }\n\n  private resolve<T>(entries: Map<string, FixtureEntry>, key: string, setup: FixtureSetup<T>) {\n    if (!key.trim()) throw new Error('Fixture key must not be empty');\n    const existing = entries.get(key);\n    if (existing) return existing.value as Promise<T>;\n\n    const entry: FixtureEntry<T> = {\n      value: Promise.resolve()\n        .then(setup)\n        .then((result) => {\n          if (isFixtureResult(result)) {\n            entry.cleanup = result.cleanup;\n            return result.value;\n          }\n          return result;\n        })\n        .catch((error) => {\n          entries.delete(key);\n          const index = this.cleanupOrder.indexOf(entry);\n          if (index >= 0) this.cleanupOrder.splice(index, 1);\n          throw error;\n        }),\n    };\n    entries.set(key, entry);\n    this.cleanupOrder.push(entry);\n    return entry.value;\n  }\n\n  async dispose(): Promise<void> {\n    const errors: unknown[] = [];\n    for (const entry of this.cleanupOrder.splice(0).reverse()) {\n      try {\n        // Ensure setup has settled before attempting its cleanup.\n        await entry.value.catch(() => undefined);\n        await entry.cleanup?.();\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n    this.runEntries.clear();\n    this.featureEntries.clear();\n    if (errors.length > 0) throw new AggregateError(errors, 'Shared fixture cleanup failed');\n  }\n}\n\nexport const sharedFixtures = new SharedFixtureRegistry();\n"]}

package/dist/fixtures.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+// src/fixtures.ts
+function isFixtureResult(value) {
+  return typeof value === "object" && value !== null && Object.prototype.hasOwnProperty.call(value, "value") && typeof value.cleanup === "function";
+}
+var SharedFixtureRegistry = class {
+  runEntries = /* @__PURE__ */ new Map();
+  featureEntries = /* @__PURE__ */ new Map();
+  cleanupOrder = [];
+  runFixture(key, setup) {
+    return this.resolve(this.runEntries, key, setup);
+  }
+  featureFixture(featureUri, key, setup) {
+    if (!featureUri) throw new Error("featureFixture requires a feature URI");
+    let feature = this.featureEntries.get(featureUri);
+    if (!feature) {
+      feature = /* @__PURE__ */ new Map();
+      this.featureEntries.set(featureUri, feature);
+    }
+    return this.resolve(feature, key, setup);
+  }
+  resolve(entries, key, setup) {
+    if (!key.trim()) throw new Error("Fixture key must not be empty");
+    const existing = entries.get(key);
+    if (existing) return existing.value;
+    const entry = {
+      value: Promise.resolve().then(setup).then((result) => {
+        if (isFixtureResult(result)) {
+          entry.cleanup = result.cleanup;
+          return result.value;
+        }
+        return result;
+      }).catch((error) => {
+        entries.delete(key);
+        const index = this.cleanupOrder.indexOf(entry);
+        if (index >= 0) this.cleanupOrder.splice(index, 1);
+        throw error;
+      })
+    };
+    entries.set(key, entry);
+    this.cleanupOrder.push(entry);
+    return entry.value;
+  }
+  async dispose() {
+    const errors = [];
+    for (const entry of this.cleanupOrder.splice(0).reverse()) {
+      try {
+        await entry.value.catch(() => void 0);
+        await entry.cleanup?.();
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    this.runEntries.clear();
+    this.featureEntries.clear();
+    if (errors.length > 0) throw new AggregateError(errors, "Shared fixture cleanup failed");
+  }
+};
+var sharedFixtures = new SharedFixtureRegistry();
+
+exports.SharedFixtureRegistry = SharedFixtureRegistry;
+exports.sharedFixtures = sharedFixtures;
+//# sourceMappingURL=fixtures.cjs.map
+//# sourceMappingURL=fixtures.cjs.map

package/dist/fixtures.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fixtures.ts"],"names":[],"mappings":"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","file":"fixtures.cjs","sourcesContent":["/**\n * Behave-style shared fixtures for expensive Databricks resources.\n *\n * Cucumber Worlds are scenario-scoped. These registries provide the two\n * broader scopes users commonly need when migrating Behave suites:\n *\n * - runFixture: setup once for the entire Cucumber run;\n * - featureFixture: setup once per feature URI.\n *\n * Both scopes are drained by the package AfterAll hook. Deferring feature\n * cleanup until AfterAll is intentional: cucumber-js may interleave scenarios\n * and does not expose an after-feature hook. The resource is still isolated by\n * feature URI and is never reused by another feature.\n */\n\nexport type FixtureCleanup = () => void | Promise<void>;\nexport type FixtureSetup<T> = () =>\n  | T\n  | Promise<T>\n  | { value: T; cleanup: FixtureCleanup }\n  | Promise<{ value: T; cleanup: FixtureCleanup }>;\n\ninterface FixtureEntry<T = unknown> {\n  value: Promise<T>;\n  cleanup?: FixtureCleanup;\n}\n\nfunction isFixtureResult<T>(value: T | { value: T; cleanup: FixtureCleanup }): value is {\n  value: T;\n  cleanup: FixtureCleanup;\n} {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    Object.prototype.hasOwnProperty.call(value, 'value') &&\n    typeof (value as { cleanup?: unknown }).cleanup === 'function'\n  );\n}\n\nexport class SharedFixtureRegistry {\n  private readonly runEntries = new Map<string, FixtureEntry>();\n  private readonly featureEntries = new Map<string, Map<string, FixtureEntry>>();\n  private readonly cleanupOrder: FixtureEntry[] = [];\n\n  runFixture<T>(key: string, setup: FixtureSetup<T>): Promise<T> {\n    return this.resolve(this.runEntries, key, setup);\n  }\n\n  featureFixture<T>(featureUri: string, key: string, setup: FixtureSetup<T>): Promise<T> {\n    if (!featureUri) throw new Error('featureFixture requires a feature URI');\n    let feature = this.featureEntries.get(featureUri);\n    if (!feature) {\n      feature = new Map();\n      this.featureEntries.set(featureUri, feature);\n    }\n    return this.resolve(feature, key, setup);\n  }\n\n  private resolve<T>(entries: Map<string, FixtureEntry>, key: string, setup: FixtureSetup<T>) {\n    if (!key.trim()) throw new Error('Fixture key must not be empty');\n    const existing = entries.get(key);\n    if (existing) return existing.value as Promise<T>;\n\n    const entry: FixtureEntry<T> = {\n      value: Promise.resolve()\n        .then(setup)\n        .then((result) => {\n          if (isFixtureResult(result)) {\n            entry.cleanup = result.cleanup;\n            return result.value;\n          }\n          return result;\n        })\n        .catch((error) => {\n          entries.delete(key);\n          const index = this.cleanupOrder.indexOf(entry);\n          if (index >= 0) this.cleanupOrder.splice(index, 1);\n          throw error;\n        }),\n    };\n    entries.set(key, entry);\n    this.cleanupOrder.push(entry);\n    return entry.value;\n  }\n\n  async dispose(): Promise<void> {\n    const errors: unknown[] = [];\n    for (const entry of this.cleanupOrder.splice(0).reverse()) {\n      try {\n        // Ensure setup has settled before attempting its cleanup.\n        await entry.value.catch(() => undefined);\n        await entry.cleanup?.();\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n    this.runEntries.clear();\n    this.featureEntries.clear();\n    if (errors.length > 0) throw new AggregateError(errors, 'Shared fixture cleanup failed');\n  }\n}\n\nexport const sharedFixtures = new SharedFixtureRegistry();\n"]}

package/dist/fixtures.d.cts

@@ -0,0 +1,34 @@
+/**
+ * Behave-style shared fixtures for expensive Databricks resources.
+ *
+ * Cucumber Worlds are scenario-scoped. These registries provide the two
+ * broader scopes users commonly need when migrating Behave suites:
+ *
+ * - runFixture: setup once for the entire Cucumber run;
+ * - featureFixture: setup once per feature URI.
+ *
+ * Both scopes are drained by the package AfterAll hook. Deferring feature
+ * cleanup until AfterAll is intentional: cucumber-js may interleave scenarios
+ * and does not expose an after-feature hook. The resource is still isolated by
+ * feature URI and is never reused by another feature.
+ */
+type FixtureCleanup = () => void | Promise<void>;
+type FixtureSetup<T> = () => T | Promise<T> | {
+    value: T;
+    cleanup: FixtureCleanup;
+} | Promise<{
+    value: T;
+    cleanup: FixtureCleanup;
+}>;
+declare class SharedFixtureRegistry {
+    private readonly runEntries;
+    private readonly featureEntries;
+    private readonly cleanupOrder;
+    runFixture<T>(key: string, setup: FixtureSetup<T>): Promise<T>;
+    featureFixture<T>(featureUri: string, key: string, setup: FixtureSetup<T>): Promise<T>;
+    private resolve;
+    dispose(): Promise<void>;
+}
+declare const sharedFixtures: SharedFixtureRegistry;
+
+export { type FixtureCleanup, type FixtureSetup, SharedFixtureRegistry, sharedFixtures };

package/dist/fixtures.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Behave-style shared fixtures for expensive Databricks resources.
+ *
+ * Cucumber Worlds are scenario-scoped. These registries provide the two
+ * broader scopes users commonly need when migrating Behave suites:
+ *
+ * - runFixture: setup once for the entire Cucumber run;
+ * - featureFixture: setup once per feature URI.
+ *
+ * Both scopes are drained by the package AfterAll hook. Deferring feature
+ * cleanup until AfterAll is intentional: cucumber-js may interleave scenarios
+ * and does not expose an after-feature hook. The resource is still isolated by
+ * feature URI and is never reused by another feature.
+ */
+type FixtureCleanup = () => void | Promise<void>;
+type FixtureSetup<T> = () => T | Promise<T> | {
+    value: T;
+    cleanup: FixtureCleanup;
+} | Promise<{
+    value: T;
+    cleanup: FixtureCleanup;
+}>;
+declare class SharedFixtureRegistry {
+    private readonly runEntries;
+    private readonly featureEntries;
+    private readonly cleanupOrder;
+    runFixture<T>(key: string, setup: FixtureSetup<T>): Promise<T>;
+    featureFixture<T>(featureUri: string, key: string, setup: FixtureSetup<T>): Promise<T>;
+    private resolve;
+    dispose(): Promise<void>;
+}
+declare const sharedFixtures: SharedFixtureRegistry;
+
+export { type FixtureCleanup, type FixtureSetup, SharedFixtureRegistry, sharedFixtures };

package/dist/fixtures.js

@@ -0,0 +1,3 @@
+export { SharedFixtureRegistry, sharedFixtures } from './chunk-SZL3KWW7.js';
+//# sourceMappingURL=fixtures.js.map
+//# sourceMappingURL=fixtures.js.map

package/dist/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"fixtures.js"}

package/dist/index.cjs

@@ -9,6 +9,67 @@ var path = require('path');
 var util = require('util');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// src/world.ts
+
+// src/fixtures.ts
+function isFixtureResult(value) {
+  return typeof value === "object" && value !== null && Object.prototype.hasOwnProperty.call(value, "value") && typeof value.cleanup === "function";
+}
+var SharedFixtureRegistry = class {
+  runEntries = /* @__PURE__ */ new Map();
+  featureEntries = /* @__PURE__ */ new Map();
+  cleanupOrder = [];
+  runFixture(key, setup) {
+    return this.resolve(this.runEntries, key, setup);
+  }
+  featureFixture(featureUri, key, setup) {
+    if (!featureUri) throw new Error("featureFixture requires a feature URI");
+    let feature = this.featureEntries.get(featureUri);
+    if (!feature) {
+      feature = /* @__PURE__ */ new Map();
+      this.featureEntries.set(featureUri, feature);
+    }
+    return this.resolve(feature, key, setup);
+  }
+  resolve(entries, key, setup) {
+    if (!key.trim()) throw new Error("Fixture key must not be empty");
+    const existing = entries.get(key);
+    if (existing) return existing.value;
+    const entry = {
+      value: Promise.resolve().then(setup).then((result) => {
+        if (isFixtureResult(result)) {
+          entry.cleanup = result.cleanup;
+          return result.value;
+        }
+        return result;
+      }).catch((error) => {
+        entries.delete(key);
+        const index = this.cleanupOrder.indexOf(entry);
+        if (index >= 0) this.cleanupOrder.splice(index, 1);
+        throw error;
+      })
+    };
+    entries.set(key, entry);
+    this.cleanupOrder.push(entry);
+    return entry.value;
+  }
+  async dispose() {
+    const errors = [];
+    for (const entry of this.cleanupOrder.splice(0).reverse()) {
+      try {
+        await entry.value.catch(() => void 0);
+        await entry.cleanup?.();
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    this.runEntries.clear();
+    this.featureEntries.clear();
+    if (errors.length > 0) throw new AggregateError(errors, "Shared fixture cleanup failed");
+  }
+};
+var sharedFixtures = new SharedFixtureRegistry();
+
 // src/world.ts
 var DatabricksWorld = class extends cucumber.World {
   profile;
@@ -24,6 +85,7 @@ var DatabricksWorld = class extends cucumber.World {
   catalogOverride;
   lastSql;
   lastStatementId;
+  featureUri;
   stepOutputCapture;
   lakebasePool;
   ctx;
@@ -62,6 +124,20 @@ var DatabricksWorld = class extends cucumber.World {
   addCleanup(cleanup) {
     this.cleanups.push(cleanup);
   }
+  /** Setup a resource once for this Cucumber run and clean it up in AfterAll. */
+  runFixture(key, setup) {
+    return sharedFixtures.runFixture(key, setup);
+  }
+  /**
+   * Setup a resource once per feature file. It is isolated by feature URI and
+   * cleaned in AfterAll because cucumber-js has no reliable after-feature hook.
+   */
+  featureFixture(key, setup) {
+    if (!this.featureUri) {
+      throw new Error("featureFixture is only available after the scenario Before hook");
+    }
+    return sharedFixtures.featureFixture(this.featureUri, key, setup);
+  }
   /** Resolve runner userdata from worldParameters first, then DBX_TEST_USERDATA_* env. */
   userdata(name) {
     const configured = this.parameters.userdata?.[name];
@@ -386,6 +462,7 @@ exports.DatabricksWorld = DatabricksWorld;
 exports.FAILURE_EVIDENCE_MEDIA_TYPE = FAILURE_EVIDENCE_MEDIA_TYPE;
 exports.LIVE_ONLY_TAGS = LIVE_ONLY_TAGS;
 exports.RUN_STATES = RUN_STATES;
+exports.SharedFixtureRegistry = SharedFixtureRegistry;
 exports.coerceMatchRows = coerceMatchRows;
 exports.inferFixture = inferFixture;
 exports.liveOnlyReason = liveOnlyReason;
@@ -397,6 +474,7 @@ exports.resolveJobId = resolveJobId;
 exports.resolvePipelineId = resolvePipelineId;
 exports.runFeatures = runFeatures;
 exports.runJobToTerminal = runJobToTerminal;
+exports.sharedFixtures = sharedFixtures;
 exports.startPipelineUpdate = startPipelineUpdate;
 exports.startStepOutputCapture = startStepOutputCapture;
 //# sourceMappingURL=index.cjs.map