@epilot/sdk 2.18.24 → 2.18.26

package/dist/validation-rules-NLHK2CD3.js

@@ -0,0 +1,7 @@
+import "./chunk-YPSWSI3M.js";
+
+// src/docs/validation-rules.json
+var validation_rules_default = '# Validation Rules API\n\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- [`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) and relative-date\ncomparison 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"\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      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"\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: "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    max: {\n      source: { ... }\n      data: { ... }\n    } | {\n      source: { ... }\n      path: { ... }\n      adjust?: { ... }\n    } | {\n      source: { ... }\n      offset: { ... }\n      unit: { ... }\n      anchor?: { ... }\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  }\n  allow_failure?: boolean\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- date: dateBefore, dateOnOrBefore, dateAfter, dateOnOrAfter, dateBetween, notInFuture, notInPast, regexMatch\n- text:\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"\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    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: "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  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} | {\n  source: "none"\n}\n```\n\n### `ScalarValue`\n\nA single comparison value - static, resolved from context, or a relative date.\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    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```\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    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  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  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}\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}\n```\n\n### `ContextRequirement`\n\nAn entity context source the rule needs at evaluation time, referenced by `context`\nvalue paths via the schema slug as their first segment (e.g. `contract.installment_amount`).\nHow the source is resolved (which entity instance) is decided by the consuming surface,\nnot by the rule. Meter reading comp\n\n```ts\ntype ContextRequirement = {\n  schema: string\n}\n```\n';
+export {
+  validation_rules_default as default
+};

package/dist/{validation-rules.d-BBy6Cw2O.d.cts → validation-rules.d-MvjG-zzw.d.cts}

