@cross-deck/web 1.4.2 → 1.5.0

package/dist/react.mjs

@@ -3676,6 +3676,37 @@ var CrossdeckClient = class {
    * trip happens in the background. To flush before the page unloads,
    * call flush().
    */
+  /**
+   * Emit `crossdeck.contract_failed` with the canonical property
+   * shape (`contract_id`, `sdk_version`, `sdk_platform`,
+   * `failure_reason`, `run_context`, `run_id`). Goes through the
+   * standard track() pipeline — same consent gate, same queue,
+   * same ingest, no new endpoint.
+   *
+   * Wire the call from a test hook, dogfood failure path, or
+   * customer contract-verification harness; see
+   * `contracts/README.md` for the per-test-framework hook recipes.
+   */
+  reportContractFailure(input) {
+    const props = {
+      contract_id: input.contractId,
+      sdk_version: SDK_VERSION,
+      sdk_platform: "web",
+      failure_reason: input.failureReason,
+      run_context: input.runContext,
+      run_id: input.runId
+    };
+    if (input.testRef) {
+      props.test_file = input.testRef.file;
+      props.test_name = input.testRef.name;
+    }
+    if (input.extra) {
+      for (const [k, v] of Object.entries(input.extra)) {
+        if (props[k] === void 0) props[k] = v;
+      }
+    }
+    this.track("crossdeck.contract_failed", props);
+  }
   track(name, properties) {
     const s = this.requireStarted();
     if (!name) {