@epilot/sdk 2.20.77 → 2.20.79

package/dist/{validation-rules-D4OW6VYI.js → validation-rules-Y5BLH5AA.js}

@@ -1,7 +1,7 @@
 import "./chunk-YPSWSI3M.js";
 
 // src/docs/validation-rules.json
-var validation_rules_default = '# Validation Rules API\n\n- **Base URL:** `https://validation-rules.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/validation-rules](https://docs.epilot.io/api/validation-rules)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.validationRules.getValidationRules(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/validation-rules\'\n\nconst validationRulesClient = getClient()\nauthorize(validationRulesClient, () => \'<token>\')\nconst { data } = await validationRulesClient.getValidationRules(...)\n```\n\n## Operations\n\n**Validation Rules**\n- [`getValidationRules`](#getvalidationrules)\n- [`createValidationRule`](#createvalidationrule)\n- [`getValidationRuleById`](#getvalidationrulebyid)\n- [`updateValidationRule`](#updatevalidationrule)\n- [`deleteValidationRule`](#deletevalidationrule)\n- [`addUsedByReference`](#addusedbyreference)\n- [`removeUsedByReference`](#removeusedbyreference)\n\n**Schemas**\n- [`GetValidationRulesResponse`](#getvalidationrulesresponse)\n- [`CreateValidationRuleRequest`](#createvalidationrulerequest)\n- [`UpdateValidationRuleRequest`](#updatevalidationrulerequest)\n- [`ValidationRuleBase`](#validationrulebase)\n- [`ValidationRule`](#validationrule)\n- [`UsedBy`](#usedby)\n- [`RegexRuleType`](#regexruletype)\n- [`PatternRuleType`](#patternruletype)\n- [`NumericRuleType`](#numericruletype)\n- [`RegexCondition`](#regexcondition)\n- [`RegexNestedCondition`](#regexnestedcondition)\n- [`RegexFactCondition`](#regexfactcondition)\n- [`PatternCondition`](#patterncondition)\n- [`PatternNestedCondition`](#patternnestedcondition)\n- [`PatternFactCondition`](#patternfactcondition)\n- [`NumericCondition`](#numericcondition)\n- [`NumericNestedCondition`](#numericnestedcondition)\n- [`NumericFactCondition`](#numericfactcondition)\n- [`ComparisonRuleType`](#comparisonruletype)\n- [`Condition`](#condition)\n- [`Operator`](#operator)\n- [`ConditionValue`](#conditionvalue)\n- [`ScalarValue`](#scalarvalue)\n- [`ValueReference`](#valuereference)\n- [`EnvironmentValue`](#environmentvalue)\n- [`ExternalValue`](#externalvalue)\n- [`ParameterValue`](#parametervalue)\n- [`StaticValue`](#staticvalue)\n- [`ContextValue`](#contextvalue)\n- [`ValueAdjustment`](#valueadjustment)\n- [`RelativeDateValue`](#relativedatevalue)\n- [`RangeValue`](#rangevalue)\n- [`NoValue`](#novalue)\n- [`DocumentRuleType`](#documentruletype)\n- [`DocumentCheck`](#documentcheck)\n- [`DocumentCondition`](#documentcondition)\n- [`DocumentOperator`](#documentoperator)\n- [`DocumentConditionValue`](#documentconditionvalue)\n- [`FileTypesValue`](#filetypesvalue)\n- [`CriteriaValue`](#criteriavalue)\n- [`AppliesWhen`](#applieswhen)\n- [`ContextRequirement`](#contextrequirement)\n\n### `getValidationRules`\n\nReturns all validation rules belonging to the authenticated user\'s organization.\n\n`GET /v1/validation-rules`\n\n```ts\nconst { data } = await client.getValidationRules()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "title": "string",\n      "placeholder": "string",\n      "used_by": [\n        {\n          "type": "journey",\n          "source_id": "journey-xyz789"\n        }\n      ],\n      "rule": {\n        "type": "regex",\n        "conditions": {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            },\n            {\n              "all": [\n                {\n                  "fact": "inputValue",\n                  "operator": "regexMatch",\n                  "value": "string",\n                  "params": {\n                    "errorMessage": "string"\n                  }\n                }\n              ]\n            }\n          ]\n        }\n      },\n      "contexts": [\n        {\n          "schema": "contract"\n        }\n      ],\n      "_schema_version": "string",\n      "_id": "string",\n      "_organization_id": "string",\n      "created_at": "string",\n      "updated_at": "string",\n      "created_by": "string",\n      "updated_by": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createValidationRule`\n\nCreates a new validation rule for the authenticated organization.\n\n`POST /v1/validation-rules`\n\n```ts\nconst { data } = await client.createValidationRule(\n  null,\n  {\n    title: \'string\',\n    placeholder: \'string\',\n    used_by: [\n      {\n        type: \'journey\',\n        source_id: \'journey-xyz789\'\n      }\n    ],\n    rule: {\n      type: \'regex\',\n      conditions: {\n        all: [\n          {\n            fact: \'inputValue\',\n            operator: \'regexMatch\',\n            value: \'string\',\n            params: {\n              errorMessage: \'string\'\n            }\n          },\n          {\n            all: [\n              {\n                fact: \'inputValue\',\n                operator: \'regexMatch\',\n                value: \'string\',\n                params: {\n                  errorMessage: \'string\'\n                }\n              }\n            ]\n          }\n        ]\n      }\n    },\n    contexts: [\n      {\n        schema: \'contract\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `getValidationRuleById`\n\nRetrieves a specific validation rule by its unique ID.\n\n`GET /v1/validation-rules/{ruleId}`\n\n```ts\nconst { data } = await client.getValidationRuleById({\n  ruleId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `updateValidationRule`\n\nPartially updates an existing validation rule by ID. Only the fields provided in the request body are updated.\n\n`PATCH /v1/validation-rules/{ruleId}`\n\n```ts\nconst { data } = await client.updateValidationRule(\n  {\n    ruleId: \'example\',\n  },\n  {\n    title: \'string\',\n    placeholder: \'string\',\n    used_by: [\n      {\n        type: \'journey\',\n        source_id: \'journey-xyz789\'\n      }\n    ],\n    rule: {\n      type: \'regex\',\n      conditions: {\n        all: [\n          {\n            fact: \'inputValue\',\n            operator: \'regexMatch\',\n            value: \'string\',\n            params: {\n              errorMessage: \'string\'\n            }\n          },\n          {\n            all: [\n              {\n                fact: \'inputValue\',\n                operator: \'regexMatch\',\n                value: \'string\',\n                params: {\n                  errorMessage: \'string\'\n                }\n              }\n            ]\n          }\n        ]\n      }\n    },\n    contexts: [\n      {\n        schema: \'contract\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `deleteValidationRule`\n\nPermanently deletes a validation rule by ID. Any journeys or entity attributes referencing this rule should be updated before deletion.\n\n`DELETE /v1/validation-rules/{ruleId}`\n\n```ts\nconst { data } = await client.deleteValidationRule({\n  ruleId: \'example\',\n})\n```\n\n---\n\n### `addUsedByReference`\n\nAdds a single `used_by` reference to an existing validation rule.\n\n`POST /v1/validation-rules/{ruleId}/used-by`\n\n```ts\nconst { data } = await client.addUsedByReference(\n  {\n    ruleId: \'example\',\n  },\n  {\n    type: \'journey\',\n    source_id: \'journey-xyz789\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `removeUsedByReference`\n\nRemoves a specific `used_by` reference from an existing validation rule.\n\n`DELETE /v1/validation-rules/{ruleId}/used-by`\n\n```ts\nconst { data } = await client.removeUsedByReference(\n  {\n    ruleId: \'example\',\n  },\n  {\n    type: \'journey\',\n    source_id: \'journey-xyz789\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `GetValidationRulesResponse`\n\nResponse envelope for listing all validation rules within an organization.\n\n```ts\ntype GetValidationRulesResponse = {\n  results?: Array<{\n    _schema_version: string\n    _id: string\n    _organization_id: string\n    created_at: string\n    updated_at: string\n    created_by: string\n    updated_by: string\n  }>\n}\n```\n\n### `CreateValidationRuleRequest`\n\n```ts\ntype CreateValidationRuleRequest = object\n```\n\n### `UpdateValidationRuleRequest`\n\n```ts\ntype UpdateValidationRuleRequest = {\n  title?: string\n  placeholder?: string\n  used_by?: Array<{\n    type: "journey" | "entity"\n    schema_slug?: string\n    source_id?: string\n  }>\n  rule?: {\n    type: "regex"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    type: "pattern"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    type: "numeric"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    input_type: "number" | "date" | "text"\n    conditions: Array<{\n      id: { ... }\n      operator: { ... }\n      value: { ... }\n      error_message: { ... }\n      applies_when?: { ... }\n      allow_failure?: { ... }\n    }>\n  } | {\n    input_type: "document"\n    check: {\n      level: { ... }\n    }\n    conditions: Array<{\n      id: { ... }\n      operator: { ... }\n      value: { ... }\n      error_message: { ... }\n      allow_failure?: { ... }\n    }>\n  }\n  contexts?: Array<{\n    schema: string\n  }>\n}\n```\n\n### `ValidationRuleBase`\n\n```ts\ntype ValidationRuleBase = {\n  title?: string\n  placeholder?: string\n  used_by?: Array<{\n    type: "journey" | "entity"\n    schema_slug?: string\n    source_id?: string\n  }>\n  rule?: {\n    type: "regex"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    type: "pattern"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    type: "numeric"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    input_type: "number" | "date" | "text"\n    conditions: Array<{\n      id: { ... }\n      operator: { ... }\n      value: { ... }\n      error_message: { ... }\n      applies_when?: { ... }\n      allow_failure?: { ... }\n    }>\n  } | {\n    input_type: "document"\n    check: {\n      level: { ... }\n    }\n    conditions: Array<{\n      id: { ... }\n      operator: { ... }\n      value: { ... }\n      error_message: { ... }\n      allow_failure?: { ... }\n    }>\n  }\n  contexts?: Array<{\n    schema: string\n  }>\n}\n```\n\n### `ValidationRule`\n\nThe Validation rule definition.\n\n```ts\ntype ValidationRule = {\n  _schema_version: string\n  _id: string\n  _organization_id: string\n  created_at: string\n  updated_at: string\n  created_by: string\n  updated_by: string\n}\n```\n\n### `UsedBy`\n\nDescribes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.\n\n```ts\ntype UsedBy = {\n  type: "journey" | "entity"\n  schema_slug?: string\n  source_id?: string\n}\n```\n\n### `RegexRuleType`\n\nValidation rule that uses a regular expression to validate input.\n\n```ts\ntype RegexRuleType = {\n  type: "regex"\n  conditions: {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  }\n}\n```\n\n### `PatternRuleType`\n\nValidation rule that uses a sequence of patterns to validate input.\n\n```ts\ntype PatternRuleType = {\n  type: "pattern"\n  conditions: {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  }\n}\n```\n\n### `NumericRuleType`\n\nValidation rule for numeric values, supporting range and digit count constraints.\n\n```ts\ntype NumericRuleType = {\n  type: "numeric"\n  conditions: {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  }\n}\n```\n\n### `RegexCondition`\n\nCondition definition for a regex-based validation rule (2 levels deep)\n\n```ts\ntype RegexCondition = {\n  all: Array<{\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }\n  }>\n} | {\n  not: {\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }\n  }\n}\n```\n\n### `RegexNestedCondition`\n\nNested condition with logical operators (level 2 only)\n\n```ts\ntype RegexNestedCondition = {\n  all: Array<{\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  }>\n} | {\n  not: {\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  }\n}\n```\n\n### `RegexFactCondition`\n\nFact-based condition for regex validation\n\n```ts\ntype RegexFactCondition = {\n  fact: "inputValue"\n  operator: "regexMatch"\n  value: string\n  params?: {\n    errorMessage?: string\n  }\n}\n```\n\n### `PatternCondition`\n\nCondition definition for a pattern-based validation rule (2 levels deep)\n\n```ts\ntype PatternCondition = {\n  all: Array<{\n    fact: "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check" | "total-length"\n    operator: "exactlyNDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "in" | "notIn" | "contains" | "doesNotContain"\n    value: string[]\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "equal" | "notEqual"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n  // ...\n}\n```\n\n### `PatternNestedCondition`\n\nNested condition with logical operators (level 2 only)\n\n```ts\ntype PatternNestedCondition = {\n  all: Array<{\n    fact: "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check" | "total-length"\n    operator: "exactlyNDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "in" | "notIn" | "contains" | "doesNotContain"\n    value: string[]\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "equal" | "notEqual"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check" | "total-length"\n    operator: "exactlyNDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "in" | "notIn" | "contains" | "doesNotContain"\n    value: string[]\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "equal" | "notEqual"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  }>\n} | {\n  not: {\n    fact: "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check" | "total-length"\n    operator: "exactlyNDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "in" | "notIn" | "contains" | "doesNotContain"\n    value: string[]\n    params?: {\n  // ...\n}\n```\n\n### `PatternFactCondition`\n\nFact-based condition for pattern validation\n\n```ts\ntype PatternFactCondition = {\n  fact: "total-length"\n  operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n  value: number\n  params?: {\n    errorMessage?: string\n    start?: number\n    end?: number\n  }\n} | {\n  fact: "static-check" | "total-length"\n  operator: "exactlyNDigits"\n  value: number\n  params?: {\n    errorMessage?: string\n    start?: number\n    end?: number\n  }\n} | {\n  fact: "static-check"\n  operator: "in" | "notIn" | "contains" | "doesNotContain"\n  value: string[]\n  params?: {\n    errorMessage?: string\n    start?: number\n    end?: number\n  }\n} | {\n  fact: "static-check"\n  operator: "equal" | "notEqual"\n  value: string\n  params?: {\n    errorMessage?: string\n    start?: number\n    end?: number\n  }\n}\n```\n\n### `NumericCondition`\n\nCondition definition for a numeric-based validation rule (2 levels deep)\n\n```ts\ntype NumericCondition = {\n  all: Array<{\n    fact: "numeric-value" | "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "integer-digits-count"\n    operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      allowLeadingZeroes?: { ... }\n    }\n  } | {\n    fact: "decimal-digits-count"\n    operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "has-leading-zeroes"\n    operator: "equal" | "notAllowed"\n    value: boolean\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "numeric-value" | "total-length"\n  // ...\n}\n```\n\n### `NumericNestedCondition`\n\nNested condition with logical operators (level 2 only)\n\n```ts\ntype NumericNestedCondition = {\n  all: Array<{\n    fact: "numeric-value" | "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "integer-digits-count"\n    operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      allowLeadingZeroes?: { ... }\n    }\n  } | {\n    fact: "decimal-digits-count"\n    operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "has-leading-zeroes"\n    operator: "equal" | "notAllowed"\n    value: boolean\n    params?: {\n      errorMessage?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "numeric-value" | "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "integer-digits-count"\n    operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      allowLeadingZeroes?: { ... }\n    }\n  } | {\n    fact: "decimal-digits-count"\n    operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "has-leading-zeroes"\n    operator: "equal" | "notAllowed"\n    value: boolean\n    params?: {\n      errorMessage?: { ... }\n    }\n  }>\n} | {\n  not: {\n    fact: "numeric-value" | "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "integer-digits-count"\n    operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      allowLeadingZeroes?: { ... }\n    }\n  } | {\n    fact: "decimal-digits-count"\n    operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "has-leading-zeroes"\n    operator: "equal" | "notAllowed"\n    value: boolean\n    params?: {\n      errorMessage?: { ... }\n    }\n  }\n}\n```\n\n### `NumericFactCondition`\n\nFact-based condition for numeric validation\n\n```ts\ntype NumericFactCondition = {\n  fact: "numeric-value" | "total-length"\n  operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n  value: number\n  params?: {\n    errorMessage?: string\n  }\n} | {\n  fact: "integer-digits-count"\n  operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n  value: number\n  params?: {\n    errorMessage?: string\n    allowLeadingZeroes?: boolean\n  }\n} | {\n  fact: "decimal-digits-count"\n  operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n  value: number\n  params?: {\n    errorMessage?: string\n  }\n} | {\n  fact: "has-leading-zeroes"\n  operator: "equal" | "notAllowed"\n  value: boolean\n  params?: {\n    errorMessage?: string\n  }\n}\n```\n\n### `ComparisonRuleType`\n\nDeclarative validation rule (schema version v2). Supports predefined comparison operators\nover number, date and text inputs, with static, dynamic (context path), relative-date and\nexternal (app-provided) comparison values.\n\n\n```ts\ntype ComparisonRuleType = {\n  input_type: "number" | "date" | "text"\n  conditions: Array<{\n    id: string\n    operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "between" | "dateBefore" | "dateOnOrBefore" | "dateAfter" | "dateOnOrAfter" | "dateBetween" | "notInFuture" | "notInPast" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "regexMatch" | "lengthBetween" | "maxDigits" | "maxDecimals"\n    value: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      offset: { ... }\n      unit: { ... }\n      anchor?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      min: { ... }\n      max: { ... }\n    } | {\n      source: { ... }\n    }\n    error_message: string\n    applies_when?: {\n      path: { ... }\n      operator: { ... }\n      value?: { ... }\n    }\n    allow_failure?: boolean\n  }>\n}\n```\n\n### `Condition`\n\nA single comparison the input value must satisfy.\n\n```ts\ntype Condition = {\n  id: string\n  operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "between" | "dateBefore" | "dateOnOrBefore" | "dateAfter" | "dateOnOrAfter" | "dateBetween" | "notInFuture" | "notInPast" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "regexMatch" | "lengthBetween" | "maxDigits" | "maxDecimals"\n  value: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "relative_date"\n    offset: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    unit: "days" | "months" | "years"\n    anchor?: "today" | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "range"\n    min: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      offset: { ... }\n      unit: { ... }\n      anchor?: { ... }\n    } | {\n  // ...\n}\n```\n\n### `Operator`\n\nPredefined comparison operator. Compatibility (enforced at write time):\n- number: equal, notEqual, greaterThan, greaterThanInclusive, lessThan, lessThanInclusive, between, regexMatch,\n  maxDigits, maxDecimals\n- date: dateBefore, dateOnOrBefore, dateAfter, dateOnOrAfter, dateBetween, notInFuture, not\n\n```ts\ntype Operator = "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "between" | "dateBefore" | "dateOnOrBefore" | "dateAfter" | "dateOnOrAfter" | "dateBetween" | "notInFuture" | "notInPast" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "regexMatch" | "lengthBetween" | "maxDigits" | "maxDecimals"\n```\n\n### `ConditionValue`\n\nThe comparison value of a condition - a scalar, a range of scalars, or nothing (unary operators).\n\n```ts\ntype ConditionValue = {\n  source: "static"\n  data: number | string | boolean\n} | {\n  source: "context"\n  path: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "relative_date"\n  offset: number | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  unit: "days" | "months" | "years"\n  anchor?: "today" | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n  // ...\n}\n```\n\n### `ScalarValue`\n\nA single comparison value - static, resolved from context, a relative date, an organisation environment variable, an external value, or a parameter the consuming surface supplies.\n\n```ts\ntype ScalarValue = {\n  source: "static"\n  data: number | string | boolean\n} | {\n  source: "context"\n  path: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "relative_date"\n  offset: number | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  unit: "days" | "months" | "years"\n  anchor?: "today" | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n  // ...\n}\n```\n\n### `ValueReference`\n\nA value resolved at evaluation time instead of written into the rule, identified by\n`source`. Each field that accepts a reference lists the sources it allows; a rule using\nany other source is rejected when it is saved.\n\n\n```ts\ntype ValueReference = {\n  source: "context"\n  path: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "environment"\n  key: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "external"\n  app_id: string\n  hook_id: string\n  result_id: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "parameter"\n  name: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n  // ...\n}\n```\n\n### `EnvironmentValue`\n\nA comparison value resolved at evaluation time from an organisation environment variable\n(environments-api). The rule stores the key, never the value, so one change to the variable\nreaches every rule that references it and a blueprint install never overwrites the\norganisation\'s own value.\n\nOnly brow\n\n```ts\ntype EnvironmentValue = {\n  source: "environment"\n  key: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n}\n```\n\n### `ExternalValue`\n\nA comparison value produced at evaluation time by an External Values hook of an installed\napp (component type `EXTERNAL_VALUES`). The rule stores the reference only; the value is\nresolved server-side by the external-values-api, which executes the hook\'s HTTP call with\nthe app\'s credentials and retur\n\n```ts\ntype ExternalValue = {\n  source: "external"\n  app_id: string\n  hook_id: string\n  result_id: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n}\n```\n\n### `ParameterValue`\n\nA comparison value supplied by the surface that evaluates the rule, identified by a name\nthe rule chooses (e.g. `start_date`). The rule stores the name only. The consuming surface\nbinds the name to a source of its own - a journey binds it to the value of another block -\nand resolves it at evaluation\n\n```ts\ntype ParameterValue = {\n  source: "parameter"\n  name: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n}\n```\n\n### `StaticValue`\n\nA fixed comparison value.\n\n```ts\ntype StaticValue = {\n  source: "static"\n  data: number | string | boolean\n}\n```\n\n### `ContextValue`\n\nA dynamic comparison value resolved from runtime context, e.g. `contract.installment_amount`\nor `previous_reading.value`. The first path segment must match the `name` of a declared\ncontext requirement.\n\n\n```ts\ntype ContextValue = {\n  source: "context"\n  path: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n}\n```\n\n### `ValueAdjustment`\n\nAdjusts a context-resolved numeric value before comparison, e.g. "context value plus 10 percent".\nUsed to express tolerance bands such as "at most 10% above the current instalment amount".\n\n\n```ts\ntype ValueAdjustment = {\n  type: "percent" | "absolute"\n  value: number | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  direction: "increase" | "decrease"\n  rounding?: "up" | "down"\n}\n```\n\n### `RelativeDateValue`\n\nA date relative to the evaluation moment, e.g. "today minus 30 days". Only valid for date rules.\n\n```ts\ntype RelativeDateValue = {\n  source: "relative_date"\n  offset: number | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  unit: "days" | "months" | "years"\n  anchor?: "today" | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n}\n```\n\n### `RangeValue`\n\nA lower and upper bound for range operators (between, dateBetween, lengthBetween). Bounds are inclusive.\n\n```ts\ntype RangeValue = {\n  source: "range"\n  min: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "relative_date"\n    offset: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    unit: "days" | "months" | "years"\n    anchor?: "today" | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  max: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "relative_date"\n    offset: number | {\n  // ...\n}\n```\n\n### `NoValue`\n\nNo comparison value - used by unary operators such as notInFuture / notInPast.\n\n```ts\ntype NoValue = {\n  source: "none"\n}\n```\n\n### `DocumentRuleType`\n\nDeclarative validation rule (schema version v2) for uploaded files. The rule declares how deep\nthe check goes (`check.level`) and the conditions the file must satisfy. Property conditions\n(file type, size, page count, image resolution, blank and password-protected detection) are\ndeterministic and av\n\n```ts\ntype DocumentRuleType = {\n  input_type: "document"\n  check: {\n    level: "basic" | "standard" | "advanced"\n  }\n  conditions: Array<{\n    id: string\n    operator: "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"\n    value: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      min: { ... }\n      max: { ... }\n    } | {\n      source: { ... }\n    } | {\n      source: { ... }\n      types: { ... }\n    } | {\n      source: { ... }\n      text: { ... }\n    }\n    error_message: string\n    allow_failure?: boolean\n  }>\n}\n```\n\n### `DocumentCheck`\n\nHow deep the document check goes. Levels are cumulative.\n\n```ts\ntype DocumentCheck = {\n  level: "basic" | "standard" | "advanced"\n}\n```\n\n### `DocumentCondition`\n\nA single check the uploaded file must satisfy.\n\n```ts\ntype DocumentCondition = {\n  id: string\n  operator: "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"\n  value: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "range"\n    min: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      offset: { ... }\n      unit: { ... }\n      anchor?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    max: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      offset: { ... }\n      unit: { ... }\n      anchor?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n  } | {\n    source: "none"\n  } | {\n    source: "file_types"\n    types: "image" | "pdf" | "document" | "spreadsheet"[]\n  } | {\n    source: "criteria"\n    text: string\n  }\n  error_message: string\n  allow_failure?: boolean\n}\n```\n\n### `DocumentOperator`\n\nPredefined document check. Value compatibility (enforced at write time):\n- fileTypeIn: `file_types` value listing the accepted file categories.\n- sizeBelow: static integer, maximum file size in bytes.\n- pageCountBetween: `range` of static non-negative integers (inclusive).\n- resolutionAtLeast / reso\n\n```ts\ntype DocumentOperator = "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"\n```\n\n### `DocumentConditionValue`\n\nThe value of a document condition - a static scalar, a range, nothing, accepted file categories, or a free-text criterion.\n\n```ts\ntype DocumentConditionValue = {\n  source: "static"\n  data: number | string | boolean\n} | {\n  source: "range"\n  min: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "relative_date"\n    offset: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    unit: "days" | "months" | "years"\n    anchor?: "today" | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  max: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  // ...\n}\n```\n\n### `FileTypesValue`\n\nAccepted file categories; each category expands to a mime list at check time.\n\n```ts\ntype FileTypesValue = {\n  source: "file_types"\n  types: "image" | "pdf" | "document" | "spreadsheet"[]\n}\n```\n\n### `CriteriaValue`\n\nA free-text requirement judged against the document\'s extracted content, e.g. "The photo shows\nan electricity meter with the meter number and the current reading fully legible." One requirement\nper condition keeps results specific and lets each requirement be graded separately.\n\n\n```ts\ntype CriteriaValue = {\n  source: "criteria"\n  text: string\n}\n```\n\n### `AppliesWhen`\n\nOptional precondition on a condition: the condition only takes part in the\nvalidation when this comparison over context holds. Examples: apply the\ndual-tariff reference only when `contract.htnt` is not empty, or run a\nplausibility check only when a context value reaches a threshold.\n\n\n```ts\ntype AppliesWhen = {\n  path: string\n  operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty"\n  value?: number | string | boolean | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n}\n```\n\n### `ContextRequirement`\n\nAn entity context source the rule needs at evaluation time, referenced by `context`\nvalue paths via the schema slug as their first segment (e.g. `contract.installment_amount`).\nHow the source is resolved (which entity instance) is decided by the consuming surface,\nnot by the rule. Meter reading comp\n\n```ts\ntype ContextRequirement = {\n  schema: string\n}\n```\n';
+var validation_rules_default = '# Validation Rules API\n\n- **Base URL:** `https://validation-rules.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/validation-rules](https://docs.epilot.io/api/validation-rules)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.validationRules.getValidationRules(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/validation-rules\'\n\nconst validationRulesClient = getClient()\nauthorize(validationRulesClient, () => \'<token>\')\nconst { data } = await validationRulesClient.getValidationRules(...)\n```\n\n## Operations\n\n**Validation Rules**\n- [`getValidationRules`](#getvalidationrules)\n- [`createValidationRule`](#createvalidationrule)\n- [`getValidationRuleById`](#getvalidationrulebyid)\n- [`updateValidationRule`](#updatevalidationrule)\n- [`deleteValidationRule`](#deletevalidationrule)\n- [`addUsedByReference`](#addusedbyreference)\n- [`removeUsedByReference`](#removeusedbyreference)\n\n**Schemas**\n- [`GetValidationRulesResponse`](#getvalidationrulesresponse)\n- [`CreateValidationRuleRequest`](#createvalidationrulerequest)\n- [`UpdateValidationRuleRequest`](#updatevalidationrulerequest)\n- [`ValidationRuleBase`](#validationrulebase)\n- [`ValidationRule`](#validationrule)\n- [`UsedBy`](#usedby)\n- [`RegexRuleType`](#regexruletype)\n- [`PatternRuleType`](#patternruletype)\n- [`NumericRuleType`](#numericruletype)\n- [`RegexCondition`](#regexcondition)\n- [`RegexNestedCondition`](#regexnestedcondition)\n- [`RegexFactCondition`](#regexfactcondition)\n- [`PatternCondition`](#patterncondition)\n- [`PatternNestedCondition`](#patternnestedcondition)\n- [`PatternFactCondition`](#patternfactcondition)\n- [`NumericCondition`](#numericcondition)\n- [`NumericNestedCondition`](#numericnestedcondition)\n- [`NumericFactCondition`](#numericfactcondition)\n- [`ComparisonRuleType`](#comparisonruletype)\n- [`Condition`](#condition)\n- [`Operator`](#operator)\n- [`ConditionValue`](#conditionvalue)\n- [`ScalarValue`](#scalarvalue)\n- [`ValueReference`](#valuereference)\n- [`EnvironmentValue`](#environmentvalue)\n- [`ExternalValue`](#externalvalue)\n- [`ParameterValue`](#parametervalue)\n- [`StaticValue`](#staticvalue)\n- [`ContextValue`](#contextvalue)\n- [`ValueAdjustment`](#valueadjustment)\n- [`RelativeDateValue`](#relativedatevalue)\n- [`RangeValue`](#rangevalue)\n- [`NoValue`](#novalue)\n- [`DocumentRuleType`](#documentruletype)\n- [`DocumentCheck`](#documentcheck)\n- [`DocumentCondition`](#documentcondition)\n- [`DocumentOperator`](#documentoperator)\n- [`DocumentConditionValue`](#documentconditionvalue)\n- [`FileTypesValue`](#filetypesvalue)\n- [`CriteriaValue`](#criteriavalue)\n- [`AppliesWhen`](#applieswhen)\n- [`ContextRequirement`](#contextrequirement)\n\n### `getValidationRules`\n\nReturns all validation rules belonging to the authenticated user\'s organization.\n\n`GET /v1/validation-rules`\n\n```ts\nconst { data } = await client.getValidationRules()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "title": "string",\n      "placeholder": "string",\n      "used_by": [\n        {\n          "type": "journey",\n          "source_id": "journey-xyz789"\n        }\n      ],\n      "rule": {\n        "type": "regex",\n        "conditions": {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            },\n            {\n              "all": [\n                {\n                  "fact": "inputValue",\n                  "operator": "regexMatch",\n                  "value": "string",\n                  "params": {\n                    "errorMessage": "string"\n                  }\n                }\n              ]\n            }\n          ]\n        }\n      },\n      "contexts": [\n        {\n          "schema": "contract"\n        }\n      ],\n      "_schema_version": "string",\n      "_id": "string",\n      "_organization_id": "string",\n      "created_at": "string",\n      "updated_at": "string",\n      "created_by": "string",\n      "updated_by": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createValidationRule`\n\nCreates a new validation rule for the authenticated organization.\n\n`POST /v1/validation-rules`\n\n```ts\nconst { data } = await client.createValidationRule(\n  null,\n  {\n    title: \'string\',\n    placeholder: \'string\',\n    used_by: [\n      {\n        type: \'journey\',\n        source_id: \'journey-xyz789\'\n      }\n    ],\n    rule: {\n      type: \'regex\',\n      conditions: {\n        all: [\n          {\n            fact: \'inputValue\',\n            operator: \'regexMatch\',\n            value: \'string\',\n            params: {\n              errorMessage: \'string\'\n            }\n          },\n          {\n            all: [\n              {\n                fact: \'inputValue\',\n                operator: \'regexMatch\',\n                value: \'string\',\n                params: {\n                  errorMessage: \'string\'\n                }\n              }\n            ]\n          }\n        ]\n      }\n    },\n    contexts: [\n      {\n        schema: \'contract\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `getValidationRuleById`\n\nRetrieves a specific validation rule by its unique ID.\n\n`GET /v1/validation-rules/{ruleId}`\n\n```ts\nconst { data } = await client.getValidationRuleById({\n  ruleId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `updateValidationRule`\n\nPartially updates an existing validation rule by ID. Only the fields provided in the request body are updated.\n\n`PATCH /v1/validation-rules/{ruleId}`\n\n```ts\nconst { data } = await client.updateValidationRule(\n  {\n    ruleId: \'example\',\n  },\n  {\n    title: \'string\',\n    placeholder: \'string\',\n    used_by: [\n      {\n        type: \'journey\',\n        source_id: \'journey-xyz789\'\n      }\n    ],\n    rule: {\n      type: \'regex\',\n      conditions: {\n        all: [\n          {\n            fact: \'inputValue\',\n            operator: \'regexMatch\',\n            value: \'string\',\n            params: {\n              errorMessage: \'string\'\n            }\n          },\n          {\n            all: [\n              {\n                fact: \'inputValue\',\n                operator: \'regexMatch\',\n                value: \'string\',\n                params: {\n                  errorMessage: \'string\'\n                }\n              }\n            ]\n          }\n        ]\n      }\n    },\n    contexts: [\n      {\n        schema: \'contract\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `deleteValidationRule`\n\nPermanently deletes a validation rule by ID. Any journeys or entity attributes referencing this rule should be updated before deletion.\n\n`DELETE /v1/validation-rules/{ruleId}`\n\n```ts\nconst { data } = await client.deleteValidationRule({\n  ruleId: \'example\',\n})\n```\n\n---\n\n### `addUsedByReference`\n\nAdds a single `used_by` reference to an existing validation rule.\n\n`POST /v1/validation-rules/{ruleId}/used-by`\n\n```ts\nconst { data } = await client.addUsedByReference(\n  {\n    ruleId: \'example\',\n  },\n  {\n    type: \'journey\',\n    source_id: \'journey-xyz789\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n### `removeUsedByReference`\n\nRemoves a specific `used_by` reference from an existing validation rule.\n\n`DELETE /v1/validation-rules/{ruleId}/used-by`\n\n```ts\nconst { data } = await client.removeUsedByReference(\n  {\n    ruleId: \'example\',\n  },\n  {\n    type: \'journey\',\n    source_id: \'journey-xyz789\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "title": "string",\n  "placeholder": "string",\n  "used_by": [\n    {\n      "type": "journey",\n      "source_id": "journey-xyz789"\n    }\n  ],\n  "rule": {\n    "type": "regex",\n    "conditions": {\n      "all": [\n        {\n          "fact": "inputValue",\n          "operator": "regexMatch",\n          "value": "string",\n          "params": {\n            "errorMessage": "string"\n          }\n        },\n        {\n          "all": [\n            {\n              "fact": "inputValue",\n              "operator": "regexMatch",\n              "value": "string",\n              "params": {\n                "errorMessage": "string"\n              }\n            }\n          ]\n        }\n      ]\n    }\n  },\n  "contexts": [\n    {\n      "schema": "contract"\n    }\n  ],\n  "_schema_version": "string",\n  "_id": "string",\n  "_organization_id": "string",\n  "created_at": "string",\n  "updated_at": "string",\n  "created_by": "string",\n  "updated_by": "string"\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `GetValidationRulesResponse`\n\nResponse envelope for listing all validation rules within an organization.\n\n```ts\ntype GetValidationRulesResponse = {\n  results?: Array<{\n    _schema_version: string\n    _id: string\n    _organization_id: string\n    created_at: string\n    updated_at: string\n    created_by: string\n    updated_by: string\n  }>\n}\n```\n\n### `CreateValidationRuleRequest`\n\n```ts\ntype CreateValidationRuleRequest = object\n```\n\n### `UpdateValidationRuleRequest`\n\n```ts\ntype UpdateValidationRuleRequest = {\n  title?: string\n  placeholder?: string\n  used_by?: Array<{\n    type: "journey" | "entity"\n    schema_slug?: string\n    source_id?: string\n  }>\n  rule?: {\n    type: "regex"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    type: "pattern"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    type: "numeric"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    input_type: "number" | "date" | "text"\n    conditions: Array<{\n      id: { ... }\n      operator: { ... }\n      value: { ... }\n      error_message: { ... }\n      applies_when?: { ... }\n      allow_failure?: { ... }\n    }>\n  } | {\n    input_type: "document"\n    check: {\n      level: { ... }\n    }\n    conditions: Array<{\n      id: { ... }\n      operator: { ... }\n      value: { ... }\n      error_message: { ... }\n      allow_failure?: { ... }\n    }>\n  }\n  contexts?: Array<{\n    schema: string\n  }>\n}\n```\n\n### `ValidationRuleBase`\n\n```ts\ntype ValidationRuleBase = {\n  title?: string\n  placeholder?: string\n  used_by?: Array<{\n    type: "journey" | "entity"\n    schema_slug?: string\n    source_id?: string\n  }>\n  rule?: {\n    type: "regex"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    type: "pattern"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    type: "numeric"\n    conditions: {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  } | {\n    input_type: "number" | "date" | "text"\n    conditions: Array<{\n      id: { ... }\n      operator: { ... }\n      value: { ... }\n      error_message: { ... }\n      applies_when?: { ... }\n      allow_failure?: { ... }\n    }>\n  } | {\n    input_type: "document"\n    check: {\n      level: { ... }\n    }\n    conditions: Array<{\n      id: { ... }\n      operator: { ... }\n      value: { ... }\n      error_message: { ... }\n      allow_failure?: { ... }\n    }>\n  }\n  contexts?: Array<{\n    schema: string\n  }>\n}\n```\n\n### `ValidationRule`\n\nThe Validation rule definition.\n\n```ts\ntype ValidationRule = {\n  _schema_version: string\n  _id: string\n  _organization_id: string\n  created_at: string\n  updated_at: string\n  created_by: string\n  updated_by: string\n}\n```\n\n### `UsedBy`\n\nDescribes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.\n\n```ts\ntype UsedBy = {\n  type: "journey" | "entity"\n  schema_slug?: string\n  source_id?: string\n}\n```\n\n### `RegexRuleType`\n\nValidation rule that uses a regular expression to validate input.\n\n```ts\ntype RegexRuleType = {\n  type: "regex"\n  conditions: {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  }\n}\n```\n\n### `PatternRuleType`\n\nValidation rule that uses a sequence of patterns to validate input.\n\n```ts\ntype PatternRuleType = {\n  type: "pattern"\n  conditions: {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  }\n}\n```\n\n### `NumericRuleType`\n\nValidation rule for numeric values, supporting range and digit count constraints.\n\n```ts\ntype NumericRuleType = {\n  type: "numeric"\n  conditions: {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      all: { ... }\n    } | {\n      any: { ... }\n    } | {\n      not: { ... }\n    }\n  }\n}\n```\n\n### `RegexCondition`\n\nCondition definition for a regex-based validation rule (2 levels deep)\n\n```ts\ntype RegexCondition = {\n  all: Array<{\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }\n  }>\n} | {\n  not: {\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }\n  }\n}\n```\n\n### `RegexNestedCondition`\n\nNested condition with logical operators (level 2 only)\n\n```ts\ntype RegexNestedCondition = {\n  all: Array<{\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  }>\n} | {\n  not: {\n    fact: "inputValue"\n    operator: "regexMatch"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n    }\n  }\n}\n```\n\n### `RegexFactCondition`\n\nFact-based condition for regex validation\n\n```ts\ntype RegexFactCondition = {\n  fact: "inputValue"\n  operator: "regexMatch"\n  value: string\n  params?: {\n    errorMessage?: string\n  }\n}\n```\n\n### `PatternCondition`\n\nCondition definition for a pattern-based validation rule (2 levels deep)\n\n```ts\ntype PatternCondition = {\n  all: Array<{\n    fact: "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check" | "total-length"\n    operator: "exactlyNDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "in" | "notIn" | "contains" | "doesNotContain"\n    value: string[]\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "equal" | "notEqual"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n  // ...\n}\n```\n\n### `PatternNestedCondition`\n\nNested condition with logical operators (level 2 only)\n\n```ts\ntype PatternNestedCondition = {\n  all: Array<{\n    fact: "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check" | "total-length"\n    operator: "exactlyNDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "in" | "notIn" | "contains" | "doesNotContain"\n    value: string[]\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "equal" | "notEqual"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check" | "total-length"\n    operator: "exactlyNDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "in" | "notIn" | "contains" | "doesNotContain"\n    value: string[]\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "equal" | "notEqual"\n    value: string\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  }>\n} | {\n  not: {\n    fact: "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check" | "total-length"\n    operator: "exactlyNDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      start?: { ... }\n      end?: { ... }\n    }\n  } | {\n    fact: "static-check"\n    operator: "in" | "notIn" | "contains" | "doesNotContain"\n    value: string[]\n    params?: {\n  // ...\n}\n```\n\n### `PatternFactCondition`\n\nFact-based condition for pattern validation\n\n```ts\ntype PatternFactCondition = {\n  fact: "total-length"\n  operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n  value: number\n  params?: {\n    errorMessage?: string\n    start?: number\n    end?: number\n  }\n} | {\n  fact: "static-check" | "total-length"\n  operator: "exactlyNDigits"\n  value: number\n  params?: {\n    errorMessage?: string\n    start?: number\n    end?: number\n  }\n} | {\n  fact: "static-check"\n  operator: "in" | "notIn" | "contains" | "doesNotContain"\n  value: string[]\n  params?: {\n    errorMessage?: string\n    start?: number\n    end?: number\n  }\n} | {\n  fact: "static-check"\n  operator: "equal" | "notEqual"\n  value: string\n  params?: {\n    errorMessage?: string\n    start?: number\n    end?: number\n  }\n}\n```\n\n### `NumericCondition`\n\nCondition definition for a numeric-based validation rule (2 levels deep)\n\n```ts\ntype NumericCondition = {\n  all: Array<{\n    fact: "numeric-value" | "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "integer-digits-count"\n    operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      allowLeadingZeroes?: { ... }\n    }\n  } | {\n    fact: "decimal-digits-count"\n    operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "has-leading-zeroes"\n    operator: "equal" | "notAllowed"\n    value: boolean\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    all: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    any: Array<{\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }>\n  } | {\n    not: {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    } | {\n      fact: { ... }\n      operator: { ... }\n      value: { ... }\n      params?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "numeric-value" | "total-length"\n  // ...\n}\n```\n\n### `NumericNestedCondition`\n\nNested condition with logical operators (level 2 only)\n\n```ts\ntype NumericNestedCondition = {\n  all: Array<{\n    fact: "numeric-value" | "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "integer-digits-count"\n    operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      allowLeadingZeroes?: { ... }\n    }\n  } | {\n    fact: "decimal-digits-count"\n    operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "has-leading-zeroes"\n    operator: "equal" | "notAllowed"\n    value: boolean\n    params?: {\n      errorMessage?: { ... }\n    }\n  }>\n} | {\n  any: Array<{\n    fact: "numeric-value" | "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "integer-digits-count"\n    operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      allowLeadingZeroes?: { ... }\n    }\n  } | {\n    fact: "decimal-digits-count"\n    operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "has-leading-zeroes"\n    operator: "equal" | "notAllowed"\n    value: boolean\n    params?: {\n      errorMessage?: { ... }\n    }\n  }>\n} | {\n  not: {\n    fact: "numeric-value" | "total-length"\n    operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "integer-digits-count"\n    operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n      allowLeadingZeroes?: { ... }\n    }\n  } | {\n    fact: "decimal-digits-count"\n    operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n    value: number\n    params?: {\n      errorMessage?: { ... }\n    }\n  } | {\n    fact: "has-leading-zeroes"\n    operator: "equal" | "notAllowed"\n    value: boolean\n    params?: {\n      errorMessage?: { ... }\n    }\n  }\n}\n```\n\n### `NumericFactCondition`\n\nFact-based condition for numeric validation\n\n```ts\ntype NumericFactCondition = {\n  fact: "numeric-value" | "total-length"\n  operator: "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive"\n  value: number\n  params?: {\n    errorMessage?: string\n  }\n} | {\n  fact: "integer-digits-count"\n  operator: "equal" | "exactlyNDigits" | "minIntegerDigits" | "maxIntegerDigits"\n  value: number\n  params?: {\n    errorMessage?: string\n    allowLeadingZeroes?: boolean\n  }\n} | {\n  fact: "decimal-digits-count"\n  operator: "equal" | "minDecimalDigits" | "maxDecimalDigits"\n  value: number\n  params?: {\n    errorMessage?: string\n  }\n} | {\n  fact: "has-leading-zeroes"\n  operator: "equal" | "notAllowed"\n  value: boolean\n  params?: {\n    errorMessage?: string\n  }\n}\n```\n\n### `ComparisonRuleType`\n\nDeclarative validation rule (schema version v2). Supports predefined comparison operators\nover number, date and text inputs, with static, dynamic (context path), relative-date and\nexternal (app-provided) comparison values.\n\n\n```ts\ntype ComparisonRuleType = {\n  input_type: "number" | "date" | "text"\n  conditions: Array<{\n    id: string\n    operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "between" | "dateBefore" | "dateOnOrBefore" | "dateAfter" | "dateOnOrAfter" | "dateBetween" | "notInFuture" | "notInPast" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "regexMatch" | "lengthBetween" | "maxDigits" | "maxDecimals"\n    value: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      offset: { ... }\n      unit: { ... }\n      anchor?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      min: { ... }\n      max: { ... }\n    } | {\n      source: { ... }\n    }\n    error_message: string\n    applies_when?: {\n      path: { ... }\n      operator: { ... }\n      value?: { ... }\n    }\n    allow_failure?: boolean\n  }>\n}\n```\n\n### `Condition`\n\nA single comparison the input value must satisfy.\n\n```ts\ntype Condition = {\n  id: string\n  operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "between" | "dateBefore" | "dateOnOrBefore" | "dateAfter" | "dateOnOrAfter" | "dateBetween" | "notInFuture" | "notInPast" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "regexMatch" | "lengthBetween" | "maxDigits" | "maxDecimals"\n  value: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "relative_date"\n    offset: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    unit: "days" | "months" | "years"\n    anchor?: "today" | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "range"\n    min: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n  // ...\n}\n```\n\n### `Operator`\n\nPredefined comparison operator. Compatibility (enforced at write time):\n- number: equal, notEqual, greaterThan, greaterThanInclusive, lessThan, lessThanInclusive, between, regexMatch,\n  maxDigits, maxDecimals\n- date: dateBefore, dateOnOrBefore, dateAfter, dateOnOrAfter, dateBetween, notInFuture, not\n\n```ts\ntype Operator = "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "between" | "dateBefore" | "dateOnOrBefore" | "dateAfter" | "dateOnOrAfter" | "dateBetween" | "notInFuture" | "notInPast" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "regexMatch" | "lengthBetween" | "maxDigits" | "maxDecimals"\n```\n\n### `ConditionValue`\n\nThe comparison value of a condition - a scalar, a range of scalars, or nothing (unary operators).\n\n```ts\ntype ConditionValue = {\n  source: "static"\n  data: number | string | boolean\n} | {\n  source: "context"\n  path: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "relative_date"\n  offset: number | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  unit: "days" | "months" | "years"\n  anchor?: "today" | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n  // ...\n}\n```\n\n### `ScalarValue`\n\nA single comparison value - static, resolved from context, a relative date, an organisation environment variable, an external value, or a parameter the consuming surface supplies.\n\n```ts\ntype ScalarValue = {\n  source: "static"\n  data: number | string | boolean\n} | {\n  source: "context"\n  path: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "relative_date"\n  offset: number | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  unit: "days" | "months" | "years"\n  anchor?: "today" | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n  // ...\n}\n```\n\n### `ValueReference`\n\nA value resolved at evaluation time instead of written into the rule, identified by\n`source`. Each field that accepts a reference lists the sources it allows; a rule using\nany other source is rejected when it is saved.\n\n\n```ts\ntype ValueReference = {\n  source: "context"\n  path: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "environment"\n  key: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "external"\n  app_id: string\n  hook_id: string\n  result_id: string\n  inputs?: Record<string, {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }>\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "parameter"\n  name: string\n  adjust?: {\n  // ...\n}\n```\n\n### `EnvironmentValue`\n\nA comparison value resolved at evaluation time from an organisation environment variable\n(environments-api). The rule stores the key, never the value, so one change to the variable\nreaches every rule that references it and a blueprint install never overwrites the\norganisation\'s own value.\n\nOnly brow\n\n```ts\ntype EnvironmentValue = {\n  source: "environment"\n  key: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n}\n```\n\n### `ExternalValue`\n\nA comparison value produced at evaluation time by an External Values hook of an installed\napp (component type `EXTERNAL_VALUES`). The rule stores the reference only; the value is\nresolved server-side by the external-values-api, which executes the hook\'s HTTP call with\nthe app\'s credentials and retur\n\n```ts\ntype ExternalValue = {\n  source: "external"\n  app_id: string\n  hook_id: string\n  result_id: string\n  inputs?: Record<string, {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }>\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n}\n```\n\n### `ParameterValue`\n\nA comparison value supplied by the consumer that evaluates the rule, identified by a name\nthe rule chooses (e.g. `start_date`). The rule stores the name only. The consumer binds the\nname to a source of its own - a journey binds it to the value of another block - and\nresolves it at evaluation time, s\n\n```ts\ntype ParameterValue = {\n  source: "parameter"\n  name: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n}\n```\n\n### `StaticValue`\n\nA fixed comparison value.\n\n```ts\ntype StaticValue = {\n  source: "static"\n  data: number | string | boolean\n}\n```\n\n### `ContextValue`\n\nA dynamic comparison value resolved from runtime context, e.g. `contract.installment_amount`\nor `previous_reading.value`. The first path segment must match the `name` of a declared\ncontext requirement.\n\n\n```ts\ntype ContextValue = {\n  source: "context"\n  path: string\n  adjust?: {\n    type: "percent" | "absolute"\n    value: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n}\n```\n\n### `ValueAdjustment`\n\nAdjusts a context-resolved numeric value before comparison, e.g. "context value plus 10 percent".\nUsed to express tolerance bands such as "at most 10% above the current instalment amount".\n\n\n```ts\ntype ValueAdjustment = {\n  type: "percent" | "absolute"\n  value: number | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  direction: "increase" | "decrease"\n  rounding?: "up" | "down"\n}\n```\n\n### `RelativeDateValue`\n\nA date relative to the evaluation moment, e.g. "today minus 30 days". Only valid for date rules.\n\n```ts\ntype RelativeDateValue = {\n  source: "relative_date"\n  offset: number | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  unit: "days" | "months" | "years"\n  anchor?: "today" | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n}\n```\n\n### `RangeValue`\n\nA lower and upper bound for range operators (between, dateBetween, lengthBetween). Bounds are inclusive.\n\n```ts\ntype RangeValue = {\n  source: "range"\n  min: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "relative_date"\n    offset: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    unit: "days" | "months" | "years"\n    anchor?: "today" | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  max: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n  // ...\n}\n```\n\n### `NoValue`\n\nNo comparison value - used by unary operators such as notInFuture / notInPast.\n\n```ts\ntype NoValue = {\n  source: "none"\n}\n```\n\n### `DocumentRuleType`\n\nDeclarative validation rule (schema version v2) for uploaded files. The rule declares how deep\nthe check goes (`check.level`) and the conditions the file must satisfy. Property conditions\n(file type, size, page count, image resolution, blank and password-protected detection) are\ndeterministic and av\n\n```ts\ntype DocumentRuleType = {\n  input_type: "document"\n  check: {\n    level: "basic" | "standard" | "advanced"\n  }\n  conditions: Array<{\n    id: string\n    operator: "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"\n    value: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      min: { ... }\n      max: { ... }\n    } | {\n      source: { ... }\n    } | {\n      source: { ... }\n      types: { ... }\n    } | {\n      source: { ... }\n      text: { ... }\n    }\n    error_message: string\n    allow_failure?: boolean\n  }>\n}\n```\n\n### `DocumentCheck`\n\nHow deep the document check goes. Levels are cumulative.\n\n```ts\ntype DocumentCheck = {\n  level: "basic" | "standard" | "advanced"\n}\n```\n\n### `DocumentCondition`\n\nA single check the uploaded file must satisfy.\n\n```ts\ntype DocumentCondition = {\n  id: string\n  operator: "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"\n  value: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "range"\n    min: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      offset: { ... }\n      unit: { ... }\n      anchor?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    max: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      offset: { ... }\n      unit: { ... }\n      anchor?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n  } | {\n    source: "none"\n  } | {\n    source: "file_types"\n    types: "image" | "pdf" | "document" | "spreadsheet"[]\n  } | {\n    source: "criteria"\n    text: string\n  }\n  error_message: string\n  allow_failure?: boolean\n}\n```\n\n### `DocumentOperator`\n\nPredefined document check. Value compatibility (enforced at write time):\n- fileTypeIn: `file_types` value listing the accepted file categories.\n- sizeBelow: static integer, maximum file size in bytes.\n- pageCountBetween: `range` of static non-negative integers (inclusive).\n- resolutionAtLeast / reso\n\n```ts\ntype DocumentOperator = "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"\n```\n\n### `DocumentConditionValue`\n\nThe value of a document condition - a static scalar, a range, nothing, accepted file categories, or a free-text criterion.\n\n```ts\ntype DocumentConditionValue = {\n  source: "static"\n  data: number | string | boolean\n} | {\n  source: "range"\n  min: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "relative_date"\n    offset: number | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n    unit: "days" | "months" | "years"\n    anchor?: "today" | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      app_id: { ... }\n      hook_id: { ... }\n      result_id: { ... }\n      inputs?: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n  max: {\n    source: "static"\n    data: number | string | boolean\n  } | {\n    source: "context"\n  // ...\n}\n```\n\n### `FileTypesValue`\n\nAccepted file categories; each category expands to a mime list at check time.\n\n```ts\ntype FileTypesValue = {\n  source: "file_types"\n  types: "image" | "pdf" | "document" | "spreadsheet"[]\n}\n```\n\n### `CriteriaValue`\n\nA free-text requirement judged against the document\'s extracted content, e.g. "The photo shows\nan electricity meter with the meter number and the current reading fully legible." One requirement\nper condition keeps results specific and lets each requirement be graded separately.\n\n\n```ts\ntype CriteriaValue = {\n  source: "criteria"\n  text: string\n}\n```\n\n### `AppliesWhen`\n\nOptional precondition on a condition: the condition only takes part in the\nvalidation when this comparison over context holds. Examples: apply the\ndual-tariff reference only when `contract.htnt` is not empty, or run a\nplausibility check only when a context value reaches a threshold.\n\n\n```ts\ntype AppliesWhen = {\n  path: string\n  operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty"\n  value?: number | string | boolean | {\n    source: "context"\n    path: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "environment"\n    key: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "external"\n    app_id: string\n    hook_id: string\n    result_id: string\n    inputs?: Record<string, {\n      source: { ... }\n      name: { ... }\n      adjust?: { ... }\n    }>\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  } | {\n    source: "parameter"\n    name: string\n    adjust?: {\n      type: { ... }\n      value: { ... }\n      direction: { ... }\n      rounding?: { ... }\n    }\n  }\n}\n```\n\n### `ContextRequirement`\n\nAn entity context source the rule needs at evaluation time, referenced by `context`\nvalue paths via the schema slug as their first segment (e.g. `contract.installment_amount`).\nHow the source is resolved (which entity instance) is decided by the consuming surface,\nnot by the rule. Meter reading comp\n\n```ts\ntype ContextRequirement = {\n  schema: string\n}\n```\n';
 export {
   validation_rules_default as default
 };

