@fabricorg/databricks-bdd 0.3.2 → 0.4.0

package/dist/chunk-HTKRJLVX.js

@@ -0,0 +1,70 @@
+// src/scoped-state.ts
+var SharedStateRegistry = class {
+  runValues = /* @__PURE__ */ new Map();
+  featureValues = /* @__PURE__ */ new Map();
+  run() {
+    return this.runValues;
+  }
+  feature(featureUri) {
+    if (!featureUri) throw new Error("Feature state requires a feature URI");
+    let values = this.featureValues.get(featureUri);
+    if (!values) {
+      values = /* @__PURE__ */ new Map();
+      this.featureValues.set(featureUri, values);
+    }
+    return values;
+  }
+  clear() {
+    this.runValues.clear();
+    this.featureValues.clear();
+  }
+};
+var ScopedState = class {
+  constructor(runValues, featureValues) {
+    this.runValues = runValues;
+    this.featureValues = featureValues;
+  }
+  runValues;
+  featureValues;
+  scenarioValues = /* @__PURE__ */ new Map();
+  set(scope, key, value) {
+    this.values(scope).set(validateKey(key), value);
+    return value;
+  }
+  get(key) {
+    const validKey = validateKey(key);
+    if (this.scenarioValues.has(validKey)) return this.scenarioValues.get(validKey);
+    if (this.featureValues.has(validKey)) return this.featureValues.get(validKey);
+    return this.runValues.get(validKey);
+  }
+  require(key) {
+    const value = this.get(key);
+    if (value === void 0) throw new Error(`Required BDD state '${key}' is not set`);
+    return value;
+  }
+  has(key) {
+    const validKey = validateKey(key);
+    return this.scenarioValues.has(validKey) || this.featureValues.has(validKey) || this.runValues.has(validKey);
+  }
+  delete(scope, key) {
+    return this.values(scope).delete(validateKey(key));
+  }
+  clearScenario() {
+    this.scenarioValues.clear();
+  }
+  values(scope) {
+    if (scope === "run") return this.runValues;
+    if (scope === "feature") return this.featureValues;
+    return this.scenarioValues;
+  }
+};
+function validateKey(key) {
+  const trimmed = key.trim();
+  if (!trimmed) throw new Error("BDD state key must not be empty");
+  return trimmed;
+}
+var sharedState = new SharedStateRegistry();
+
+export { ScopedState, SharedStateRegistry, sharedState };
+//# sourceMappingURL=chunk-HTKRJLVX.js.map
+//# sourceMappingURL=chunk-HTKRJLVX.js.map

package/dist/chunk-HTKRJLVX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scoped-state.ts"],"names":[],"mappings":"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","file":"chunk-HTKRJLVX.js","sourcesContent":["export type StateScope = 'run' | 'feature' | 'scenario';\n\ntype StateValues = Map<string, unknown>;\n\n/**\n * Process-local state backing Behave-style run and feature context layers.\n * Scenario values stay on the scenario World and are never shared.\n */\nexport class SharedStateRegistry {\n  private readonly runValues: StateValues = new Map();\n  private readonly featureValues = new Map<string, StateValues>();\n\n  run(): StateValues {\n    return this.runValues;\n  }\n\n  feature(featureUri: string): StateValues {\n    if (!featureUri) throw new Error('Feature state requires a feature URI');\n    let values = this.featureValues.get(featureUri);\n    if (!values) {\n      values = new Map();\n      this.featureValues.set(featureUri, values);\n    }\n    return values;\n  }\n\n  clear(): void {\n    this.runValues.clear();\n    this.featureValues.clear();\n  }\n}\n\n/** Layered state lookup: scenario overrides feature, which overrides run. */\nexport class ScopedState {\n  private readonly scenarioValues: StateValues = new Map();\n\n  constructor(\n    private readonly runValues: StateValues,\n    private readonly featureValues: StateValues,\n  ) {}\n\n  set<T>(scope: StateScope, key: string, value: T): T {\n    this.values(scope).set(validateKey(key), value);\n    return value;\n  }\n\n  get<T>(key: string): T | undefined {\n    const validKey = validateKey(key);\n    if (this.scenarioValues.has(validKey)) return this.scenarioValues.get(validKey) as T;\n    if (this.featureValues.has(validKey)) return this.featureValues.get(validKey) as T;\n    return this.runValues.get(validKey) as T | undefined;\n  }\n\n  require<T>(key: string): T {\n    const value = this.get<T>(key);\n    if (value === undefined) throw new Error(`Required BDD state '${key}' is not set`);\n    return value;\n  }\n\n  has(key: string): boolean {\n    const validKey = validateKey(key);\n    return (\n      this.scenarioValues.has(validKey) ||\n      this.featureValues.has(validKey) ||\n      this.runValues.has(validKey)\n    );\n  }\n\n  delete(scope: StateScope, key: string): boolean {\n    return this.values(scope).delete(validateKey(key));\n  }\n\n  clearScenario(): void {\n    this.scenarioValues.clear();\n  }\n\n  private values(scope: StateScope): StateValues {\n    if (scope === 'run') return this.runValues;\n    if (scope === 'feature') return this.featureValues;\n    return this.scenarioValues;\n  }\n}\n\nfunction validateKey(key: string): string {\n  const trimmed = key.trim();\n  if (!trimmed) throw new Error('BDD state key must not be empty');\n  return trimmed;\n}\n\nexport const sharedState = new SharedStateRegistry();\n"]}

