@varde-flyt/vfac 0.6.0 → 0.7.0

package/dist/vfac.mjs

@@ -13403,6 +13403,16 @@ var ProductOutputSchema = external_exports.object({
    */
   secret: external_exports.boolean().optional()
 }).strict();
+var ProductConditionSchema = external_exports.object({
+  key: external_exports.string().regex(/^[a-z][a-zA-Z0-9]{1,47}$/, "Condition keys are camelCase.").describe("Stable key. A running instance reports its state under this key."),
+  displayName: external_exports.string().min(2).max(60),
+  /**
+   * What the customer must understand, and — when it is ACTION_REQUIRED —
+   * enough to act on. The platform never writes this sentence: it does not
+   * know what the condition is about.
+   */
+  description: external_exports.string().min(10).max(300)
+}).strict();
 var ProductDependencySchema = external_exports.object({
   /**
    * OPTIONAL ONLY WHEN `interface` IS PRESENT, enforced below.
@@ -13631,6 +13641,16 @@ var ProductDefinitionObjectSchema = external_exports.object({
   // --- Results, relationships, operations -------------------------------
   outputs: external_exports.array(ProductOutputSchema).min(1).max(MAX_PRODUCT_OUTPUTS),
   dependencies: external_exports.array(ProductDependencySchema).max(8),
+  /**
+   * Operational conditions a running instance of this Product may report.
+   *
+   * `.optional()`, NEVER `.default([])`. A default materialises the key,
+   * `contractDigest` digests the parsed object, and a republish of unchanged
+   * bytes would then be refused as `RELEASED_CONTRACT_MUTATED`. Absent means
+   * this Product reports none, which is what every Definition published
+   * before this field already means.
+   */
+  conditions: external_exports.array(ProductConditionSchema).min(1).max(8).optional(),
   /**
    * The service interfaces this Product provides to other Products.
    *
@@ -13697,6 +13717,15 @@ var ProductDefinitionSchema = ProductDefinitionObjectSchema.superRefine((definit
       });
     }
   });
+  const conditionKeys = (definition.conditions ?? []).map((condition) => condition.key);
+  const duplicateConditions = conditionKeys.filter((key, i) => conditionKeys.indexOf(key) !== i);
+  if (duplicateConditions.length > 0) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      path: ["conditions"],
+      message: `Duplicate condition keys: ${[...new Set(duplicateConditions)].join(", ")}.`
+    });
+  }
   const dependencyIds = definition.dependencies.map((dependency) => dependency.productId).filter((id) => id !== void 0);
   const duplicateDependencies = dependencyIds.filter((id, i) => dependencyIds.indexOf(id) !== i);
   if (duplicateDependencies.length > 0) {
@@ -14880,6 +14909,33 @@ var DeploymentBlueprintObjectSchema = external_exports.object({
   serviceExports: external_exports.array(ServiceExportSchema).max(MAX_SERVICE_EXPORTS).optional(),
   /** Service interfaces this Product consumes. Absent means none. */
   serviceBindings: external_exports.array(ServiceBindingSchema).max(MAX_SERVICE_BINDINGS).optional(),
+  /**
+   * Which of your own components may report an operational condition.
+   *
+   * NOT DECORATION, and the same policy `dynamicResources[].consumers` is. The
+   * Control Plane mints the condition-reporting credential only for a named
+   * component, so a Blueprint that names none has declared conditions in its
+   * Definition that nothing can reach. Delivery is the enforcement.
+   *
+   * `.optional()`, NEVER `.default([])` — `contractDigest` digests the parsed
+   * object, and a default would materialise the key on every Blueprint
+   * published before this field existed.
+   *
+   * EXACTLY ONE, and that is a property of what a condition IS rather than a
+   * limit somebody will want raised. A condition is keyed per INSTANCE, not
+   * per component: two components reporting `sso` write the same row and
+   * decide it between them by whichever clock is ahead, which is a race with
+   * a customer-visible answer. And "is this Product usable" is a statement
+   * about the instance — CLAUDE.md's "One Product Instance is ONE runtime
+   * unit" — so a second voice is a second opinion, not more coverage.
+   *
+   * It also keeps the platform's withdrawal honest. The watermark that stops
+   * a superseded runtime's answer being served is per instance, because what
+   * replaced the container is an instance-level event; with two reporters,
+   * redeploying one would withdraw the other's still-correct answer and it
+   * would never speak again.
+   */
+  conditionReporters: external_exports.array(ComponentIdSchema).min(1).max(1).optional(),
   secrets: external_exports.array(SecretWiringSchema).max(20),
   dataStores: external_exports.array(DataStoreSchema).max(8),
   egress: external_exports.array(EgressRuleSchema).max(24),
@@ -16624,6 +16680,27 @@ async function runGet(parsed) {
     const declaredNames = declared.map((entry) => entry["key"]).filter((key2) => typeof key2 === "string");
     const names = [.../* @__PURE__ */ new Set([...Object.keys(outputs), ...declaredNames])].sort();
     const isSecret2 = (name) => declared.find((entry) => entry["key"] === name)?.["secret"] === true;
+    const conditions = Array.isArray(resource["conditions"]) ? resource["conditions"] : [];
+    if (conditions.length > 0) {
+      lines.push("", "  Operational");
+      const width = Math.max(
+        ...conditions.map((one) => String(one["displayName"] ?? one["key"] ?? "").length)
+      );
+      for (const one of conditions) {
+        const label = String(one["displayName"] ?? one["key"] ?? "");
+        const state = String(one["state"] ?? "UNKNOWN");
+        const reason = one["reason"];
+        lines.push(
+          `    ${label.padEnd(width)}  ${state}${typeof reason === "string" && reason !== "" ? `  (${reason})` : ""}`
+        );
+        const description = one["description"];
+        if (typeof description === "string") {
+          for (const line of wrapOutput(description, 68)) {
+            lines.push(`    ${" ".repeat(width)}  ${line}`);
+          }
+        }
+      }
+    }
     if (names.length > 0) {
       lines.push("", "  Outputs");
       const width = Math.max(...names.map((name) => name.length));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@varde-flyt/vfac",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Deploy and manage Varde Flyt Products from a manifest.",
   "repository": {
     "type": "git",