package/dist/{validation-rules.d-C1OtLama.d.ts → validation-rules.d-Dw7Qn8_e.d.cts}

@@ -152,19 +152,24 @@ declare namespace Components {
          * are resolved only for authenticated consumers (epilot 360 users and portal end customers);
          * in public journeys the dependent conditions are skipped.
          *
+         * A hook may declare value inputs (`contexts` entries `{ "type": "value", "name", "value_type" }`)
+         * besides the entities it receives. `inputs` supplies them from rule parameters, which the
+         * consumer binds like any other parameter and sends to the hook as `Context.<name>`.
+         *
          */
         ExternalValue | /**
-         * A comparison value supplied by the surface that evaluates the rule, identified by a name
-         * the rule chooses (e.g. `start_date`). The rule stores the name only. The consuming surface
-         * binds the name to a source of its own - a journey binds it to the value of another block -
-         * and resolves it at evaluation time, so the rule never references the surface's objects
-         * and stays reusable across journeys and forms.
+         * A comparison value supplied by the consumer that evaluates the rule, identified by a name
+         * the rule chooses (e.g. `start_date`). The rule stores the name only. The consumer binds the
+         * name to a source of its own - a journey binds it to the value of another block - and
+         * resolves it at evaluation time, so the rule never references the consumer's objects and
+         * stays reusable across journeys and forms.
          *
-         * The kind a parameter is compared as follows from the field it sits in: `number`, `text`
-         * or `date` for comparison values, range bounds, adjustment amounts and relative date
-         * offsets, or a number, string or boolean as an `applies_when` value. One name is compared
-         * as one kind throughout a rule; a rule using a name as two kinds is rejected at write time.
-         * A parameter the surface leaves unbound or empty leaves the comparison unresolved.
+         * A parameter's kind is determined by the field it is used in: `number`, `text` or `date`
+         * for comparison values, range bounds, adjustment amounts and relative date offsets, or a
+         * number, string or boolean as an `applies_when` value, or the `value_type` of the External
+         * Values hook input it supplies (`ExternalValue.inputs`). One name is compared as one kind
+         * throughout a rule; a rule using a name as two kinds is rejected at write time. A parameter
+         * the consumer leaves unbound or empty leaves the comparison unresolved.
          *
          */
         ParameterValue | /* A lower and upper bound for range operators (between, dateBetween, lengthBetween). Bounds are inclusive. */ RangeValue | /* No comparison value - used by unary operators such as notInFuture / notInPast. */ NoValue;
@@ -401,6 +406,10 @@ declare namespace Components {
          * are resolved only for authenticated consumers (epilot 360 users and portal end customers);
          * in public journeys the dependent conditions are skipped.
          *
+         * A hook may declare value inputs (`contexts` entries `{ "type": "value", "name", "value_type" }`)
+         * besides the entities it receives. `inputs` supplies them from rule parameters, which the
+         * consumer binds like any other parameter and sends to the hook as `Context.<name>`.
+         *
          */
         export interface ExternalValue {
             source: "external";
@@ -416,6 +425,34 @@ declare namespace Components {
              * ID of the result entry within the hook whose value is compared.
              */
             result_id: string; // ^[a-zA-Z0-9_-]+$
+            /**
+             * Values for the hook's value inputs, keyed by the input name the hook declares
+             * (`contexts` entry of type `value`), e.g. `{ "reading_date": { "source": "parameter", "name": "reading_date" } }`.
+             * Only parameters are supported. Write-time validation checks that every key is a value input the
+             * hook declares and uses the input's `value_type` (`number`, `text`, `date` or `boolean`) as the
+             * parameter's kind, so the parameter must not be compared as another kind elsewhere in the rule.
+             * An input parameter must not carry an adjustment. Declared inputs without an entry are allowed;
+             * the consumer omits an input that has no value.
+             *
+             */
+            inputs?: {
+                [name: string]: /**
+                 * A comparison value supplied by the consumer that evaluates the rule, identified by a name
+                 * the rule chooses (e.g. `start_date`). The rule stores the name only. The consumer binds the
+                 * name to a source of its own - a journey binds it to the value of another block - and
+                 * resolves it at evaluation time, so the rule never references the consumer's objects and
+                 * stays reusable across journeys and forms.
+                 *
+                 * A parameter's kind is determined by the field it is used in: `number`, `text` or `date`
+                 * for comparison values, range bounds, adjustment amounts and relative date offsets, or a
+                 * number, string or boolean as an `applies_when` value, or the `value_type` of the External
+                 * Values hook input it supplies (`ExternalValue.inputs`). One name is compared as one kind
+                 * throughout a rule; a rule using a name as two kinds is rejected at write time. A parameter
+                 * the consumer leaves unbound or empty leaves the comparison unresolved.
+                 *
+                 */
+                ParameterValue;
+            };
             adjust?: /**
              * Adjusts a context-resolved numeric value before comparison, e.g. "context value plus 10 percent".
              * Used to express tolerance bands such as "at most 10% above the current instalment amount".
@@ -597,17 +634,18 @@ declare namespace Components {
          */
         export type Operator = "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "between" | "dateBefore" | "dateOnOrBefore" | "dateAfter" | "dateOnOrAfter" | "dateBetween" | "notInFuture" | "notInPast" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "regexMatch" | "lengthBetween" | "maxDigits" | "maxDecimals";
         /**
-         * A comparison value supplied by the surface that evaluates the rule, identified by a name
-         * the rule chooses (e.g. `start_date`). The rule stores the name only. The consuming surface
-         * binds the name to a source of its own - a journey binds it to the value of another block -
-         * and resolves it at evaluation time, so the rule never references the surface's objects
-         * and stays reusable across journeys and forms.
+         * A comparison value supplied by the consumer that evaluates the rule, identified by a name
+         * the rule chooses (e.g. `start_date`). The rule stores the name only. The consumer binds the
+         * name to a source of its own - a journey binds it to the value of another block - and
+         * resolves it at evaluation time, so the rule never references the consumer's objects and
+         * stays reusable across journeys and forms.
          *
-         * The kind a parameter is compared as follows from the field it sits in: `number`, `text`
-         * or `date` for comparison values, range bounds, adjustment amounts and relative date
-         * offsets, or a number, string or boolean as an `applies_when` value. One name is compared
-         * as one kind throughout a rule; a rule using a name as two kinds is rejected at write time.
-         * A parameter the surface leaves unbound or empty leaves the comparison unresolved.
+         * A parameter's kind is determined by the field it is used in: `number`, `text` or `date`
+         * for comparison values, range bounds, adjustment amounts and relative date offsets, or a
+         * number, string or boolean as an `applies_when` value, or the `value_type` of the External
+         * Values hook input it supplies (`ExternalValue.inputs`). One name is compared as one kind
+         * throughout a rule; a rule using a name as two kinds is rejected at write time. A parameter
+         * the consumer leaves unbound or empty leaves the comparison unresolved.
          *
          */
         export interface ParameterValue {
@@ -941,19 +979,24 @@ declare namespace Components {
          * are resolved only for authenticated consumers (epilot 360 users and portal end customers);
          * in public journeys the dependent conditions are skipped.
          *
+         * A hook may declare value inputs (`contexts` entries `{ "type": "value", "name", "value_type" }`)
+         * besides the entities it receives. `inputs` supplies them from rule parameters, which the
+         * consumer binds like any other parameter and sends to the hook as `Context.<name>`.
+         *
          */
         ExternalValue | /**
-         * A comparison value supplied by the surface that evaluates the rule, identified by a name
-         * the rule chooses (e.g. `start_date`). The rule stores the name only. The consuming surface
-         * binds the name to a source of its own - a journey binds it to the value of another block -
-         * and resolves it at evaluation time, so the rule never references the surface's objects
-         * and stays reusable across journeys and forms.
+         * A comparison value supplied by the consumer that evaluates the rule, identified by a name
+         * the rule chooses (e.g. `start_date`). The rule stores the name only. The consumer binds the
+         * name to a source of its own - a journey binds it to the value of another block - and
+         * resolves it at evaluation time, so the rule never references the consumer's objects and
+         * stays reusable across journeys and forms.
          *
-         * The kind a parameter is compared as follows from the field it sits in: `number`, `text`
-         * or `date` for comparison values, range bounds, adjustment amounts and relative date
-         * offsets, or a number, string or boolean as an `applies_when` value. One name is compared
-         * as one kind throughout a rule; a rule using a name as two kinds is rejected at write time.
-         * A parameter the surface leaves unbound or empty leaves the comparison unresolved.
+         * A parameter's kind is determined by the field it is used in: `number`, `text` or `date`
+         * for comparison values, range bounds, adjustment amounts and relative date offsets, or a
+         * number, string or boolean as an `applies_when` value, or the `value_type` of the External
+         * Values hook input it supplies (`ExternalValue.inputs`). One name is compared as one kind
+         * throughout a rule; a rule using a name as two kinds is rejected at write time. A parameter
+         * the consumer leaves unbound or empty leaves the comparison unresolved.
          *
          */
         ParameterValue;
@@ -1279,19 +1322,24 @@ declare namespace Components {
          * are resolved only for authenticated consumers (epilot 360 users and portal end customers);
          * in public journeys the dependent conditions are skipped.
          *
+         * A hook may declare value inputs (`contexts` entries `{ "type": "value", "name", "value_type" }`)
+         * besides the entities it receives. `inputs` supplies them from rule parameters, which the
+         * consumer binds like any other parameter and sends to the hook as `Context.<name>`.
+         *
          */
         ExternalValue | /**
-         * A comparison value supplied by the surface that evaluates the rule, identified by a name
-         * the rule chooses (e.g. `start_date`). The rule stores the name only. The consuming surface
-         * binds the name to a source of its own - a journey binds it to the value of another block -
-         * and resolves it at evaluation time, so the rule never references the surface's objects
-         * and stays reusable across journeys and forms.
+         * A comparison value supplied by the consumer that evaluates the rule, identified by a name
+         * the rule chooses (e.g. `start_date`). The rule stores the name only. The consumer binds the
+         * name to a source of its own - a journey binds it to the value of another block - and
+         * resolves it at evaluation time, so the rule never references the consumer's objects and
+         * stays reusable across journeys and forms.
          *
-         * The kind a parameter is compared as follows from the field it sits in: `number`, `text`
-         * or `date` for comparison values, range bounds, adjustment amounts and relative date
-         * offsets, or a number, string or boolean as an `applies_when` value. One name is compared
-         * as one kind throughout a rule; a rule using a name as two kinds is rejected at write time.
-         * A parameter the surface leaves unbound or empty leaves the comparison unresolved.
+         * A parameter's kind is determined by the field it is used in: `number`, `text` or `date`
+         * for comparison values, range bounds, adjustment amounts and relative date offsets, or a
+         * number, string or boolean as an `applies_when` value, or the `value_type` of the External
+         * Values hook input it supplies (`ExternalValue.inputs`). One name is compared as one kind
+         * throughout a rule; a rule using a name as two kinds is rejected at write time. A parameter
+         * the consumer leaves unbound or empty leaves the comparison unresolved.
          *
          */
         ParameterValue;