package/dist/chunk-K5LJ7WSW.js

@@ -0,0 +1,22 @@
+// src/cardinality.ts
+function parseCardinalityField(value, cardinality, transform, options = {}) {
+  const fieldName = options.fieldName ?? "field";
+  const trimmed = value.trim();
+  const items = trimmed ? trimmed.split(options.separator ?? /\s*,\s*/).map((item) => item.trim()) : [];
+  if (items.some((item) => !item)) {
+    throw new Error(`${fieldName} contains an empty value`);
+  }
+  if (cardinality === "?" && items.length > 1) {
+    throw new Error(`${fieldName} expects zero or one value, received ${items.length}`);
+  }
+  if (cardinality === "+" && items.length === 0) {
+    throw new Error(`${fieldName} expects one or more values`);
+  }
+  const parsed = items.map(transform);
+  if (cardinality === "?") return parsed[0];
+  return parsed;
+}
+
+export { parseCardinalityField };
+//# sourceMappingURL=chunk-K5LJ7WSW.js.map
+//# sourceMappingURL=chunk-K5LJ7WSW.js.map

package/dist/chunk-K5LJ7WSW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cardinality.ts"],"names":[],"mappings":";AAmBO,SAAS,sBACd,KAAA,EACA,WAAA,EACA,SAAA,EACA,OAAA,GAA8B,EAAC,EACN;AACzB,EAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,OAAA;AACvC,EAAA,MAAM,OAAA,GAAU,MAAM,IAAA,EAAK;AAC3B,EAAA,MAAM,KAAA,GAAQ,OAAA,GACV,OAAA,CAAQ,KAAA,CAAM,QAAQ,SAAA,IAAa,SAAS,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,IAAA,CAAK,IAAA,EAAM,IACvE,EAAC;AACL,EAAA,IAAI,MAAM,IAAA,CAAK,CAAC,IAAA,KAAS,CAAC,IAAI,CAAA,EAAG;AAC/B,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,wBAAA,CAA0B,CAAA;AAAA,EACxD;AAEA,EAAA,IAAI,WAAA,KAAgB,GAAA,IAAO,KAAA,CAAM,MAAA,GAAS,CAAA,EAAG;AAC3C,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,qCAAA,EAAwC,KAAA,CAAM,MAAM,CAAA,CAAE,CAAA;AAAA,EACpF;AACA,EAAA,IAAI,WAAA,KAAgB,GAAA,IAAO,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG;AAC7C,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,2BAAA,CAA6B,CAAA;AAAA,EAC3D;AAEA,EAAA,MAAM,MAAA,GAAS,KAAA,CAAM,GAAA,CAAI,SAAS,CAAA;AAClC,EAAA,IAAI,WAAA,KAAgB,GAAA,EAAK,OAAO,MAAA,CAAO,CAAC,CAAA;AACxC,EAAA,OAAO,MAAA;AACT","file":"chunk-K5LJ7WSW.js","sourcesContent":["/** Cardinalities supported by Behave's cfparse fields. */\nexport type FieldCardinality = '?' | '*' | '+';\n\nexport interface CardinalityOptions {\n  /** Delimiter between values. Defaults to a comma with optional whitespace. */\n  separator?: string | RegExp;\n  /** Human-readable field name used in validation errors. */\n  fieldName?: string;\n}\n\nexport type CardinalityResult<T, C extends FieldCardinality> = C extends '?' ? T | undefined : T[];\n\n/**\n * Parse a Cucumber string parameter with cfparse-compatible cardinality.\n *\n * Use `?` for zero-or-one, `*` for zero-or-more, and `+` for one-or-more.\n * This keeps the capability in TypeScript while allowing standard Cucumber\n * Expressions and readable comma-separated parameters.\n */\nexport function parseCardinalityField<T, C extends FieldCardinality>(\n  value: string,\n  cardinality: C,\n  transform: (item: string, index: number) => T,\n  options: CardinalityOptions = {},\n): CardinalityResult<T, C> {\n  const fieldName = options.fieldName ?? 'field';\n  const trimmed = value.trim();\n  const items = trimmed\n    ? trimmed.split(options.separator ?? /\\s*,\\s*/).map((item) => item.trim())\n    : [];\n  if (items.some((item) => !item)) {\n    throw new Error(`${fieldName} contains an empty value`);\n  }\n\n  if (cardinality === '?' && items.length > 1) {\n    throw new Error(`${fieldName} expects zero or one value, received ${items.length}`);\n  }\n  if (cardinality === '+' && items.length === 0) {\n    throw new Error(`${fieldName} expects one or more values`);\n  }\n\n  const parsed = items.map(transform);\n  if (cardinality === '?') return parsed[0] as CardinalityResult<T, C>;\n  return parsed as CardinalityResult<T, C>;\n}\n"]}

