@apifuse/provider-sdk 2.2.0-beta.37 → 2.2.0-beta.38

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @apifuse/provider-sdk Changelog
 
+## 2.2.0-beta.38
+
+- Release candidate for main commit 448775077dbc9ab907209f1feee4e6e4e5ef4283.
+
 ## 2.2.0-beta.37
 
 - Release candidate for main commit aa14b268dffe1196f25c2b6b314598fe0896edec.

package/dist/declaration-validation.d.ts

@@ -4,6 +4,8 @@ export declare const DECLARATION_INVALID_CODE = "DECLARATION_INVALID";
 export declare const DECLARATION_RULE_IDS: {
     readonly challengeShape: "credentials-challenge-shape";
     readonly journeyExecutable: "health-journey-executable";
+    readonly journeyRunScenarioExclusive: "health-journey-run-scenario-exclusive";
+    readonly journeyScenarioValid: "health-journey-scenario-valid";
     readonly schemaSerializable: "operation-schema-serializable";
     readonly proxyExplicitPolicy: "proxy-explicit-policy";
     readonly proxyVendorExclusive: "proxy-vendor-fields-exclusive";

package/dist/declaration-validation.js

@@ -1,9 +1,12 @@
 import { describeSchema } from "./contract-serialization.js";
 import { ProviderError } from "./errors.js";
+import { HealthScenarioSchema } from "./health-scenario.js";
 export const DECLARATION_INVALID_CODE = "DECLARATION_INVALID";
 export const DECLARATION_RULE_IDS = {
     challengeShape: "credentials-challenge-shape",
     journeyExecutable: "health-journey-executable",
+    journeyRunScenarioExclusive: "health-journey-run-scenario-exclusive",
+    journeyScenarioValid: "health-journey-scenario-valid",
     schemaSerializable: "operation-schema-serializable",
     proxyExplicitPolicy: "proxy-explicit-policy",
     proxyVendorExclusive: "proxy-vendor-fields-exclusive",
@@ -35,15 +38,38 @@ function validateHealthDeclaration(provider, violations) {
     for (const [index, journey] of (provider.healthJourneys ?? []).entries()) {
         if (!journey || typeof journey !== "object")
             continue;
-        if (typeof journey.run !== "function") {
+        const hasRun = journey.run !== undefined;
+        const hasScenario = journey.scenario !== undefined;
+        if (hasRun && hasScenario) {
+            const journeyPath = healthJourneyPath(journey, index);
+            violations.push({
+                ruleId: DECLARATION_RULE_IDS.journeyRunScenarioExclusive,
+                path: journeyPath,
+                message: "A health journey must declare exactly one of run or scenario, not both.",
+                fix: `Remove either ${journeyPath}.run or ${journeyPath}.scenario.`,
+            });
+        }
+        if (!hasRun && !hasScenario) {
             const journeyPath = healthJourneyPath(journey, index);
             violations.push({
                 ruleId: DECLARATION_RULE_IDS.journeyExecutable,
                 path: `${journeyPath}.run`,
-                message: "coversOperations cannot provide health coverage without executable run logic.",
-                fix: `Add an async run(ctx) implementation to ${journeyPath}.`,
+                message: "coversOperations cannot provide health coverage without run or a declarative scenario.",
+                fix: `Add an async run(ctx) implementation or a valid scenario to ${journeyPath}.`,
             });
         }
+        if (hasScenario) {
+            const parsed = HealthScenarioSchema.safeParse(journey.scenario);
+            if (!parsed.success) {
+                const journeyPath = healthJourneyPath(journey, index);
+                violations.push({
+                    ruleId: DECLARATION_RULE_IDS.journeyScenarioValid,
+                    path: `${journeyPath}.scenario`,
+                    message: "scenario must conform to HealthScenario.",
+                    fix: "Build the scenario with defineHealthScenario().",
+                });
+            }
+        }
     }
     // NOTE: healthCheck.cases[].enabled is intentionally NOT validated here.
     // self-test.ts reports a gated case as status "skipped" with skipReason

package/dist/define.js

@@ -1413,6 +1413,7 @@ const HEALTH_JOURNEY_FIELDS = new Set([
     "manualTrigger",
     "steps",
     "run",
+    "scenario",
 ]);
 const HEALTH_JOURNEY_SCHEDULE_FIELDS = new Set(["kind", "interval", "jitter", "randomize"]);
 const HEALTH_JOURNEY_STEP_FIELDS = new Set([
@@ -1835,6 +1836,10 @@ function validateHealthJourneys(providerId, operations, healthJourneys) {
         }
         if (journey.manualTrigger !== undefined)
             validateHealthJourneyManualTrigger(providerId, journey.id, journey.manualTrigger);
+        if (journey.scenario !== undefined && journey.smsMatchers !== undefined)
+            throw new ValidationError(`Provider "${providerId}" healthJourneys.${journey.id}.smsMatchers is not allowed on declarative scenarios.`);
+        if (journey.scenario !== undefined && journey.requiredSecrets !== undefined)
+            throw new ValidationError(`Provider "${providerId}" healthJourneys.${journey.id}.requiredSecrets is not allowed on declarative scenarios.`);
         if (journey.timeout !== undefined)
             assertIsoDuration(journey.timeout, `Provider "${providerId}" healthJourneys.${journey.id}.timeout`);
         if (journey.cooldown !== undefined)