@epilot/sdk 2.18.13 → 2.18.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (136) hide show
  1. package/definitions/calendar.json +25 -25
  2. package/definitions/validation-rules-runtime.json +1 -1
  3. package/definitions/validation-rules.json +840 -37
  4. package/dist/apis/access-token.cjs +6 -6
  5. package/dist/apis/access-token.js +1 -1
  6. package/dist/apis/address-suggestions.cjs +6 -6
  7. package/dist/apis/address-suggestions.js +1 -1
  8. package/dist/apis/address.cjs +6 -6
  9. package/dist/apis/address.js +1 -1
  10. package/dist/apis/ai-agents.cjs +6 -6
  11. package/dist/apis/ai-agents.js +1 -1
  12. package/dist/apis/app.cjs +6 -6
  13. package/dist/apis/app.js +1 -1
  14. package/dist/apis/audit-logs.cjs +6 -6
  15. package/dist/apis/audit-logs.js +1 -1
  16. package/dist/apis/automation.cjs +6 -6
  17. package/dist/apis/automation.js +1 -1
  18. package/dist/apis/billing.cjs +6 -6
  19. package/dist/apis/billing.js +1 -1
  20. package/dist/apis/blueprint-manifest.cjs +6 -6
  21. package/dist/apis/blueprint-manifest.js +1 -1
  22. package/dist/apis/calendar.cjs +6 -6
  23. package/dist/apis/calendar.d.cts +2 -2
  24. package/dist/apis/calendar.d.ts +2 -2
  25. package/dist/apis/calendar.js +1 -1
  26. package/dist/apis/configuration-hub.cjs +6 -6
  27. package/dist/apis/configuration-hub.js +1 -1
  28. package/dist/apis/consent.cjs +6 -6
  29. package/dist/apis/consent.js +1 -1
  30. package/dist/apis/customer-portal.cjs +6 -6
  31. package/dist/apis/customer-portal.js +1 -1
  32. package/dist/apis/dashboard.cjs +6 -6
  33. package/dist/apis/dashboard.js +1 -1
  34. package/dist/apis/data-governance.cjs +6 -6
  35. package/dist/apis/data-governance.js +1 -1
  36. package/dist/apis/deduplication.cjs +6 -6
  37. package/dist/apis/deduplication.js +1 -1
  38. package/dist/apis/design.cjs +6 -6
  39. package/dist/apis/design.js +1 -1
  40. package/dist/apis/document.cjs +6 -6
  41. package/dist/apis/document.js +1 -1
  42. package/dist/apis/email-settings.cjs +6 -6
  43. package/dist/apis/email-settings.js +1 -1
  44. package/dist/apis/email-template.cjs +6 -6
  45. package/dist/apis/email-template.js +1 -1
  46. package/dist/apis/entity-mapping.cjs +6 -6
  47. package/dist/apis/entity-mapping.js +1 -1
  48. package/dist/apis/entity.cjs +6 -6
  49. package/dist/apis/entity.js +1 -1
  50. package/dist/apis/environments.cjs +6 -6
  51. package/dist/apis/environments.js +1 -1
  52. package/dist/apis/event-catalog.cjs +6 -6
  53. package/dist/apis/event-catalog.js +1 -1
  54. package/dist/apis/file.cjs +6 -6
  55. package/dist/apis/file.js +1 -1
  56. package/dist/apis/iban.cjs +6 -6
  57. package/dist/apis/iban.js +1 -1
  58. package/dist/apis/integration-toolkit.cjs +6 -6
  59. package/dist/apis/integration-toolkit.js +1 -1
  60. package/dist/apis/journey.cjs +6 -6
  61. package/dist/apis/journey.js +1 -1
  62. package/dist/apis/kanban.cjs +6 -6
  63. package/dist/apis/kanban.js +1 -1
  64. package/dist/apis/message.cjs +6 -6
  65. package/dist/apis/message.js +1 -1
  66. package/dist/apis/metering.cjs +6 -6
  67. package/dist/apis/metering.js +1 -1
  68. package/dist/apis/notes.cjs +6 -6
  69. package/dist/apis/notes.js +1 -1
  70. package/dist/apis/notification.cjs +6 -6
  71. package/dist/apis/notification.js +1 -1
  72. package/dist/apis/organization.cjs +6 -6
  73. package/dist/apis/organization.js +1 -1
  74. package/dist/apis/partner-directory.cjs +6 -6
  75. package/dist/apis/partner-directory.js +1 -1
  76. package/dist/apis/permissions.cjs +6 -6
  77. package/dist/apis/permissions.js +1 -1
  78. package/dist/apis/pricing-tier.cjs +6 -6
  79. package/dist/apis/pricing-tier.js +1 -1
  80. package/dist/apis/pricing.cjs +6 -6
  81. package/dist/apis/pricing.js +1 -1
  82. package/dist/apis/purpose.cjs +6 -6
  83. package/dist/apis/purpose.js +1 -1
  84. package/dist/apis/query.cjs +6 -6
  85. package/dist/apis/query.js +1 -1
  86. package/dist/apis/sandbox.cjs +6 -6
  87. package/dist/apis/sandbox.js +1 -1
  88. package/dist/apis/sharing.cjs +6 -6
  89. package/dist/apis/sharing.js +1 -1
  90. package/dist/apis/snapshot.cjs +6 -6
  91. package/dist/apis/snapshot.js +1 -1
  92. package/dist/apis/submission.cjs +6 -6
  93. package/dist/apis/submission.js +1 -1
  94. package/dist/apis/target.cjs +6 -6
  95. package/dist/apis/target.js +1 -1
  96. package/dist/apis/targeting.cjs +6 -6
  97. package/dist/apis/targeting.js +1 -1
  98. package/dist/apis/template-variables.cjs +6 -6
  99. package/dist/apis/template-variables.js +1 -1
  100. package/dist/apis/user.cjs +6 -6
  101. package/dist/apis/user.js +1 -1
  102. package/dist/apis/validation-rules.cjs +8 -8
  103. package/dist/apis/validation-rules.d.cts +2 -2
  104. package/dist/apis/validation-rules.d.ts +2 -2
  105. package/dist/apis/validation-rules.js +2 -2
  106. package/dist/apis/webhooks.cjs +6 -6
  107. package/dist/apis/webhooks.js +1 -1
  108. package/dist/apis/workflow-definition.cjs +6 -6
  109. package/dist/apis/workflow-definition.js +1 -1
  110. package/dist/apis/workflow.cjs +6 -6
  111. package/dist/apis/workflow.js +1 -1
  112. package/dist/{calendar-GJ7UX6PX.cjs → calendar-EMNHW6ME.cjs} +1 -1
  113. package/dist/{calendar-W42TSLFV.js → calendar-PZFEAXYE.js} +1 -1
  114. package/dist/{calendar.d-Cinz1Vzo.d.cts → calendar.d-Cz8R-GJ5.d.cts} +22 -7
  115. package/dist/{calendar.d-Cinz1Vzo.d.ts → calendar.d-Cz8R-GJ5.d.ts} +22 -7
  116. package/dist/{chunk-O2ELDNPK.cjs → chunk-22LE7Q52.cjs} +3 -3
  117. package/dist/{chunk-2UWWI6AM.js → chunk-GSQI3C2W.js} +3 -3
  118. package/dist/chunk-HRSCAD3W.cjs +14 -0
  119. package/dist/chunk-PPX45U34.js +14 -0
  120. package/dist/index.cjs +10 -10
  121. package/dist/index.d.cts +2 -2
  122. package/dist/index.d.ts +2 -2
  123. package/dist/index.js +2 -2
  124. package/dist/validation-rules-CU5JJKDV.cjs +7 -0
  125. package/dist/validation-rules-M2JVIR7U.js +7 -0
  126. package/dist/{validation-rules-runtime-X7M3QE5I.cjs → validation-rules-runtime-DENVKYLF.cjs} +2 -2
  127. package/dist/{validation-rules-runtime-6MRCS5X2.js → validation-rules-runtime-VGLVHV36.js} +1 -1
  128. package/dist/{validation-rules.d-Db5c5zTf.d.cts → validation-rules.d-BBy6Cw2O.d.cts} +519 -46
  129. package/dist/{validation-rules.d-Db5c5zTf.d.ts → validation-rules.d-BBy6Cw2O.d.ts} +519 -46
  130. package/docs/calendar.md +16 -2
  131. package/docs/validation-rules.md +417 -31
  132. package/package.json +1 -1
  133. package/dist/chunk-7IKQIVUS.js +0 -14
  134. package/dist/chunk-JIUTCNTB.cjs +0 -14
  135. package/dist/validation-rules-P6F5P73P.js +0 -7
  136. package/dist/validation-rules-VDU3CIZV.cjs +0 -7