package/dist/index.cjs

@@ -11,6 +11,14 @@ var util = require('util');
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 // src/world.ts
 
+// src/actions.ts
+function defineAction(action) {
+  return action;
+}
+async function runAction(world, action, ...args) {
+  return await action(world, ...args);
+}
+
 // src/fixtures.ts
 function isFixtureResult(value) {
   return typeof value === "object" && value !== null && Object.prototype.hasOwnProperty.call(value, "value") && typeof value.cleanup === "function";
@@ -70,6 +78,73 @@ var SharedFixtureRegistry = class {
 };
 var sharedFixtures = new SharedFixtureRegistry();
 
+// src/scoped-state.ts
+var SharedStateRegistry = class {
+  runValues = /* @__PURE__ */ new Map();
+  featureValues = /* @__PURE__ */ new Map();
+  run() {
+    return this.runValues;
+  }
+  feature(featureUri) {
+    if (!featureUri) throw new Error("Feature state requires a feature URI");
+    let values = this.featureValues.get(featureUri);
+    if (!values) {
+      values = /* @__PURE__ */ new Map();
+      this.featureValues.set(featureUri, values);
+    }
+    return values;
+  }
+  clear() {
+    this.runValues.clear();
+    this.featureValues.clear();
+  }
+};
+var ScopedState = class {
+  constructor(runValues, featureValues) {
+    this.runValues = runValues;
+    this.featureValues = featureValues;
+  }
+  runValues;
+  featureValues;
+  scenarioValues = /* @__PURE__ */ new Map();
+  set(scope, key, value) {
+    this.values(scope).set(validateKey(key), value);
+    return value;
+  }
+  get(key) {
+    const validKey = validateKey(key);
+    if (this.scenarioValues.has(validKey)) return this.scenarioValues.get(validKey);
+    if (this.featureValues.has(validKey)) return this.featureValues.get(validKey);
+    return this.runValues.get(validKey);
+  }
+  require(key) {
+    const value = this.get(key);
+    if (value === void 0) throw new Error(`Required BDD state '${key}' is not set`);
+    return value;
+  }
+  has(key) {
+    const validKey = validateKey(key);
+    return this.scenarioValues.has(validKey) || this.featureValues.has(validKey) || this.runValues.has(validKey);
+  }
+  delete(scope, key) {
+    return this.values(scope).delete(validateKey(key));
+  }
+  clearScenario() {
+    this.scenarioValues.clear();
+  }
+  values(scope) {
+    if (scope === "run") return this.runValues;
+    if (scope === "feature") return this.featureValues;
+    return this.scenarioValues;
+  }
+};
+function validateKey(key) {
+  const trimmed = key.trim();
+  if (!trimmed) throw new Error("BDD state key must not be empty");
+  return trimmed;
+}
+var sharedState = new SharedStateRegistry();
+
 // src/world.ts
 var DatabricksWorld = class extends cucumber.World {
   profile;
@@ -86,10 +161,13 @@ var DatabricksWorld = class extends cucumber.World {
   lastSql;
   lastStatementId;
   featureUri;
+  scenarioName;
+  effectiveTags = [];
   stepOutputCapture;
   lakebasePool;
   ctx;
   activeCtx;
+  scopedState;
   cleanups = [];
   constructor(options) {
     super(options);
@@ -124,6 +202,29 @@ var DatabricksWorld = class extends cucumber.World {
   addCleanup(cleanup) {
     this.cleanups.push(cleanup);
   }
+  /** Initialize Behave-style feature/scenario metadata and layered state. */
+  initializeScenario(featureUri, scenarioName, tags) {
+    this.featureUri = featureUri;
+    this.scenarioName = scenarioName;
+    this.effectiveTags = [...tags];
+    this.scopedState = new ScopedState(sharedState.run(), sharedState.feature(featureUri));
+  }
+  /** Set typed state at run, feature, or scenario scope. */
+  setState(scope, key, value) {
+    return this.state().set(scope, key, value);
+  }
+  /** Resolve state using scenario → feature → run precedence. */
+  getState(key) {
+    return this.state().get(key);
+  }
+  /** Resolve required layered state or fail with a useful message. */
+  requireState(key) {
+    return this.state().require(key);
+  }
+  /** Compose a reusable typed action without reparsing textual Gherkin. */
+  runAction(action, ...args) {
+    return runAction(this, action, ...args);
+  }
   /** Setup a resource once for this Cucumber run and clean it up in AfterAll. */
   runFixture(key, setup) {
     return sharedFixtures.runFixture(key, setup);
@@ -170,8 +271,16 @@ var DatabricksWorld = class extends cucumber.World {
       errors.push(error);
     }
     this.ctx = void 0;
+    this.scopedState?.clearScenario();
+    this.scopedState = void 0;
     if (errors.length > 0) throw new AggregateError(errors, "Scenario cleanup failed");
   }
+  state() {
+    if (!this.scopedState) {
+      throw new Error("BDD scoped state is only available after the scenario Before hook");
+    }
+    return this.scopedState;
+  }
 };
 
 // src/profile.ts
@@ -190,6 +299,68 @@ function liveOnlyReason(tags, profile) {
   if (blocking.length === 0) return null;
   return `requires a live workspace (${blocking.join(", ")}); running under DBX_TEST_PROFILE=local`;
 }
+function capabilitiesFromEnv(profile, env = process.env) {
+  const capabilities = { profile };
+  const builtins = [
+    ["cloud", env.DBX_TEST_CLOUD],
+    ["compute", env.DBX_TEST_COMPUTE_MODE ?? env.DBX_TEST_COMPUTE],
+    ["stage", env.DBX_TEST_STAGE]
+  ];
+  for (const [key, value] of builtins) {
+    if (value !== void 0 && value !== "") capabilities[key] = value;
+  }
+  for (const [name, value] of Object.entries(env)) {
+    if (!name.startsWith("DBX_TEST_CAPABILITY_") || value === void 0) continue;
+    capabilities[normalizeCapabilityKey(name.slice("DBX_TEST_CAPABILITY_".length))] = value;
+  }
+  return capabilities;
+}
+function capabilityTagReason(tags, capabilities) {
+  const normalized = new Map(
+    Object.entries(capabilities).map(([key, value]) => [
+      normalizeCapabilityKey(key),
+      String(value).toLowerCase()
+    ])
+  );
+  for (const tag of tags) {
+    const predicate = parseCapabilityTag(tag);
+    if (!predicate) continue;
+    const actual = normalized.get(normalizeCapabilityKey(predicate.key));
+    const matches = predicate.expected ? actual === predicate.expected.toLowerCase() : actual !== void 0 && !["", "0", "false", "no", "off"].includes(actual);
+    if (predicate.kind === "requires" && !matches) {
+      return `${tag} requires capability ${predicate.key}${predicate.expected ? `=${predicate.expected}` : ""}; actual ${actual ?? "unset"}`;
+    }
+    if (predicate.kind === "excludes" && matches) {
+      return `${tag} excludes capability ${predicate.key}${predicate.expected ? `=${predicate.expected}` : ""}`;
+    }
+  }
+  return null;
+}
+function scenarioSkipReason(tags, profile, env = process.env) {
+  return liveOnlyReason(tags, profile) ?? capabilityTagReason(tags, capabilitiesFromEnv(profile, env));
+}
+function parseCapabilityTag(tag) {
+  const direct = tag.match(/^@(requires|excludes)\.([^=]+)(?:=(.+))?$/i);
+  if (direct?.[1] && direct[2]) {
+    return {
+      kind: direct[1].toLowerCase(),
+      key: direct[2],
+      ...direct[3] ? { expected: direct[3] } : {}
+    };
+  }
+  const behave = tag.match(/^@(use|not)\.with_([^=]+)=(.+)$/i);
+  if (behave?.[1] && behave[2] && behave[3]) {
+    return {
+      kind: behave[1].toLowerCase() === "use" ? "requires" : "excludes",
+      key: behave[2],
+      expected: behave[3]
+    };
+  }
+  return void 0;
+}
+function normalizeCapabilityKey(key) {
+  return key.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_");
+}
 
 // src/infer.ts
 var INT_RE = /^-?\d+$/;
@@ -454,6 +625,25 @@ function renderChunks(chunks) {
   return rendered.trimEnd();
 }
 
+// src/cardinality.ts
+function parseCardinalityField(value, cardinality, transform, options = {}) {
+  const fieldName = options.fieldName ?? "field";
+  const trimmed = value.trim();
+  const items = trimmed ? trimmed.split(options.separator ?? /\s*,\s*/).map((item) => item.trim()) : [];
+  if (items.some((item) => !item)) {
+    throw new Error(`${fieldName} contains an empty value`);
+  }
+  if (cardinality === "?" && items.length > 1) {
+    throw new Error(`${fieldName} expects zero or one value, received ${items.length}`);
+  }
+  if (cardinality === "+" && items.length === 0) {
+    throw new Error(`${fieldName} expects one or more values`);
+  }
+  const parsed = items.map(transform);
+  if (cardinality === "?") return parsed[0];
+  return parsed;
+}
+
 Object.defineProperty(exports, "waitForPipelineUpdate", {
   enumerable: true,
   get: function () { return databricksTestkit.waitForPipelineUpdate; }
@@ -462,19 +652,28 @@ 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.ScopedState = ScopedState;
 exports.SharedFixtureRegistry = SharedFixtureRegistry;
+exports.SharedStateRegistry = SharedStateRegistry;
+exports.capabilitiesFromEnv = capabilitiesFromEnv;
+exports.capabilityTagReason = capabilityTagReason;
 exports.coerceMatchRows = coerceMatchRows;
+exports.defineAction = defineAction;
 exports.inferFixture = inferFixture;
 exports.liveOnlyReason = liveOnlyReason;
+exports.parseCardinalityField = parseCardinalityField;
 exports.parseDuration = parseDuration;
 exports.parseFailureEvidenceAttachment = parseFailureEvidenceAttachment;
 exports.parseTableIdentifier = parseTableIdentifier;
 exports.redactSecrets = redactSecrets;
 exports.resolveJobId = resolveJobId;
 exports.resolvePipelineId = resolvePipelineId;
+exports.runAction = runAction;
 exports.runFeatures = runFeatures;
 exports.runJobToTerminal = runJobToTerminal;
+exports.scenarioSkipReason = scenarioSkipReason;
 exports.sharedFixtures = sharedFixtures;
+exports.sharedState = sharedState;
 exports.startPipelineUpdate = startPipelineUpdate;
 exports.startStepOutputCapture = startStepOutputCapture;
 //# sourceMappingURL=index.cjs.map