@adcp/sdk 13.0.0-rc.11 → 13.0.0-rc.13

package/dist/lib/testing/storyboard/validations.d.mts

@@ -194,6 +194,17 @@ export interface UpstreamTrafficQueryResult {
  * Run all validations for a storyboard step.
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
+/** Capability semver emitted in run summaries and used for advisory expiry. */
+export declare const RUNNER_CAPABILITY_VERSION = "13.0.0-rc.13";
+/** True when a failed validation contributes to the owning step's grade. */
+export declare function validationFailsStep(result: ValidationResult): boolean;
+/**
+ * Attach request / response records to a failed validation so implementors
+ * see the exact bytes the runner sent and observed. Passed validations stay
+ * minimal — carrying the full payload on every passing check bloats the
+ * JSON surface without diagnostic value.
+ */
+export declare function decorateValidationResult(result: ValidationResult, context: ValidationContext, validation: StoryboardValidation): ValidationResult;
 /**
  * Recognize common payload-shape mistakes and return the human-readable
  * fix-recipe — `string` form retained for direct unit-test callers and

package/dist/lib/testing/storyboard/validations.d.ts

@@ -194,6 +194,17 @@ export interface UpstreamTrafficQueryResult {
  * Run all validations for a storyboard step.
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
+/** Capability semver emitted in run summaries and used for advisory expiry. */
+export declare const RUNNER_CAPABILITY_VERSION = "13.0.0-rc.13";
+/** True when a failed validation contributes to the owning step's grade. */
+export declare function validationFailsStep(result: ValidationResult): boolean;
+/**
+ * Attach request / response records to a failed validation so implementors
+ * see the exact bytes the runner sent and observed. Passed validations stay
+ * minimal — carrying the full payload on every passing check bloats the
+ * JSON surface without diagnostic value.
+ */
+export declare function decorateValidationResult(result: ValidationResult, context: ValidationContext, validation: StoryboardValidation): ValidationResult;
 /**
  * Recognize common payload-shape mistakes and return the human-readable
  * fix-recipe — `string` form retained for direct unit-test callers and

package/dist/lib/testing/storyboard/validations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validations.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/validations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validations.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/validations.ts"],"names":[],"mappings":"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"}

package/dist/lib/testing/storyboard/validations.js

@@ -19,9 +19,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var validations_exports = {};
 __export(validations_exports, {
   LIST_WRAPPER_TOOLS: () => import_shape_drift_hints2.LIST_WRAPPER_TOOLS,
+  RUNNER_CAPABILITY_VERSION: () => RUNNER_CAPABILITY_VERSION,
+  decorateValidationResult: () => decorateValidationResult,
   detectShapeDriftHint: () => detectShapeDriftHint,
   resolvePath: () => import_path2.resolvePath,
-  runValidations: () => runValidations
+  runValidations: () => runValidations,
+  validationFailsStep: () => validationFailsStep
 });
 module.exports = __toCommonJS(validations_exports);
 var import_response_schemas = require('../../utils/response-schemas.js');
@@ -31,6 +34,7 @@ var import_schema_validator = require('../../validation/schema-validator.js');
 var import_schema_loader = require('../../validation/schema-loader.js');
 var import_version = require('../../version.js');
 var import_adcp_version_config = require('../../utils/adcp-version-config.js');
+var import_semver = require("semver");
 var import_test_controller = require('../test-controller.js');
 var import_glob = require('../../utils/glob.js');
 var import_path = require('./path.js');
@@ -42,15 +46,27 @@ var import_oauth_metadata_graph = require('./oauth-metadata-graph/index.js');
 var import_shape_drift_hints2 = require('./shape-drift-hints.js');
 var import_path2 = require('./path.js');
 function runValidations(validations, context) {
-  return validations.map((v) => attachOnFailure(runValidation(v, context), context, v));
+  return validations.map((v) => decorateValidationResult(runValidation(v, context), context, v));
 }
-function attachOnFailure(result, context, validation) {
-  const withId = validation.id === void 0 ? result : {
+const RUNNER_CAPABILITY_VERSION = import_version.LIBRARY_VERSION;
+function validationFailsStep(result) {
+  return !result.passed && result.severity !== "advisory";
+}
+function decorateValidationResult(result, context, validation) {
+  const declaredSeverity = validation.severity ?? "required";
+  const expiry = validation.expires_after_version;
+  const shouldEvaluatePromotion = !result.not_applicable && declaredSeverity === "advisory" && expiry !== void 0;
+  if (shouldEvaluatePromotion && (0, import_semver.valid)(expiry) === null) {
+    throw new Error(`expires_after_version must be valid semver; received ${JSON.stringify(expiry)}`);
+  }
+  const promotionApplied = shouldEvaluatePromotion && (0, import_semver.valid)(RUNNER_CAPABILITY_VERSION) !== null && (0, import_semver.gte)(RUNNER_CAPABILITY_VERSION, expiry);
+  const augmented = {
     ...result,
-    id: validation.id
+    ...validation.id !== void 0 && { id: validation.id },
+    severity: promotionApplied ? "required" : declaredSeverity,
+    ...shouldEvaluatePromotion && { severity_promoted_from_advisory: promotionApplied }
   };
-  if (withId.passed) return withId;
-  const augmented = { ...withId };
+  if (augmented.passed) return augmented;
   if (context.request && augmented.request === void 0) augmented.request = context.request;
   if (context.response && augmented.response === void 0) augmented.response = context.response;
   return augmented;
@@ -143,12 +159,10 @@ function runValidation(validation, ctx) {
     default:
       return {
         check: validation.check,
-        passed: false,
+        passed: true,
         description: validation.description,
-        error: `runner does not implement authored check type '${validation.check}'`,
-        json_pointer: null,
-        expected: "a validation check implemented by this runner",
-        actual: validation.check
+        not_applicable: true,
+        note: `runner does not implement authored check type '${validation.check}'`
       };
   }
 }
@@ -2405,8 +2419,11 @@ function validateCrossResponseCountDistinct(validation, ctx) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LIST_WRAPPER_TOOLS,
+  RUNNER_CAPABILITY_VERSION,
+  decorateValidationResult,
   detectShapeDriftHint,
   resolvePath,
-  runValidations
+  runValidations,
+  validationFailsStep
 });
 //# sourceMappingURL=validations.js.map