@@ -1,12 +1,110 @@
1
1
  import { OpenAPIClient, Parameters, UnknownParamsObject, AxiosRequestConfig, OperationResponse } from 'openapi-client-axios';
2
2
 
3
3
  /* Auto-copied from validation-rules-client */
4
- /* eslint-disable */
5
-
6
4
 
7
5
 
8
6
  declare namespace Components {
9
7
  namespace Schemas {
8
+ /**
9
+ * Declarative validation rule (schema version v2). Supports predefined comparison operators
10
+ * over number, date and text inputs, with static, dynamic (context path) and relative-date
11
+ * comparison values.
12
+ *
13
+ */
14
+ export interface ComparisonRuleType {
15
+ /**
16
+ * The kind of input value the rule validates. Determines which operators are allowed.
17
+ */
18
+ input_type: "number" | "date" | "text";
19
+ /**
20
+ * The comparisons the input value must satisfy. All blocking conditions must pass
21
+ * for the input to be valid; `allow_failure` conditions are advisory and excluded
22
+ * from the verdict. Must contain at least one condition (enforced at write time).
23
+ *
24
+ */
25
+ conditions: /* A single comparison the input value must satisfy. */ Condition[];
26
+ }
27
+ /**
28
+ * A single comparison the input value must satisfy.
29
+ */
30
+ export interface Condition {
31
+ /**
32
+ * Stable identifier of the condition within the rule, used for editing and error reporting.
33
+ */
34
+ id: string;
35
+ operator: /**
36
+ * Predefined comparison operator. Compatibility (enforced at write time):
37
+ * - number: equal, notEqual, greaterThan, greaterThanInclusive, lessThan, lessThanInclusive, between, regexMatch
38
+ * - date: dateBefore, dateOnOrBefore, dateAfter, dateOnOrAfter, dateBetween, notInFuture, notInPast, regexMatch
39
+ * - text: equal, notEqual, contains, doesNotContain, startsWith, endsWith, regexMatch, lengthBetween,
40
+ * greaterThan, greaterThanInclusive, lessThan, lessThanInclusive, between
41
+ * Range operators (between, dateBetween, lengthBetween) require a `range` value;
42
+ * unary operators (notInFuture, notInPast) require a `none` value; all others require a scalar value.
43
+ * regexMatch validates the raw input string's format and always takes a static string pattern.
44
+ * Numeric comparison operators on text rules parse the input as a number at evaluation time
45
+ * (free-text fields often hold numbers); unparsable input fails the condition.
46
+ *
47
+ */
48
+ Operator;
49
+ value: /* The comparison value of a condition - a scalar, a range of scalars, or nothing (unary operators). */ ConditionValue;
50
+ /**
51
+ * Message shown to the end user when this condition fails.
52
+ */
53
+ error_message: string;
54
+ /**
55
+ * When true, the condition is advisory: it is always evaluated and reported
56
+ * when it fails, but it never takes part in the validity verdict.
57
+ * The input is valid when every blocking (non-advisory) condition passes.
58
+ * A rule whose conditions are all advisory is always valid (warnings only).
59
+ *
60
+ */
61
+ allow_failure?: boolean;
62
+ }
63
+ /**
64
+ * The comparison value of a condition - a scalar, a range of scalars, or nothing (unary operators).
65
+ */
66
+ export type ConditionValue = /* The comparison value of a condition - a scalar, a range of scalars, or nothing (unary operators). */ /* A fixed comparison value. */ StaticValue | /**
67
+ * A dynamic comparison value resolved from runtime context, e.g. `contract.installment_amount`
68
+ * or `previous_reading.value`. The first path segment must match the `name` of a declared
69
+ * context requirement.
70
+ *
71
+ */
72
+ 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;
73
+ /**
74
+ * An entity context source the rule needs at evaluation time, referenced by `context`
75
+ * value paths via the schema slug as their first segment (e.g. `contract.installment_amount`).
76
+ * How the source is resolved (which entity instance) is decided by the consuming surface,
77
+ * not by the rule. Meter reading comparisons use the meter/meter_counter entity schemas
78
+ * (e.g. `meter_counter.current_consumption` for the previous reading value).
79
+ *
80
+ */
81
+ export interface ContextRequirement {
82
+ /**
83
+ * Entity schema slug.
84
+ * example:
85
+ * contract
86
+ */
87
+ schema: string;
88
+ }
89
+ /**
90
+ * A dynamic comparison value resolved from runtime context, e.g. `contract.installment_amount`
91
+ * or `previous_reading.value`. The first path segment must match the `name` of a declared
92
+ * context requirement.
93
+ *
94
+ */
95
+ export interface ContextValue {
96
+ source: "context";
97
+ /**
98
+ * Dot-separated path into the resolved context.
99
+ */
100
+ path: string; // ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)*$
101
+ adjust?: /**
102
+ * Adjusts a context-resolved numeric value before comparison, e.g. "context value plus 10 percent".
103
+ * Used to express tolerance bands such as "at most 10% above the current instalment amount".
104
+ *
105
+ */
106
+ ValueAdjustment;
107
+ }
10
108
  export interface CreateValidationRuleRequest {
11
109
  /**
12
110
  * Title of the validation rule.
@@ -19,12 +117,53 @@ declare namespace Components {
19
117
  /**
20
118
  * Describes where and how a validation rule is applied.
21
119
  */
22
- used_by?: /* Describes where and how a validation rule is applied. */ UsedBy[];
23
- 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;
120
+ used_by?: /**
121
+ * Describes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.
122
+ * example:
123
+ * {
124
+ * "type": "journey",
125
+ * "source_id": "journey-xyz789"
126
+ * }
127
+ */
128
+ UsedBy[];
129
+ 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 | /**
130
+ * Declarative validation rule (schema version v2). Supports predefined comparison operators
131
+ * over number, date and text inputs, with static, dynamic (context path) and relative-date
132
+ * comparison values.
133
+ *
134
+ */
135
+ ComparisonRuleType;
136
+ /**
137
+ * Declares the dynamic context a v2 rule needs at evaluation time.
138
+ * `context` condition values reference these sources by using the schema slug
139
+ * as the first segment of their `path`. Only applicable to v2 rules.
140
+ *
141
+ */
142
+ contexts?: /**
143
+ * An entity context source the rule needs at evaluation time, referenced by `context`
144
+ * value paths via the schema slug as their first segment (e.g. `contract.installment_amount`).
145
+ * How the source is resolved (which entity instance) is decided by the consuming surface,
146
+ * not by the rule. Meter reading comparisons use the meter/meter_counter entity schemas
147
+ * (e.g. `meter_counter.current_consumption` for the previous reading value).
148
+ *
149
+ */
150
+ ContextRequirement[];
24
151
  }
152
+ /**
153
+ * Response envelope for listing all validation rules within an organization.
154
+ */
25
155
  export interface GetValidationRulesResponse {
156
+ /**
157
+ * Flat list of all validation rules belonging to the authenticated organization.
158
+ */
26
159
  results?: /* The Validation rule definition. */ ValidationRule[];
27
160
  }
161
+ /**
162
+ * No comparison value - used by unary operators such as notInFuture / notInPast.
163
+ */
164
+ export interface NoValue {
165
+ source: "none";
166
+ }
28
167
  /**
29
168
  * Condition definition for a numeric-based validation rule (2 levels deep)
30
169
  */
@@ -154,6 +293,20 @@ declare namespace Components {
154
293
  */
155
294
  conditions: /* Condition definition for a numeric-based validation rule (2 levels deep) */ NumericCondition;
156
295
  }
296
+ /**
297
+ * Predefined comparison operator. Compatibility (enforced at write time):
298
+ * - number: equal, notEqual, greaterThan, greaterThanInclusive, lessThan, lessThanInclusive, between, regexMatch
299
+ * - date: dateBefore, dateOnOrBefore, dateAfter, dateOnOrAfter, dateBetween, notInFuture, notInPast, regexMatch
300
+ * - text: equal, notEqual, contains, doesNotContain, startsWith, endsWith, regexMatch, lengthBetween,
301
+ * greaterThan, greaterThanInclusive, lessThan, lessThanInclusive, between
302
+ * Range operators (between, dateBetween, lengthBetween) require a `range` value;
303
+ * unary operators (notInFuture, notInPast) require a `none` value; all others require a scalar value.
304
+ * regexMatch validates the raw input string's format and always takes a static string pattern.
305
+ * Numeric comparison operators on text rules parse the input as a number at evaluation time
306
+ * (free-text fields often hold numbers); unparsable input fails the condition.
307
+ *
308
+ */
309
+ export type Operator = "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "between" | "dateBefore" | "dateOnOrBefore" | "dateAfter" | "dateOnOrAfter" | "dateBetween" | "notInFuture" | "notInPast" | "contains" | "doesNotContain" | "startsWith" | "endsWith" | "regexMatch" | "lengthBetween";
157
310
  /**
158
311
  * Condition definition for a pattern-based validation rule (2 levels deep)
159
312
  */
@@ -311,6 +464,14 @@ declare namespace Components {
311
464
  */
312
465
  conditions: /* Condition definition for a pattern-based validation rule (2 levels deep) */ PatternCondition;
313
466
  }
467
+ /**
468
+ * A lower and upper bound for range operators (between, dateBetween, lengthBetween). Bounds are inclusive.
469
+ */
470
+ export interface RangeValue {
471
+ source: "range";
472
+ min: /* A single comparison value - static, resolved from context, or a relative date. */ ScalarValue;
473
+ max: /* A single comparison value - static, resolved from context, or a relative date. */ ScalarValue;
474
+ }
314
475
  /**
315
476
  * Condition definition for a regex-based validation rule (2 levels deep)
316
477
  */
@@ -370,6 +531,38 @@ declare namespace Components {
370
531
  */
371
532
  conditions: /* Condition definition for a regex-based validation rule (2 levels deep) */ RegexCondition;
372
533
  }
534
+ /**
535
+ * A date relative to the evaluation moment, e.g. "today minus 30 days". Only valid for date rules.
536
+ */
537
+ export interface RelativeDateValue {
538
+ source: "relative_date";
539
+ /**
540
+ * Offset from the anchor. Negative values are in the past, positive in the future, 0 is the anchor itself.
541
+ */
542
+ offset: number;
543
+ unit: "days" | "months" | "years";
544
+ anchor?: "today";
545
+ }
546
+ /**
547
+ * A single comparison value - static, resolved from context, or a relative date.
548
+ */
549
+ export type ScalarValue = /* A single comparison value - static, resolved from context, or a relative date. */ /* A fixed comparison value. */ StaticValue | /**
550
+ * A dynamic comparison value resolved from runtime context, e.g. `contract.installment_amount`
551
+ * or `previous_reading.value`. The first path segment must match the `name` of a declared
552
+ * context requirement.
553
+ *
554
+ */
555
+ ContextValue | /* A date relative to the evaluation moment, e.g. "today minus 30 days". Only valid for date rules. */ RelativeDateValue;
556
+ /**
557
+ * A fixed comparison value.
558
+ */
559
+ export interface StaticValue {
560
+ source: "static";
561
+ /**
562
+ * The literal value. Numbers for numeric comparisons, ISO 8601 date strings for date comparisons, strings for text comparisons.
563
+ */
564
+ data: /* The literal value. Numbers for numeric comparisons, ISO 8601 date strings for date comparisons, strings for text comparisons. */ number | string | boolean;
565
+ }
373
566
  export interface UpdateValidationRuleRequest {
374
567
  /**
375
568
  * Title of the validation rule.
@@ -382,23 +575,63 @@ declare namespace Components {
382
575
  /**
383
576
  * Describes where and how a validation rule is applied.
384
577
  */
385
- used_by?: /* Describes where and how a validation rule is applied. */ UsedBy[];
386
- 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;
578
+ used_by?: /**
579
+ * Describes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.
580
+ * example:
581
+ * {
582
+ * "type": "journey",
583
+ * "source_id": "journey-xyz789"
584
+ * }
585
+ */
586
+ UsedBy[];
587
+ 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 | /**
588
+ * Declarative validation rule (schema version v2). Supports predefined comparison operators
589
+ * over number, date and text inputs, with static, dynamic (context path) and relative-date
590
+ * comparison values.
591
+ *
592
+ */
593
+ ComparisonRuleType;
594
+ /**
595
+ * Declares the dynamic context a v2 rule needs at evaluation time.
596
+ * `context` condition values reference these sources by using the schema slug
597
+ * as the first segment of their `path`. Only applicable to v2 rules.
598
+ *
599
+ */
600
+ contexts?: /**
601
+ * An entity context source the rule needs at evaluation time, referenced by `context`
602
+ * value paths via the schema slug as their first segment (e.g. `contract.installment_amount`).
603
+ * How the source is resolved (which entity instance) is decided by the consuming surface,
604
+ * not by the rule. Meter reading comparisons use the meter/meter_counter entity schemas
605
+ * (e.g. `meter_counter.current_consumption` for the previous reading value).
606
+ *
607
+ */
608
+ ContextRequirement[];
387
609
  }
388
610
  /**
389
- * Describes where and how a validation rule is applied.
611
+ * Describes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.
612
+ * example:
613
+ * {
614
+ * "type": "journey",
615
+ * "source_id": "journey-xyz789"
616
+ * }
390
617
  */
391
618
  export interface UsedBy {
392
619
  /**
393
- * The context in which the rule is used (e.g., journey or entity).
620
+ * The context in which the rule is used - either a journey block or an entity schema attribute.
621
+ * example:
622
+ * journey
394
623
  */
395
624
  type: "journey" | "entity";
396
625
  /**
397
- * Slug of the schema using this rule for entities.
626
+ * Slug of the entity schema using this rule. Only applicable when `type` is `entity`.
627
+ * example:
628
+ * contact
398
629
  */
399
630
  schema_slug?: string;
400
631
  /**
401
- * Source identifier for the usage context.
632
+ * Unique identifier of the source (e.g. journey ID or entity attribute key) that references this rule.
633
+ * example:
634
+ * journey-xyz789
402
635
  */
403
636
  source_id?: string;
404
637
  }
@@ -417,8 +650,37 @@ declare namespace Components {
417
650
  /**
418
651
  * Describes where and how a validation rule is applied.
419
652
  */
420
- used_by?: /* Describes where and how a validation rule is applied. */ UsedBy[];
421
- 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;
653
+ used_by?: /**
654
+ * Describes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.
655
+ * example:
656
+ * {
657
+ * "type": "journey",
658
+ * "source_id": "journey-xyz789"
659
+ * }
660
+ */
661
+ UsedBy[];
662
+ 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 | /**
663
+ * Declarative validation rule (schema version v2). Supports predefined comparison operators
664
+ * over number, date and text inputs, with static, dynamic (context path) and relative-date
665
+ * comparison values.
666
+ *
667
+ */
668
+ ComparisonRuleType;
669
+ /**
670
+ * Declares the dynamic context a v2 rule needs at evaluation time.
671
+ * `context` condition values reference these sources by using the schema slug
672
+ * as the first segment of their `path`. Only applicable to v2 rules.
673
+ *
674
+ */
675
+ contexts?: /**
676
+ * An entity context source the rule needs at evaluation time, referenced by `context`
677
+ * value paths via the schema slug as their first segment (e.g. `contract.installment_amount`).
678
+ * How the source is resolved (which entity instance) is decided by the consuming surface,
679
+ * not by the rule. Meter reading comparisons use the meter/meter_counter entity schemas
680
+ * (e.g. `meter_counter.current_consumption` for the previous reading value).
681
+ *
682
+ */
683
+ ContextRequirement[];
422
684
  /**
423
685
  * Schema version of the validation rule.
424
686
  */
@@ -460,8 +722,47 @@ declare namespace Components {
460
722
  /**
461
723
  * Describes where and how a validation rule is applied.
462
724
  */
463
- used_by?: /* Describes where and how a validation rule is applied. */ UsedBy[];
464
- 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;
725
+ used_by?: /**
726
+ * Describes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.
727
+ * example:
728
+ * {
729
+ * "type": "journey",
730
+ * "source_id": "journey-xyz789"
731
+ * }
732
+ */
733
+ UsedBy[];
734
+ 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 | /**
735
+ * Declarative validation rule (schema version v2). Supports predefined comparison operators
736
+ * over number, date and text inputs, with static, dynamic (context path) and relative-date
737
+ * comparison values.
738
+ *
739
+ */
740
+ ComparisonRuleType;
741
+ /**
742
+ * Declares the dynamic context a v2 rule needs at evaluation time.
743
+ * `context` condition values reference these sources by using the schema slug
744
+ * as the first segment of their `path`. Only applicable to v2 rules.
745
+ *
746
+ */
747
+ contexts?: /**
748
+ * An entity context source the rule needs at evaluation time, referenced by `context`
749
+ * value paths via the schema slug as their first segment (e.g. `contract.installment_amount`).
750
+ * How the source is resolved (which entity instance) is decided by the consuming surface,
751
+ * not by the rule. Meter reading comparisons use the meter/meter_counter entity schemas
752
+ * (e.g. `meter_counter.current_consumption` for the previous reading value).
753
+ *
754
+ */
755
+ ContextRequirement[];
756
+ }
757
+ /**
758
+ * Adjusts a context-resolved numeric value before comparison, e.g. "context value plus 10 percent".
759
+ * Used to express tolerance bands such as "at most 10% above the current instalment amount".
760
+ *
761
+ */
762
+ export interface ValueAdjustment {
763
+ type: "percent" | "absolute";
764
+ value: number;
765
+ direction: "increase" | "decrease";
465
766
  }
466
767
  }
467
768
  }
@@ -473,7 +774,15 @@ declare namespace Paths {
473
774
  export interface PathParameters {
474
775
  ruleId: Parameters.RuleId;
475
776
  }
476
- export type RequestBody = /* Describes where and how a validation rule is applied. */ Components.Schemas.UsedBy;
777
+ export type RequestBody = /**
778
+ * Describes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.
779
+ * example:
780
+ * {
781
+ * "type": "journey",
782
+ * "source_id": "journey-xyz789"
783
+ * }
784
+ */
785
+ Components.Schemas.UsedBy;
477
786
  namespace Responses {
478
787
  export type $200 = /* The Validation rule definition. */ Components.Schemas.ValidationRule;
479
788
  export interface $400 {
@@ -483,6 +792,20 @@ declare namespace Paths {
483
792
  */
484
793
  message?: string;
485
794
  }
795
+ export interface $401 {
796
+ /**
797
+ * example:
798
+ * Unauthorized
799
+ */
800
+ message?: string;
801
+ }
802
+ export interface $403 {
803
+ /**
804
+ * example:
805
+ * Forbidden
806
+ */
807
+ message?: string;
808
+ }
486
809
  export interface $404 {
487
810
  /**
488
811
  * example:
@@ -503,6 +826,34 @@ declare namespace Paths {
503
826
  export type RequestBody = Components.Schemas.CreateValidationRuleRequest;
504
827
  namespace Responses {
505
828
  export type $201 = /* The Validation rule definition. */ Components.Schemas.ValidationRule;
829
+ export interface $400 {
830
+ /**
831
+ * example:
832
+ * Invalid request body
833
+ */
834
+ message?: string;
835
+ }
836
+ export interface $401 {
837
+ /**
838
+ * example:
839
+ * Unauthorized
840
+ */
841
+ message?: string;
842
+ }
843
+ export interface $403 {
844
+ /**
845
+ * example:
846
+ * Forbidden
847
+ */
848
+ message?: string;
849
+ }
850
+ export interface $500 {
851
+ /**
852
+ * example:
853
+ * Unknown API Error
854
+ */
855
+ message?: string;
856
+ }
506
857
  }
507
858
  }
508
859
  namespace DeleteValidationRule {
@@ -515,6 +866,27 @@ declare namespace Paths {
515
866
  namespace Responses {
516
867
  export interface $204 {
517
868
  }
869
+ export interface $401 {
870
+ /**
871
+ * example:
872
+ * Unauthorized
873
+ */
874
+ message?: string;
875
+ }
876
+ export interface $403 {
877
+ /**
878
+ * example:
879
+ * Forbidden
880
+ */
881
+ message?: string;
882
+ }
883
+ export interface $404 {
884
+ /**
885
+ * example:
886
+ * Validation rule not found
887
+ */
888
+ message?: string;
889
+ }
518
890
  export interface $500 {
519
891
  /**
520
892
  * example:
@@ -533,6 +905,20 @@ declare namespace Paths {
533
905
  }
534
906
  namespace Responses {
535
907
  export type $200 = /* The Validation rule definition. */ Components.Schemas.ValidationRule;
908
+ export interface $401 {
909
+ /**
910
+ * example:
911
+ * Unauthorized
912
+ */
913
+ message?: string;
914
+ }
915
+ export interface $403 {
916
+ /**
917
+ * example:
918
+ * Forbidden
919
+ */
920
+ message?: string;
921
+ }
536
922
  export interface $404 {
537
923
  /**
538
924
  * example:
@@ -551,7 +937,7 @@ declare namespace Paths {
551
937
  }
552
938
  namespace GetValidationRules {
553
939
  namespace Responses {
554
- export type $200 = Components.Schemas.GetValidationRulesResponse;
940
+ export type $200 = /* Response envelope for listing all validation rules within an organization. */ Components.Schemas.GetValidationRulesResponse;
555
941
  export interface $400 {
556
942
  /**
557
943
  * example:
@@ -559,6 +945,20 @@ declare namespace Paths {
559
945
  */
560
946
  message?: string;
561
947
  }
948
+ export interface $401 {
949
+ /**
950
+ * example:
951
+ * Unauthorized
952
+ */
953
+ message?: string;
954
+ }
955
+ export interface $403 {
956
+ /**
957
+ * example:
958
+ * Forbidden
959
+ */
960
+ message?: string;
961
+ }
562
962
  export interface $500 {
563
963
  /**
564
964
  * example:
@@ -575,7 +975,15 @@ declare namespace Paths {
575
975
  export interface PathParameters {
576
976
  ruleId: Parameters.RuleId;
577
977
  }
578
- export type RequestBody = /* Describes where and how a validation rule is applied. */ Components.Schemas.UsedBy;
978
+ export type RequestBody = /**
979
+ * Describes where and how a validation rule is applied. Used to track associations between rules and the journeys or entity schemas that reference them.
980
+ * example:
981
+ * {
982
+ * "type": "journey",
983
+ * "source_id": "journey-xyz789"
984
+ * }
985
+ */
986
+ Components.Schemas.UsedBy;
579
987
  namespace Responses {
580
988
  export type $200 = /* The Validation rule definition. */ Components.Schemas.ValidationRule;
581
989
  export interface $400 {
@@ -585,6 +993,20 @@ declare namespace Paths {
585
993
  */
586
994
  message?: string;
587
995
  }
996
+ export interface $401 {
997
+ /**
998
+ * example:
999
+ * Unauthorized
1000
+ */
1001
+ message?: string;
1002
+ }
1003
+ export interface $403 {
1004
+ /**
1005
+ * example:
1006
+ * Forbidden
1007
+ */
1008
+ message?: string;
1009
+ }
588
1010
  export interface $404 {
589
1011
  /**
590
1012
  * example:
@@ -618,6 +1040,27 @@ declare namespace Paths {
618
1040
  */
619
1041
  message?: string;
620
1042
  }
1043
+ export interface $401 {
1044
+ /**
1045
+ * example:
1046
+ * Unauthorized
1047
+ */
1048
+ message?: string;
1049
+ }
1050
+ export interface $403 {
1051
+ /**
1052
+ * example:
1053
+ * Forbidden
1054
+ */
1055
+ message?: string;
1056
+ }
1057
+ export interface $404 {
1058
+ /**
1059
+ * example:
1060
+ * Validation rule not found
1061
+ */
1062
+ message?: string;
1063
+ }
621
1064
  export interface $500 {
622
1065
  /**
623
1066
  * example:
@@ -632,9 +1075,12 @@ declare namespace Paths {
632
1075
 
633
1076
  interface OperationMethods {
634
1077
  /**
635
- * getValidationRules - Get all validation rules by organization Id
1078
+ * getValidationRules - getValidationRules
1079
+ *
1080
+ * Returns all validation rules belonging to the authenticated user's organization.
1081
+ *
1082
+ * Results are returned as a flat list. Use this endpoint to list available rules when configuring journeys or entity schemas.
636
1083
  *
637
- * Gets all validation rules by organization Id
638
1084
  */
639
1085
  'getValidationRules'(
640
1086
  parameters?: Parameters<UnknownParamsObject> | null,
@@ -642,9 +1088,9 @@ interface OperationMethods {
642
1088
  config?: AxiosRequestConfig
643
1089
  ): OperationResponse<Paths.GetValidationRules.Responses.$200>
644
1090
  /**
645
- * createValidationRule - Create Validation Rule
1091
+ * createValidationRule - createValidationRule
646
1092
  *
647
- * Creates a new validation rule
1093
+ * Creates a new validation rule for the authenticated organization.
648
1094
  */
649
1095
  'createValidationRule'(
650
1096
  parameters?: Parameters<UnknownParamsObject> | null,
@@ -652,9 +1098,9 @@ interface OperationMethods {
652
1098
  config?: AxiosRequestConfig
653
1099
  ): OperationResponse<Paths.CreateValidationRule.Responses.$201>
654
1100
  /**
655
- * getValidationRuleById - Get validation rule by ID
1101
+ * getValidationRuleById - getValidationRuleById
656
1102
  *
657
- * Retrieves a specific validation rule by its ID
1103
+ * Retrieves a specific validation rule by its unique ID.
658
1104
  */
659
1105
  'getValidationRuleById'(
660
1106
  parameters?: Parameters<Paths.GetValidationRuleById.PathParameters> | null,
@@ -662,9 +1108,9 @@ interface OperationMethods {
662
1108
  config?: AxiosRequestConfig
663
1109
  ): OperationResponse<Paths.GetValidationRuleById.Responses.$200>
664
1110
  /**
665
- * updateValidationRule - Update Validation Rule (partial update)
1111
+ * updateValidationRule - updateValidationRule
666
1112
  *
667
- * Updates an existing validation rule partially by ID
1113
+ * Partially updates an existing validation rule by ID. Only the fields provided in the request body are updated.
668
1114
  */
669
1115
  'updateValidationRule'(
670
1116
  parameters?: Parameters<Paths.UpdateValidationRule.PathParameters> | null,
@@ -672,9 +1118,9 @@ interface OperationMethods {
672
1118
  config?: AxiosRequestConfig
673
1119
  ): OperationResponse<Paths.UpdateValidationRule.Responses.$200>
674
1120
  /**
675
- * deleteValidationRule - Delete Validation Rule
1121
+ * deleteValidationRule - deleteValidationRule
676
1122
  *
677
- * Deletes a validation rule by ID
1123
+ * Permanently deletes a validation rule by ID. Any journeys or entity attributes referencing this rule should be updated before deletion.
678
1124
  */
679
1125
  'deleteValidationRule'(
680
1126
  parameters?: Parameters<Paths.DeleteValidationRule.PathParameters> | null,
@@ -682,9 +1128,12 @@ interface OperationMethods {
682
1128
  config?: AxiosRequestConfig
683
1129
  ): OperationResponse<Paths.DeleteValidationRule.Responses.$204>
684
1130
  /**
685
- * addUsedByReference - Add a reference to the usedBy array
1131
+ * addUsedByReference - addUsedByReference
1132
+ *
1133
+ * Adds a single `used_by` reference to an existing validation rule.
1134
+ *
1135
+ * Use this endpoint when attaching a validation rule to a journey block or entity attribute to track where the rule is applied.
686
1136
  *
687
- * Adds a single reference to the usedBy array of a validation rule
688
1137
  */
689
1138
  'addUsedByReference'(
690
1139
  parameters?: Parameters<Paths.AddUsedByReference.PathParameters> | null,
@@ -692,9 +1141,12 @@ interface OperationMethods {
692
1141
  config?: AxiosRequestConfig
693
1142
  ): OperationResponse<Paths.AddUsedByReference.Responses.$200>
694
1143
  /**
695
- * removeUsedByReference - Remove a reference from the usedBy array
1144
+ * removeUsedByReference - removeUsedByReference
1145
+ *
1146
+ * Removes a specific `used_by` reference from an existing validation rule.
1147
+ *
1148
+ * Use this endpoint when detaching a validation rule from a journey block or entity attribute.
696
1149
  *
697
- * Removes a specific reference from the usedBy array of a validation rule
698
1150
  */
699
1151
  'removeUsedByReference'(
700
1152
  parameters?: Parameters<Paths.RemoveUsedByReference.PathParameters> | null,
@@ -706,9 +1158,12 @@ interface OperationMethods {
706
1158
  interface PathsDictionary {
707
1159
  ['/v1/validation-rules']: {
708
1160
  /**
709
- * getValidationRules - Get all validation rules by organization Id
1161
+ * getValidationRules - getValidationRules
1162
+ *
1163
+ * Returns all validation rules belonging to the authenticated user's organization.
1164
+ *
1165
+ * Results are returned as a flat list. Use this endpoint to list available rules when configuring journeys or entity schemas.
710
1166
  *
711
- * Gets all validation rules by organization Id
712
1167
  */
713
1168
  'get'(
714
1169
  parameters?: Parameters<UnknownParamsObject> | null,
@@ -716,9 +1171,9 @@ interface PathsDictionary {
716
1171
  config?: AxiosRequestConfig
717
1172
  ): OperationResponse<Paths.GetValidationRules.Responses.$200>
718
1173
  /**
719
- * createValidationRule - Create Validation Rule
1174
+ * createValidationRule - createValidationRule
720
1175
  *
721
- * Creates a new validation rule
1176
+ * Creates a new validation rule for the authenticated organization.
722
1177
  */
723
1178
  'post'(
724
1179
  parameters?: Parameters<UnknownParamsObject> | null,
@@ -728,9 +1183,9 @@ interface PathsDictionary {
728
1183
  }
729
1184
  ['/v1/validation-rules/{ruleId}']: {
730
1185
  /**
731
- * getValidationRuleById - Get validation rule by ID
1186
+ * getValidationRuleById - getValidationRuleById
732
1187
  *
733
- * Retrieves a specific validation rule by its ID
1188
+ * Retrieves a specific validation rule by its unique ID.
734
1189
  */
735
1190
  'get'(
736
1191
  parameters?: Parameters<Paths.GetValidationRuleById.PathParameters> | null,
@@ -738,9 +1193,9 @@ interface PathsDictionary {
738
1193
  config?: AxiosRequestConfig
739
1194
  ): OperationResponse<Paths.GetValidationRuleById.Responses.$200>
740
1195
  /**
741
- * updateValidationRule - Update Validation Rule (partial update)
1196
+ * updateValidationRule - updateValidationRule
742
1197
  *
743
- * Updates an existing validation rule partially by ID
1198
+ * Partially updates an existing validation rule by ID. Only the fields provided in the request body are updated.
744
1199
  */
745
1200
  'patch'(
746
1201
  parameters?: Parameters<Paths.UpdateValidationRule.PathParameters> | null,
@@ -748,9 +1203,9 @@ interface PathsDictionary {
748
1203
  config?: AxiosRequestConfig
749
1204
  ): OperationResponse<Paths.UpdateValidationRule.Responses.$200>
750
1205
  /**
751
- * deleteValidationRule - Delete Validation Rule
1206
+ * deleteValidationRule - deleteValidationRule
752
1207
  *
753
- * Deletes a validation rule by ID
1208
+ * Permanently deletes a validation rule by ID. Any journeys or entity attributes referencing this rule should be updated before deletion.
754
1209
  */
755
1210
  'delete'(
756
1211
  parameters?: Parameters<Paths.DeleteValidationRule.PathParameters> | null,
@@ -760,9 +1215,12 @@ interface PathsDictionary {
760
1215
  }
761
1216
  ['/v1/validation-rules/{ruleId}/used-by']: {
762
1217
  /**
763
- * addUsedByReference - Add a reference to the usedBy array
1218
+ * addUsedByReference - addUsedByReference
1219
+ *
1220
+ * Adds a single `used_by` reference to an existing validation rule.
1221
+ *
1222
+ * Use this endpoint when attaching a validation rule to a journey block or entity attribute to track where the rule is applied.
764
1223
  *
765
- * Adds a single reference to the usedBy array of a validation rule
766
1224
  */
767
1225
  'post'(
768
1226
  parameters?: Parameters<Paths.AddUsedByReference.PathParameters> | null,
@@ -770,9 +1228,12 @@ interface PathsDictionary {
770
1228
  config?: AxiosRequestConfig
771
1229
  ): OperationResponse<Paths.AddUsedByReference.Responses.$200>
772
1230
  /**
773
- * removeUsedByReference - Remove a reference from the usedBy array
1231
+ * removeUsedByReference - removeUsedByReference
1232
+ *
1233
+ * Removes a specific `used_by` reference from an existing validation rule.
1234
+ *
1235
+ * Use this endpoint when detaching a validation rule from a journey block or entity attribute.
774
1236
  *
775
- * Removes a specific reference from the usedBy array of a validation rule
776
1237
  */
777
1238
  'delete'(
778
1239
  parameters?: Parameters<Paths.RemoveUsedByReference.PathParameters> | null,
@@ -785,23 +1246,35 @@ interface PathsDictionary {
785
1246
  type Client = OpenAPIClient<OperationMethods, PathsDictionary>
786
1247
 
787
1248
 
1249
+ type ComparisonRuleType = Components.Schemas.ComparisonRuleType;
1250
+ type Condition = Components.Schemas.Condition;
1251
+ type ConditionValue = Components.Schemas.ConditionValue;
1252
+ type ContextRequirement = Components.Schemas.ContextRequirement;
1253
+ type ContextValue = Components.Schemas.ContextValue;
788
1254
  type CreateValidationRuleRequest = Components.Schemas.CreateValidationRuleRequest;
789
1255
  type GetValidationRulesResponse = Components.Schemas.GetValidationRulesResponse;
1256
+ type NoValue = Components.Schemas.NoValue;
790
1257
  type NumericCondition = Components.Schemas.NumericCondition;
791
1258
  type NumericFactCondition = Components.Schemas.NumericFactCondition;
792
1259
  type NumericNestedCondition = Components.Schemas.NumericNestedCondition;
793
1260
  type NumericRuleType = Components.Schemas.NumericRuleType;
1261
+ type Operator = Components.Schemas.Operator;
794
1262
  type PatternCondition = Components.Schemas.PatternCondition;
795
1263
  type PatternFactCondition = Components.Schemas.PatternFactCondition;
796
1264
  type PatternNestedCondition = Components.Schemas.PatternNestedCondition;
797
1265
  type PatternRuleType = Components.Schemas.PatternRuleType;
1266
+ type RangeValue = Components.Schemas.RangeValue;
798
1267
  type RegexCondition = Components.Schemas.RegexCondition;
799
1268
  type RegexFactCondition = Components.Schemas.RegexFactCondition;
800
1269
  type RegexNestedCondition = Components.Schemas.RegexNestedCondition;
801
1270
  type RegexRuleType = Components.Schemas.RegexRuleType;
1271
+ type RelativeDateValue = Components.Schemas.RelativeDateValue;
1272
+ type ScalarValue = Components.Schemas.ScalarValue;
1273
+ type StaticValue = Components.Schemas.StaticValue;
802
1274
  type UpdateValidationRuleRequest = Components.Schemas.UpdateValidationRuleRequest;
803
1275
  type UsedBy = Components.Schemas.UsedBy;
804
1276
  type ValidationRule = Components.Schemas.ValidationRule;
805
1277
  type ValidationRuleBase = Components.Schemas.ValidationRuleBase;
1278
+ type ValueAdjustment = Components.Schemas.ValueAdjustment;
806
1279
 
807
- export { type Client as C, type GetValidationRulesResponse as G, type NumericCondition as N, type OperationMethods as O, Paths as P, type RegexCondition as R, type UpdateValidationRuleRequest as U, type ValidationRule as V, Components as a, type PathsDictionary as b, type CreateValidationRuleRequest as c, type NumericFactCondition as d, type NumericNestedCondition as e, type NumericRuleType as f, type PatternCondition as g, type PatternFactCondition as h, type PatternNestedCondition as i, type PatternRuleType as j, type RegexFactCondition as k, type RegexNestedCondition as l, type RegexRuleType as m, type UsedBy as n, type ValidationRuleBase as o };
1280
+ 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 };