@@ -5,6 +5,29 @@ import { OpenAPIClient, Parameters, UnknownParamsObject, AxiosRequestConfig, Ope
 
 declare namespace Components {
     namespace Schemas {
+        /**
+         * Optional precondition on a condition: the condition only takes part in the
+         * validation when this comparison over context holds. Examples: apply the
+         * dual-tariff reference only when `contract.htnt` is not empty, or run a
+         * plausibility check only when a context value reaches a threshold.
+         *
+         */
+        export interface AppliesWhen {
+            /**
+             * Dot-separated context path whose first segment must match a declared context schema.
+             */
+            path: string; // ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)*$
+            /**
+             * Comparison applied to the resolved context value. `isEmpty` / `isNotEmpty`
+             * take no `value`; all other operators require one.
+             *
+             */
+            operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty";
+            /**
+             * Static comparison value for binary operators.
+             */
+            value?: /* Static comparison value for binary operators. */ number | string | boolean;
+        }
         /**
          * Declarative validation rule (schema version v2). Supports predefined comparison operators
          * over number, date and text inputs, with static, dynamic (context path) and relative-date
@@ -51,6 +74,14 @@ declare namespace Components {
              * Message shown to the end user when this condition fails.
              */
             error_message: string;
+            applies_when?: /**
+             * Optional precondition on a condition: the condition only takes part in the
+             * validation when this comparison over context holds. Examples: apply the
+             * dual-tariff reference only when `contract.htnt` is not empty, or run a
+             * plausibility check only when a context value reaches a threshold.
+             *
+             */
+            AppliesWhen;
             /**
              * When true, the condition is advisory: it is always evaluated and reported
              * when it fails, but it never takes part in the validity verdict.
@@ -761,8 +792,32 @@ declare namespace Components {
          */
         export interface ValueAdjustment {
             type: "percent" | "absolute";
-            value: number;
+            /**
+             * The adjustment amount - a fixed number, or a context path resolving to a number
+             * (e.g. a per-contract percentage limit). Contextual adjustment values must not
+             * carry a nested adjustment.
+             *
+             */
+            value: /**
+             * The adjustment amount - a fixed number, or a context path resolving to a number
+             * (e.g. a per-contract percentage limit). Contextual adjustment values must not
+             * carry a nested adjustment.
+             *
+             */
+            number | /**
+             * 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;
             direction: "increase" | "decrease";
+            /**
+             * Rounds the adjusted result to a whole number - `up` (ceiling) or `down` (floor).
+             * Omitted means no rounding. Used for bounds like "round up(current × 0.9) to whole euros".
+             *
+             */
+            rounding?: "up" | "down";
         }
     }
 }
@@ -1246,6 +1301,7 @@ interface PathsDictionary {
 type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
+type AppliesWhen = Components.Schemas.AppliesWhen;
 type ComparisonRuleType = Components.Schemas.ComparisonRuleType;
 type Condition = Components.Schemas.Condition;
 type ConditionValue = Components.Schemas.ConditionValue;
@@ -1277,4 +1333,4 @@ type ValidationRule = Components.Schemas.ValidationRule;
 type ValidationRuleBase = Components.Schemas.ValidationRuleBase;
 type ValueAdjustment = Components.Schemas.ValueAdjustment;
 
-export { 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 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 };

package/dist/{validation-rules.d-BBy6Cw2O.d.ts → validation-rules.d-MvjG-zzw.d.ts}

@@ -5,6 +5,29 @@ import { OpenAPIClient, Parameters, UnknownParamsObject, AxiosRequestConfig, Ope
 
 declare namespace Components {
     namespace Schemas {
+        /**
+         * Optional precondition on a condition: the condition only takes part in the
+         * validation when this comparison over context holds. Examples: apply the
+         * dual-tariff reference only when `contract.htnt` is not empty, or run a
+         * plausibility check only when a context value reaches a threshold.
+         *
+         */
+        export interface AppliesWhen {
+            /**
+             * Dot-separated context path whose first segment must match a declared context schema.
+             */
+            path: string; // ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)*$
+            /**
+             * Comparison applied to the resolved context value. `isEmpty` / `isNotEmpty`
+             * take no `value`; all other operators require one.
+             *
+             */
+            operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty";
+            /**
+             * Static comparison value for binary operators.
+             */
+            value?: /* Static comparison value for binary operators. */ number | string | boolean;
+        }
         /**
          * Declarative validation rule (schema version v2). Supports predefined comparison operators
          * over number, date and text inputs, with static, dynamic (context path) and relative-date
@@ -51,6 +74,14 @@ declare namespace Components {
              * Message shown to the end user when this condition fails.
              */
             error_message: string;
+            applies_when?: /**
+             * Optional precondition on a condition: the condition only takes part in the
+             * validation when this comparison over context holds. Examples: apply the
+             * dual-tariff reference only when `contract.htnt` is not empty, or run a
+             * plausibility check only when a context value reaches a threshold.
+             *
+             */
+            AppliesWhen;
             /**
              * When true, the condition is advisory: it is always evaluated and reported
              * when it fails, but it never takes part in the validity verdict.
@@ -761,8 +792,32 @@ declare namespace Components {
          */
         export interface ValueAdjustment {
             type: "percent" | "absolute";
-            value: number;
+            /**
+             * The adjustment amount - a fixed number, or a context path resolving to a number
+             * (e.g. a per-contract percentage limit). Contextual adjustment values must not
+             * carry a nested adjustment.
+             *
+             */
+            value: /**
+             * The adjustment amount - a fixed number, or a context path resolving to a number
+             * (e.g. a per-contract percentage limit). Contextual adjustment values must not
+             * carry a nested adjustment.
+             *
+             */
+            number | /**
+             * 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;
             direction: "increase" | "decrease";
+            /**
+             * Rounds the adjusted result to a whole number - `up` (ceiling) or `down` (floor).
+             * Omitted means no rounding. Used for bounds like "round up(current × 0.9) to whole euros".
+             *
+             */
+            rounding?: "up" | "down";
         }
     }
 }
@@ -1246,6 +1301,7 @@ interface PathsDictionary {
 type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
+type AppliesWhen = Components.Schemas.AppliesWhen;
 type ComparisonRuleType = Components.Schemas.ComparisonRuleType;
 type Condition = Components.Schemas.Condition;
 type ConditionValue = Components.Schemas.ConditionValue;
@@ -1277,4 +1333,4 @@ type ValidationRule = Components.Schemas.ValidationRule;
 type ValidationRuleBase = Components.Schemas.ValidationRuleBase;
 type ValueAdjustment = Components.Schemas.ValueAdjustment;
 
-export { 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 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 };

package/docs/customer-portal.md

@@ -229,6 +229,7 @@ const { data } = await customerPortalClient.upsertPortal(...)
 - [`Exists`](#exists)
 - [`EntitySlug`](#entityslug)
 - [`EntitySlugConfig`](#entityslugconfig)
+- [`TemplatesRef`](#templatesref)
 - [`EntityId`](#entityid)
 - [`BaseEntity`](#baseentity)
 - [`Schema`](#schema)
@@ -5285,7 +5286,13 @@ const { data } = await client.getContractWithTemplates(
     id: '123e4567-e89b-12d3-a456-426614174000',
   },
   {
-    templates: {}
+    templates: {},
+    templates_ref: {
+      page_id: 'string',
+      block_id: 'string',
+      config_id: 'string',
+      global_search_config_id: 'string'
+    }
   },
 )
 ```
@@ -6217,6 +6224,12 @@ const { data } = await client.getPortalUserEntity(
         subtitle: '{{contract.contract_number}}'
       }
     },
+    templates_ref: {
+      page_id: 'string',
+      block_id: 'string',
+      config_id: 'string',
+      global_search_config_id: 'string'
+    },
     filters: [
       {
         term: {
@@ -6310,6 +6323,12 @@ const { data } = await client.searchPortalUserEntities(
       main_content_name: '{{contract.contract_name}} ({{contract.contract_number}})',
       content_bottom_name: '{{custom_contract_delivery_address}}'
     },
+    templates_ref: {
+      page_id: 'string',
+      block_id: 'string',
+      config_id: 'string',
+      global_search_config_id: 'string'
+    },
     filters: [
       {
         term: {
@@ -6939,7 +6958,13 @@ const { data } = await client.getMeterReadings(
     from: 0,
     size: 10,
     templates: {},
-    counter_templates: {}
+    counter_templates: {},
+    templates_ref: {
+      page_id: 'string',
+      block_id: 'string',
+      config_id: 'string',
+      global_search_config_id: 'string'
+    }
   },
 )
 ```
@@ -7493,7 +7518,7 @@ const { data } = await client.getPublicPages({
 
 ### `interpolatePortalPages`
 
-Interpolate template variables in portal pages without reading from the database. Accepts pages in the request body and returns them with templates resolved.
+Interpolate template variables in portal pages without reading from the database. Accepts pages in the request body and returns them with templates resolved. Portal Builder preview only: requires a 36
 
 `POST /v2/portal/pages/interpolate`
 
@@ -11834,6 +11859,25 @@ type EntitySlugConfig = {
   slug: string
   targets?: string // uuid[]
   templates?: Record<string, string>
+  templates_ref?: {
+    page_id?: string
+    block_id?: string
+    config_id?: string
+    global_search_config_id?: string
+  }
+}
+```
+
+### `TemplatesRef`
+
+Reference to admin-authored portal configuration (a page block or a global search configuration item) from which the API derives Handlebars templates server-side. This replaces client-supplied template strings so portal users can never submit arbitrary templates for resolution. When both a reference
+
+```ts
+type TemplatesRef = {
+  page_id?: string
+  block_id?: string
+  config_id?: string
+  global_search_config_id?: string
 }
 ```
 
@@ -12753,6 +12797,12 @@ type EntityGetParams = {
   hydrate?: boolean
   fields?: string[]
   templates?: Record<string, string | Record<string, string>>
+  templates_ref?: {
+    page_id?: string
+    block_id?: string
+    config_id?: string
+    global_search_config_id?: string
+  }
   filters?: object[]
   filters_context?: Record<string, boolean | string>[]
   targets?: string // uuid[]
@@ -12767,6 +12817,12 @@ type EntitySearchParams = {
     slug: string
     targets?: string // uuid[]
     templates?: Record<string, string>
+    templates_ref?: {
+      page_id?: { ... }
+      block_id?: { ... }
+      config_id?: { ... }
+      global_search_config_id?: { ... }
+    }
   }>
   q?: string
   q_fields?: string[]
@@ -12781,6 +12837,12 @@ type EntitySearchParams = {
   hydrate?: boolean
   fields?: string[]
   templates?: Record<string, string>
+  templates_ref?: {
+    page_id?: string
+    block_id?: string
+    config_id?: string
+    global_search_config_id?: string
+  }
   filters?: object[]
   filters_context?: Record<string, boolean | string>[]
   targets?: string // uuid[]

package/docs/validation-rules.md

@@ -62,6 +62,7 @@ const { data } = await validationRulesClient.getValidationRules(...)
 - [`RelativeDateValue`](#relativedatevalue)
 - [`RangeValue`](#rangevalue)
 - [`NoValue`](#novalue)
+- [`AppliesWhen`](#applieswhen)
 - [`ContextRequirement`](#contextrequirement)
 
 ### `getValidationRules`
@@ -675,6 +676,7 @@ type UpdateValidationRuleRequest = {
       operator: { ... }
       value: { ... }
       error_message: { ... }
+      applies_when?: { ... }
       allow_failure?: { ... }
     }>
   }
@@ -729,6 +731,7 @@ type ValidationRuleBase = {
       operator: { ... }
       value: { ... }
       error_message: { ... }
+      applies_when?: { ... }
       allow_failure?: { ... }
     }>
   }
@@ -1696,6 +1699,11 @@ type ComparisonRuleType = {
       source: { ... }
     }
     error_message: string
+    applies_when?: {
+      path: { ... }
+      operator: { ... }
+      value?: { ... }
+    }
     allow_failure?: boolean
   }>
 }
@@ -1719,6 +1727,7 @@ type Condition = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1757,6 +1766,11 @@ type Condition = {
     source: "none"
   }
   error_message: string
+  applies_when?: {
+    path: string
+    operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty"
+    value?: number | string | boolean
+  }
   allow_failure?: boolean
 }
 ```
@@ -1785,8 +1799,13 @@ type ConditionValue = {
   path: string
   adjust?: {
     type: "percent" | "absolute"
-    value: number
+    value: number | {
+      source: { ... }
+      path: { ... }
+      adjust?: { ... }
+    }
     direction: "increase" | "decrease"
+    rounding?: "up" | "down"
   }
 } | {
   source: "relative_date"
@@ -1805,6 +1824,7 @@ type ConditionValue = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1822,6 +1842,7 @@ type ConditionValue = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1847,8 +1868,13 @@ type ScalarValue = {
   path: string
   adjust?: {
     type: "percent" | "absolute"
-    value: number
+    value: number | {
+      source: { ... }
+      path: { ... }
+      adjust?: { ... }
+    }
     direction: "increase" | "decrease"
+    rounding?: "up" | "down"
   }
 } | {
   source: "relative_date"
@@ -1882,8 +1908,13 @@ type ContextValue = {
   path: string
   adjust?: {
     type: "percent" | "absolute"
-    value: number
+    value: number | {
+      source: { ... }
+      path: { ... }
+      adjust?: { ... }
+    }
     direction: "increase" | "decrease"
+    rounding?: "up" | "down"
   }
 }
 ```
@@ -1897,8 +1928,18 @@ Used to express tolerance bands such as "at most 10% above the current instalmen
 ```ts
 type ValueAdjustment = {
   type: "percent" | "absolute"
-  value: number
+  value: number | {
+    source: "context"
+    path: string
+    adjust?: {
+      type: { ... }
+      value: { ... }
+      direction: { ... }
+      rounding?: { ... }
+    }
+  }
   direction: "increase" | "decrease"
+  rounding?: "up" | "down"
 }
 ```
 
@@ -1932,6 +1973,7 @@ type RangeValue = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1949,6 +1991,7 @@ type RangeValue = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1969,6 +2012,22 @@ type NoValue = {
 }
 ```
 
+### `AppliesWhen`
+
+Optional precondition on a condition: the condition only takes part in the
+validation when this comparison over context holds. Examples: apply the
+dual-tariff reference only when `contract.htnt` is not empty, or run a
+plausibility check only when a context value reaches a threshold.
+
+
+```ts
+type AppliesWhen = {
+  path: string
+  operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty"
+  value?: number | string | boolean
+}
+```
+
 ### `ContextRequirement`
 
 An entity context source the rule needs at evaluation time, referenced by `context`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.18.24",
+  "version": "2.18.26",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",