@epilot/sdk 2.19.13 → 2.20.1

package/dist/validation-rules-ETOO45CW.js

@@ -0,0 +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- [`EnvironmentValue`](#environmentvalue)\n- [`ExternalValue`](#externalvalue)\n- [`StaticValue`](#staticvalue)\n- [`ContextValue`](#contextvalue)\n- [`ValueAdjustment`](#valueadjustment)\n- [`RelativeDateValue`](#relativedatevalue)\n- [`RangeValue`](#rangevalue)\n- [`NoValue`](#novalue)\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  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  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      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    unit: "days" | "months" | "years"\n    anchor?: "today"\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: "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    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  } | {\n    source: "none"\n  }\n  error_message: string\n  applies_when?: {\n    path: string\n    operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty"\n    value?: number | string | boolean | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\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    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "relative_date"\n  offset: number\n  unit: "days" | "months" | "years"\n  anchor?: "today"\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    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    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\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    unit: "days" | "months" | "years"\n    anchor?: "today"\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\n### `ScalarValue`\n\nA single comparison value - static, resolved from context, a relative date, an organisation environment variable, or an external value.\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    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "relative_date"\n  offset: number\n  unit: "days" | "months" | "years"\n  anchor?: "today"\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    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    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\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    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    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    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  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  unit: "days" | "months" | "years"\n  anchor?: "today"\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    unit: "days" | "months" | "years"\n    anchor?: "today"\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  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    unit: "days" | "months" | "years"\n    anchor?: "today"\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\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### `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: "environment"\n    key: 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-MZZ7YMJM.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
+
+// 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- [`EnvironmentValue`](#environmentvalue)\n- [`ExternalValue`](#externalvalue)\n- [`StaticValue`](#staticvalue)\n- [`ContextValue`](#contextvalue)\n- [`ValueAdjustment`](#valueadjustment)\n- [`RelativeDateValue`](#relativedatevalue)\n- [`RangeValue`](#rangevalue)\n- [`NoValue`](#novalue)\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  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  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      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    unit: "days" | "months" | "years"\n    anchor?: "today"\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: "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    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  } | {\n    source: "none"\n  }\n  error_message: string\n  applies_when?: {\n    path: string\n    operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty"\n    value?: number | string | boolean | {\n      source: { ... }\n      key: { ... }\n      adjust?: { ... }\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    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "relative_date"\n  offset: number\n  unit: "days" | "months" | "years"\n  anchor?: "today"\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    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    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\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    unit: "days" | "months" | "years"\n    anchor?: "today"\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\n### `ScalarValue`\n\nA single comparison value - static, resolved from context, a relative date, an organisation environment variable, or an external value.\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    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\n  }\n} | {\n  source: "relative_date"\n  offset: number\n  unit: "days" | "months" | "years"\n  anchor?: "today"\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    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    direction: "increase" | "decrease"\n    rounding?: "up" | "down"\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    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    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    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  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  unit: "days" | "months" | "years"\n  anchor?: "today"\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    unit: "days" | "months" | "years"\n    anchor?: "today"\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  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    unit: "days" | "months" | "years"\n    anchor?: "today"\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\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### `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: "environment"\n    key: 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';
+
+
+exports.default = validation_rules_default;

package/dist/{validation-rules.d-CvGvBnMX.d.ts → validation-rules.d-D8X9MYTc.d.cts}

@@ -24,14 +24,36 @@ declare namespace Components {
              */
             operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty";
             /**
-             * Static comparison value for binary operators.
+             * Comparison value for binary operators: a static number, string or boolean, or an
+             * organisation environment variable (`Number`, `Text` or `Boolean`) so a precondition
+             * can act as a per-organisation switch or threshold.
+             *
+             */
+            value?: /**
+             * Comparison value for binary operators: a static number, string or boolean, or an
+             * organisation environment variable (`Number`, `Text` or `Boolean`) so a precondition
+             * can act as a per-organisation switch or threshold.
+             *
              */
-            value?: /* Static comparison value for binary operators. */ number | string | boolean;
+            number | string | boolean | /**
+             * A comparison value resolved at evaluation time from an organisation environment variable
+             * (environments-api). The rule stores the key, never the value, so one change to the variable
+             * reaches every rule that references it and a blueprint install never overwrites the
+             * organisation's own value.
+             *
+             * Only browser-safe variable types are allowed: `Number` for numeric comparisons, `Text` for
+             * text comparisons and for dates (ISO 8601 string), `Boolean` for `applies_when` values.
+             * `String` and `SecretString` variables are rejected at write time. Write-time validation also
+             * checks that the variable exists in the organisation; a variable that exists without a value
+             * (for example seeded by a blueprint install) is accepted and resolves as unavailable until set.
+             *
+             */
+            EnvironmentValue;
         }
         /**
          * Declarative validation rule (schema version v2). Supports predefined comparison operators
-         * over number, date and text inputs, with static, dynamic (context path) and relative-date
-         * comparison values.
+         * over number, date and text inputs, with static, dynamic (context path), relative-date and
+         * external (app-provided) comparison values.
          *
          */
         export interface ComparisonRuleType {
@@ -105,7 +127,33 @@ declare namespace Components {
          * context requirement.
          *
          */
-        ContextValue | /* A date relative to the evaluation moment, e.g. "today minus 30 days". Only valid for date rules. */ RelativeDateValue | /* 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;
+        ContextValue | /* A date relative to the evaluation moment, e.g. "today minus 30 days". Only valid for date rules. */ RelativeDateValue | /**
+         * A comparison value resolved at evaluation time from an organisation environment variable
+         * (environments-api). The rule stores the key, never the value, so one change to the variable
+         * reaches every rule that references it and a blueprint install never overwrites the
+         * organisation's own value.
+         *
+         * Only browser-safe variable types are allowed: `Number` for numeric comparisons, `Text` for
+         * text comparisons and for dates (ISO 8601 string), `Boolean` for `applies_when` values.
+         * `String` and `SecretString` variables are rejected at write time. Write-time validation also
+         * checks that the variable exists in the organisation; a variable that exists without a value
+         * (for example seeded by a blueprint install) is accepted and resolves as unavailable until set.
+         *
+         */
+        EnvironmentValue | /**
+         * A comparison value produced at evaluation time by an External Values hook of an installed
+         * app (component type `EXTERNAL_VALUES`). The rule stores the reference only; the value is
+         * resolved server-side by the external-values-api, which executes the hook's HTTP call with
+         * the app's credentials and returns the typed result identified by `result_id`.
+         *
+         * Write-time validation checks that the app is installed in the organisation, that the hook
+         * and result exist, and that the result's type is compatible with the compared kind
+         * (`number` results for numeric comparisons, `text` for text, `date` for date). External values
+         * are resolved only for authenticated consumers (epilot 360 users and portal end customers);
+         * in public journeys the dependent conditions are skipped.
+         *
+         */
+        ExternalValue | /* 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;
         /**
          * An entity context source the rule needs at evaluation time, referenced by `context`
          * value paths via the schema slug as their first segment (e.g. `contract.installment_amount`).
@@ -164,8 +212,8 @@ declare namespace Components {
             UsedBy[];
             rule: /* Validation rule that uses a regular expression to validate input. */ RegexRuleType | /* Validation rule that uses a sequence of patterns to validate input. */ PatternRuleType | /* Validation rule for numeric values, supporting range and digit count constraints. */ NumericRuleType | /**
              * Declarative validation rule (schema version v2). Supports predefined comparison operators
-             * over number, date and text inputs, with static, dynamic (context path) and relative-date
-             * comparison values.
+             * over number, date and text inputs, with static, dynamic (context path), relative-date and
+             * external (app-provided) comparison values.
              *
              */
             ComparisonRuleType;
@@ -185,6 +233,66 @@ declare namespace Components {
              */
             ContextRequirement[];
         }
+        /**
+         * A comparison value resolved at evaluation time from an organisation environment variable
+         * (environments-api). The rule stores the key, never the value, so one change to the variable
+         * reaches every rule that references it and a blueprint install never overwrites the
+         * organisation's own value.
+         *
+         * Only browser-safe variable types are allowed: `Number` for numeric comparisons, `Text` for
+         * text comparisons and for dates (ISO 8601 string), `Boolean` for `applies_when` values.
+         * `String` and `SecretString` variables are rejected at write time. Write-time validation also
+         * checks that the variable exists in the organisation; a variable that exists without a value
+         * (for example seeded by a blueprint install) is accepted and resolves as unavailable until set.
+         *
+         */
+        export interface EnvironmentValue {
+            source: "environment";
+            /**
+             * Environment variable key, e.g. `abschlag.max`.
+             */
+            key: string; // ^[a-z0-9][a-z0-9_.\-]{0,127}$
+            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".
+             *
+             */
+            ValueAdjustment;
+        }
+        /**
+         * A comparison value produced at evaluation time by an External Values hook of an installed
+         * app (component type `EXTERNAL_VALUES`). The rule stores the reference only; the value is
+         * resolved server-side by the external-values-api, which executes the hook's HTTP call with
+         * the app's credentials and returns the typed result identified by `result_id`.
+         *
+         * Write-time validation checks that the app is installed in the organisation, that the hook
+         * and result exist, and that the result's type is compatible with the compared kind
+         * (`number` results for numeric comparisons, `text` for text, `date` for date). External values
+         * are resolved only for authenticated consumers (epilot 360 users and portal end customers);
+         * in public journeys the dependent conditions are skipped.
+         *
+         */
+        export interface ExternalValue {
+            source: "external";
+            /**
+             * ID of the installed app that provides the External Values component.
+             */
+            app_id: string;
+            /**
+             * ID of the hook within the app's External Values component.
+             */
+            hook_id: string; // ^[a-zA-Z0-9_-]+$
+            /**
+             * ID of the result entry within the hook whose value is compared.
+             */
+            result_id: string; // ^[a-zA-Z0-9_-]+$
+            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".
+             *
+             */
+            ValueAdjustment;
+        }
         /**
          * Response envelope for listing all validation rules within an organization.
          */
@@ -510,8 +618,8 @@ declare namespace Components {
          */
         export interface RangeValue {
             source: "range";
-            min: /* A single comparison value - static, resolved from context, or a relative date. */ ScalarValue;
-            max: /* A single comparison value - static, resolved from context, or a relative date. */ ScalarValue;
+            min: /* A single comparison value - static, resolved from context, a relative date, an organisation environment variable, or an external value. */ ScalarValue;
+            max: /* A single comparison value - static, resolved from context, a relative date, an organisation environment variable, or an external value. */ ScalarValue;
         }
         /**
          * Condition definition for a regex-based validation rule (2 levels deep)
@@ -585,15 +693,41 @@ declare namespace Components {
             anchor?: "today";
         }
         /**
-         * A single comparison value - static, resolved from context, or a relative date.
+         * A single comparison value - static, resolved from context, a relative date, an organisation environment variable, or an external value.
          */
-        export type ScalarValue = /* A single comparison value - static, resolved from context, or a relative date. */ /* A fixed comparison value. */ StaticValue | /**
+        export type ScalarValue = /* A single comparison value - static, resolved from context, a relative date, an organisation environment variable, or an external value. */ /* A fixed comparison value. */ StaticValue | /**
          * A dynamic comparison value resolved from runtime context, e.g. `contract.installment_amount`
          * or `previous_reading.value`. The first path segment must match the `name` of a declared
          * context requirement.
          *
          */
-        ContextValue | /* A date relative to the evaluation moment, e.g. "today minus 30 days". Only valid for date rules. */ RelativeDateValue;
+        ContextValue | /* A date relative to the evaluation moment, e.g. "today minus 30 days". Only valid for date rules. */ RelativeDateValue | /**
+         * A comparison value resolved at evaluation time from an organisation environment variable
+         * (environments-api). The rule stores the key, never the value, so one change to the variable
+         * reaches every rule that references it and a blueprint install never overwrites the
+         * organisation's own value.
+         *
+         * Only browser-safe variable types are allowed: `Number` for numeric comparisons, `Text` for
+         * text comparisons and for dates (ISO 8601 string), `Boolean` for `applies_when` values.
+         * `String` and `SecretString` variables are rejected at write time. Write-time validation also
+         * checks that the variable exists in the organisation; a variable that exists without a value
+         * (for example seeded by a blueprint install) is accepted and resolves as unavailable until set.
+         *
+         */
+        EnvironmentValue | /**
+         * A comparison value produced at evaluation time by an External Values hook of an installed
+         * app (component type `EXTERNAL_VALUES`). The rule stores the reference only; the value is
+         * resolved server-side by the external-values-api, which executes the hook's HTTP call with
+         * the app's credentials and returns the typed result identified by `result_id`.
+         *
+         * Write-time validation checks that the app is installed in the organisation, that the hook
+         * and result exist, and that the result's type is compatible with the compared kind
+         * (`number` results for numeric comparisons, `text` for text, `date` for date). External values
+         * are resolved only for authenticated consumers (epilot 360 users and portal end customers);
+         * in public journeys the dependent conditions are skipped.
+         *
+         */
+        ExternalValue;
         /**
          * A fixed comparison value.
          */
@@ -627,8 +761,8 @@ declare namespace Components {
             UsedBy[];
             rule?: /* Validation rule that uses a regular expression to validate input. */ RegexRuleType | /* Validation rule that uses a sequence of patterns to validate input. */ PatternRuleType | /* Validation rule for numeric values, supporting range and digit count constraints. */ NumericRuleType | /**
              * Declarative validation rule (schema version v2). Supports predefined comparison operators
-             * over number, date and text inputs, with static, dynamic (context path) and relative-date
-             * comparison values.
+             * over number, date and text inputs, with static, dynamic (context path), relative-date and
+             * external (app-provided) comparison values.
              *
              */
             ComparisonRuleType;
@@ -702,8 +836,8 @@ declare namespace Components {
             UsedBy[];
             rule?: /* Validation rule that uses a regular expression to validate input. */ RegexRuleType | /* Validation rule that uses a sequence of patterns to validate input. */ PatternRuleType | /* Validation rule for numeric values, supporting range and digit count constraints. */ NumericRuleType | /**
              * Declarative validation rule (schema version v2). Supports predefined comparison operators
-             * over number, date and text inputs, with static, dynamic (context path) and relative-date
-             * comparison values.
+             * over number, date and text inputs, with static, dynamic (context path), relative-date and
+             * external (app-provided) comparison values.
              *
              */
             ComparisonRuleType;
@@ -774,8 +908,8 @@ declare namespace Components {
             UsedBy[];
             rule?: /* Validation rule that uses a regular expression to validate input. */ RegexRuleType | /* Validation rule that uses a sequence of patterns to validate input. */ PatternRuleType | /* Validation rule for numeric values, supporting range and digit count constraints. */ NumericRuleType | /**
              * Declarative validation rule (schema version v2). Supports predefined comparison operators
-             * over number, date and text inputs, with static, dynamic (context path) and relative-date
-             * comparison values.
+             * over number, date and text inputs, with static, dynamic (context path), relative-date and
+             * external (app-provided) comparison values.
              *
              */
             ComparisonRuleType;
@@ -820,7 +954,20 @@ declare namespace Components {
              * context requirement.
              *
              */
-            ContextValue;
+            ContextValue | /**
+             * A comparison value resolved at evaluation time from an organisation environment variable
+             * (environments-api). The rule stores the key, never the value, so one change to the variable
+             * reaches every rule that references it and a blueprint install never overwrites the
+             * organisation's own value.
+             *
+             * Only browser-safe variable types are allowed: `Number` for numeric comparisons, `Text` for
+             * text comparisons and for dates (ISO 8601 string), `Boolean` for `applies_when` values.
+             * `String` and `SecretString` variables are rejected at write time. Write-time validation also
+             * checks that the variable exists in the organisation; a variable that exists without a value
+             * (for example seeded by a blueprint install) is accepted and resolves as unavailable until set.
+             *
+             */
+            EnvironmentValue;
             direction: "increase" | "decrease";
             /**
              * Rounds the adjusted result to a whole number - `up` (ceiling) or `down` (floor).
@@ -897,6 +1044,7 @@ declare namespace Paths {
                  * Invalid request body
                  */
                 message?: string;
+                code?: "external_value_not_found" | "external_value_incompatible";
             }
             export interface $401 {
                 /**
@@ -1104,6 +1252,7 @@ declare namespace Paths {
                  * Invalid request body
                  */
                 message?: string;
+                code?: "external_value_not_found" | "external_value_incompatible";
             }
             export interface $401 {
                 /**
@@ -1318,6 +1467,8 @@ type ConditionValue = Components.Schemas.ConditionValue;
 type ContextRequirement = Components.Schemas.ContextRequirement;
 type ContextValue = Components.Schemas.ContextValue;
 type CreateValidationRuleRequest = Components.Schemas.CreateValidationRuleRequest;
+type EnvironmentValue = Components.Schemas.EnvironmentValue;
+type ExternalValue = Components.Schemas.ExternalValue;
 type GetValidationRulesResponse = Components.Schemas.GetValidationRulesResponse;
 type NoValue = Components.Schemas.NoValue;
 type NumericCondition = Components.Schemas.NumericCondition;
@@ -1343,4 +1494,4 @@ type ValidationRule = Components.Schemas.ValidationRule;
 type ValidationRuleBase = Components.Schemas.ValidationRuleBase;
 type ValueAdjustment = Components.Schemas.ValueAdjustment;
 
-export { type AppliesWhen as A, type Client as C, type GetValidationRulesResponse as G, type NoValue as N, type OperationMethods as O, Paths as P, type RangeValue as R, type ScalarValue as S, type UpdateValidationRuleRequest as U, type ValidationRule as V, Components as a, type PathsDictionary as b, type ComparisonRuleType as c, type Condition as d, type ConditionValue as e, type ContextRequirement as f, type ContextValue as g, type CreateValidationRuleRequest as h, type NumericCondition as i, type NumericFactCondition as j, type NumericNestedCondition as k, type NumericRuleType as l, type Operator as m, type PatternCondition as n, type PatternFactCondition as o, type PatternNestedCondition as p, type PatternRuleType as q, type RegexCondition as r, type RegexFactCondition as s, type RegexNestedCondition as t, type RegexRuleType as u, type RelativeDateValue as v, type StaticValue as w, type UsedBy as x, type ValidationRuleBase as y, type ValueAdjustment as z };
+export { type AppliesWhen as A, type ValueAdjustment as B, type Client as C, type EnvironmentValue as E, type GetValidationRulesResponse as G, type NoValue as N, type OperationMethods as O, Paths as P, type RangeValue as R, type ScalarValue as S, type UpdateValidationRuleRequest as U, type ValidationRule as V, Components as a, type PathsDictionary as b, type ComparisonRuleType as c, type Condition as d, type ConditionValue as e, type ContextRequirement as f, type ContextValue as g, type CreateValidationRuleRequest as h, type ExternalValue as i, type NumericCondition as j, type NumericFactCondition as k, type NumericNestedCondition as l, type NumericRuleType as m, type Operator as n, type PatternCondition as o, type PatternFactCondition as p, type PatternNestedCondition as q, type PatternRuleType as r, type RegexCondition as s, type RegexFactCondition as t, type RegexNestedCondition as u, type RegexRuleType as v, type RelativeDateValue as w, type StaticValue as x, type UsedBy as y, type ValidationRuleBase as z };