@octaviaflow/flow-rules 0.8.0 → 0.9.0

package/dist/index.cjs

@@ -72,6 +72,7 @@ __export(exports_src, {
   collectArrayPaths: () => collectArrayPaths,
   collectArrayPathsFromSample: () => collectArrayPathsFromSample,
   configErrors: () => configErrors,
+  contractDerivedKeys: () => contractDerivedKeys,
   contractDrift: () => contractDrift,
   contractFieldsFor: () => contractFieldsFor,
   contractFor: () => contractFor,
@@ -4931,6 +4932,10 @@ function contractVocabularyDrift(actionId) {
   const known = new Set([...Object.keys(CONTRACT_TYPE_TO_FIELD_TYPE), "none"]);
   return Object.entries(c.schema).filter(([, f]) => !known.has(f.type)).map(([k, f]) => `${k}:${f.type}`);
 }
+function contractDerivedKeys(definition) {
+  const own = new Set((definition.inputSchema?.fields ?? []).map((f) => f.key));
+  return new Set(contractFieldsFor(definition).map((f) => f.key).filter((k) => !own.has(k)));
+}
 
 // src/rules/configSafety.ts
 var MAX_STEP_CONFIG_BYTES = 256 * 1024;

package/dist/index.d.ts

@@ -45,4 +45,4 @@ export { type FlowConnection, type FlowData, type FlowStep, generateConnectionsF
 export { flattenNestedWorkflow } from "./rules/flattenNestedWorkflow";
 export { configErrors, MAX_STEP_CONFIG_BYTES, validateStepConfig, validateStepConfigs, type ConfigIssue, type ConfigIssueCode, } from "./rules/configSafety";
 export { isMappingFunction, MAPPING_FUNCTION_SPECS, MAPPING_FUNCTIONS, mappingTransformFunctionName, USER_FUNCTION_PREFIX, type MappingFunction, type MappingFunctionSpec, } from "./rules/mappingFunctions";
-export { CONFIG_CONTRACTS, contractDrift, contractFieldsFor, contractVocabularyDrift, contractFor, declaredKeys, isEditorPrivateKey, type ConfigContract, type ContractField, type ContractFieldType, } from "./rules/configContracts";
+export { CONFIG_CONTRACTS, contractDerivedKeys, contractDrift, contractFieldsFor, contractVocabularyDrift, contractFor, declaredKeys, isEditorPrivateKey, type ConfigContract, type ContractField, type ContractFieldType, } from "./rules/configContracts";

package/dist/index.js

@@ -4818,6 +4818,10 @@ function contractVocabularyDrift(actionId) {
   const known = new Set([...Object.keys(CONTRACT_TYPE_TO_FIELD_TYPE), "none"]);
   return Object.entries(c.schema).filter(([, f]) => !known.has(f.type)).map(([k, f]) => `${k}:${f.type}`);
 }
+function contractDerivedKeys(definition) {
+  const own = new Set((definition.inputSchema?.fields ?? []).map((f) => f.key));
+  return new Set(contractFieldsFor(definition).map((f) => f.key).filter((k) => !own.has(k)));
+}
 
 // src/rules/configSafety.ts
 var MAX_STEP_CONFIG_BYTES = 256 * 1024;
@@ -5090,6 +5094,7 @@ export {
   collectArrayPaths,
   collectArrayPathsFromSample,
   configErrors,
+  contractDerivedKeys,
   contractDrift,
   contractFieldsFor,
   contractFor,

package/dist/rules/configContracts.d.ts

@@ -90,3 +90,16 @@ export declare function contractFieldsFor(definition: ActionDefinition): FieldCo
 export declare function contractDrift(definition: ActionDefinition): string[];
 /** Contract fields whose `type` is not in the vocabulary — a typo, not a new kind. */
 export declare function contractVocabularyDrift(actionId: string): string[];
+/**
+ * Keys `contractFieldsFor` ADDED — declared by config.ts but not by inputSchema.
+ *
+ * In 0.8.1 the fence treated a type mismatch on one of these as a WARNING,
+ * pending a measurement: the moment http_request's contract declared
+ * `queryParams: array`, a fixture storing it as an object stopped saving, and
+ * with 71 of 131 real keys previously undeclared any might have been stored in
+ * an unexpected shape. Measured 2026-09-26 against every flow on beta — 79
+ * flows, 302 steps — zero mismatches. 0.9.0 promotes them to errors, the same
+ * as any other declared key. This helper remains for tooling that wants to
+ * know which keys the contract added.
+ */
+export declare function contractDerivedKeys(definition: ActionDefinition): Set<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octaviaflow/flow-rules",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "The flow action catalog and the rules engine behind Flow Doctor \u2014 one definition of what a step accepts and what makes a flow valid, shared by the editor and the server",
   "type": "module",
   "main": "./dist/index.cjs",