@epilot/pricing-client 3.61.1 → 3.62.0

package/dist/openapi.d.ts

@@ -203,7 +203,12 @@ declare namespace Components {
              * }
              */
             conditions?: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
             };
         }
         /**
@@ -1029,8 +1034,8 @@ declare namespace Components {
                 /**
                  * Present for a composite price that serves at least one component: the components this
                  * pair is the combination of, each with its variant where one produced it. A conditional
-                 * component with no variant in effect is left out of the composite and is not named here
-                 * (ADR 0048). A component line item carries no reference of its own.
+                 * component with no variant in effect is left out of the composite and is not named here.
+                 * A component line item carries no reference of its own.
                  *
                  */
                 price_components?: /**
@@ -1040,8 +1045,8 @@ declare namespace Components {
                  */
                 CatalogReferenceMember[];
                 /**
-                 * Present when coupons apply to the price. A coupon's `variant` exists only once coupons
-                 * can be conditional.
+                 * Present when coupons apply to the price. Coupons are served as stored, so a coupon member
+                 * carries no `variant`.
                  *
                  */
                 coupons?: /**
@@ -1458,8 +1463,8 @@ declare namespace Components {
                 /**
                  * Present for a composite price that serves at least one component: the components this
                  * pair is the combination of, each with its variant where one produced it. A conditional
-                 * component with no variant in effect is left out of the composite and is not named here
-                 * (ADR 0048). A component line item carries no reference of its own.
+                 * component with no variant in effect is left out of the composite and is not named here.
+                 * A component line item carries no reference of its own.
                  *
                  */
                 price_components?: /**
@@ -1469,8 +1474,8 @@ declare namespace Components {
                  */
                 CatalogReferenceMember[];
                 /**
-                 * Present when coupons apply to the price. A coupon's `variant` exists only once coupons
-                 * can be conditional.
+                 * Present when coupons apply to the price. Coupons are served as stored, so a coupon member
+                 * carries no `variant`.
                  *
                  */
                 coupons?: /**
@@ -1767,8 +1772,8 @@ declare namespace Components {
                 /**
                  * Present for a composite price that serves at least one component: the components this
                  * pair is the combination of, each with its variant where one produced it. A conditional
-                 * component with no variant in effect is left out of the composite and is not named here
-                 * (ADR 0048). A component line item carries no reference of its own.
+                 * component with no variant in effect is left out of the composite and is not named here.
+                 * A component line item carries no reference of its own.
                  *
                  */
                 price_components?: /**
@@ -1778,8 +1783,8 @@ declare namespace Components {
                  */
                 CatalogReferenceMember[];
                 /**
-                 * Present when coupons apply to the price. A coupon's `variant` exists only once coupons
-                 * can be conditional.
+                 * Present when coupons apply to the price. Coupons are served as stored, so a coupon member
+                 * carries no `variant`.
                  *
                  */
                 coupons?: /**
@@ -6906,9 +6911,9 @@ declare namespace Components {
         export type CashbackPeriod = "0" | "12";
         /**
          * One context per entity type, each the authenticated resolve's context and checked against
-         * that type's schema alone. A product resolves against `product`, a price and each of a
-         * composite's components against `price`, and a coupon against `coupon`. A type left out
-         * resolves against an empty context, which serves the `default` variant.
+         * that type's schema alone. A product resolves against `product`, and a price and each of a
+         * composite's components against `price`. A type left out resolves against an empty context,
+         * which serves the `default` variant.
          *
          * example:
          * {
@@ -7379,7 +7384,12 @@ declare namespace Components {
                  * }
                  */
                 _conditions: {
-                    [name: string]: any;
+                    [name: string]: /**
+                     * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                     * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                     *
+                     */
+                    PinnedConditionValue;
                     default: boolean;
                 };
                 /**
@@ -7618,7 +7628,12 @@ declare namespace Components {
                  * }
                  */
                 _conditions: {
-                    [name: string]: any;
+                    [name: string]: /**
+                     * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                     * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                     *
+                     */
+                    PinnedConditionValue;
                     default: boolean;
                 };
                 /**
@@ -7804,7 +7819,12 @@ declare namespace Components {
                  * }
                  */
                 _conditions: {
-                    [name: string]: any;
+                    [name: string]: /**
+                     * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                     * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                     *
+                     */
+                    PinnedConditionValue;
                     default: boolean;
                 };
                 /**
@@ -8134,8 +8154,8 @@ declare namespace Components {
             /**
              * Present for a composite price that serves at least one component: the components this
              * pair is the combination of, each with its variant where one produced it. A conditional
-             * component with no variant in effect is left out of the composite and is not named here
-             * (ADR 0048). A component line item carries no reference of its own.
+             * component with no variant in effect is left out of the composite and is not named here.
+             * A component line item carries no reference of its own.
              *
              */
             price_components?: /**
@@ -8145,8 +8165,8 @@ declare namespace Components {
              */
             CatalogReferenceMember[];
             /**
-             * Present when coupons apply to the price. A coupon's `variant` exists only once coupons
-             * can be conditional.
+             * Present when coupons apply to the price. Coupons are served as stored, so a coupon member
+             * carries no `variant`.
              *
              */
             coupons?: /**
@@ -9937,8 +9957,8 @@ declare namespace Components {
                 /**
                  * Present for a composite price that serves at least one component: the components this
                  * pair is the combination of, each with its variant where one produced it. A conditional
-                 * component with no variant in effect is left out of the composite and is not named here
-                 * (ADR 0048). A component line item carries no reference of its own.
+                 * component with no variant in effect is left out of the composite and is not named here.
+                 * A component line item carries no reference of its own.
                  *
                  */
                 price_components?: /**
@@ -9948,8 +9968,8 @@ declare namespace Components {
                  */
                 CatalogReferenceMember[];
                 /**
-                 * Present when coupons apply to the price. A coupon's `variant` exists only once coupons
-                 * can be conditional.
+                 * Present when coupons apply to the price. Coupons are served as stored, so a coupon member
+                 * carries no `variant`.
                  *
                  */
                 coupons?: /**
@@ -10637,8 +10657,8 @@ declare namespace Components {
                 /**
                  * Present for a composite price that serves at least one component: the components this
                  * pair is the combination of, each with its variant where one produced it. A conditional
-                 * component with no variant in effect is left out of the composite and is not named here
-                 * (ADR 0048). A component line item carries no reference of its own.
+                 * component with no variant in effect is left out of the composite and is not named here.
+                 * A component line item carries no reference of its own.
                  *
                  */
                 price_components?: /**
@@ -10648,8 +10668,8 @@ declare namespace Components {
                  */
                 CatalogReferenceMember[];
                 /**
-                 * Present when coupons apply to the price. A coupon's `variant` exists only once coupons
-                 * can be conditional.
+                 * Present when coupons apply to the price. Coupons are served as stored, so a coupon member
+                 * carries no `variant`.
                  *
                  */
                 coupons?: /**
@@ -11086,6 +11106,23 @@ declare namespace Components {
         export interface ComputedPriceComponents {
             [name: string]: /* The computed price */ ComputedBasePrice;
         }
+        /**
+         * The value of a `daterange` condition. A bound that is absent, `null` or an empty string is an
+         * open end; stored, an open end is an empty string.
+         *
+         */
+        export interface ConditionDateRange {
+            /**
+             * example:
+             * 2026-01-01
+             */
+            from?: string | null;
+            /**
+             * example:
+             * 2027-01-01
+             */
+            until?: string | null;
+        }
         /**
          * One condition dimension, in the shape a schema's `conditions` array holds it — copy it in verbatim.
          */
@@ -11153,6 +11190,30 @@ declare namespace Components {
              */
             format?: "postal_code" | "postal_code_city";
         }
+        /**
+         * A single-operator predicate.
+         */
+        export type ConditionPredicate = /* A single-operator predicate. */ {
+            lt: /* A number, or a date as an RFC 3339 date or date-time. */ OrderedConditionOperand;
+        } | {
+            lte: /* A number, or a date as an RFC 3339 date or date-time. */ OrderedConditionOperand;
+        } | {
+            gt: /* A number, or a date as an RFC 3339 date or date-time. */ OrderedConditionOperand;
+        } | {
+            gte: /* A number, or a date as an RFC 3339 date or date-time. */ OrderedConditionOperand;
+        } | {
+            in: [
+                (string | number),
+                ...(string | number)[]
+            ];
+        } | {
+            /**
+             * The instant a `daterange` condition's range must contain.
+             */
+            between: string;
+        } | {
+            exists: boolean;
+        };
         /**
          * A named bundle of condition definitions, built in for one entity type.
          */
@@ -12936,6 +12997,26 @@ declare namespace Components {
             status: "PROVISIONING" | "ACTIVE";
         }
         export type ConsumptionTypeGetAg = "household" | "heating_pump" | "night_storage_heating" | "night_storage_heating_common_meter";
+        /**
+         * One condition's value in a resolve context or listing filter: an exact value, or a predicate.
+         * Which of these a condition takes is set by its type in the entity's schema, and a value of
+         * another shape is refused with `CONTEXT_FORMAT_INVALID`, or `OPERATOR_UNSUPPORTED` for a
+         * predicate its type does not support.
+         *
+         */
+        export type ContextConditionValue = /**
+         * One condition's value in a resolve context or listing filter: an exact value, or a predicate.
+         * Which of these a condition takes is set by its type in the entity's schema, and a value of
+         * another shape is refused with `CONTEXT_FORMAT_INVALID`, or `OPERATOR_UNSUPPORTED` for a
+         * predicate its type does not support.
+         *
+         */
+        string | number | boolean | /**
+         * The value of a `location` condition of format `postal_code_city`, its parts named as an entity
+         * address names them.
+         *
+         */
+        PostalCodeCity | /* A single-operator predicate. */ ConditionPredicate;
         /**
          * The coupon entity
          * example:
@@ -13357,7 +13438,12 @@ declare namespace Components {
              * }
              */
             conditions: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
                 default: boolean;
             };
             /**
@@ -16153,6 +16239,10 @@ declare namespace Components {
          *
          */
         export type OrderStatus = "draft" | "quote" | "placed" | "cancelled" | "completed";
+        /**
+         * A number, or a date as an RFC 3339 date or date-time.
+         */
+        export type OrderedConditionOperand = /* A number, or a date as an RFC 3339 date or date-time. */ number | string;
         export interface PatchVersionRequest {
             /**
              * Only the overrides to change; everything not mentioned is left as stored. `null` sets a
@@ -16187,7 +16277,12 @@ declare namespace Components {
              * }
              */
             conditions?: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
             };
         }
         /**
@@ -16206,6 +16301,27 @@ declare namespace Components {
                 [name: string]: any;
             };
         }
+        /**
+         * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+         * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+         *
+         */
+        export type PinnedConditionValue = /**
+         * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+         * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+         *
+         */
+        string | number | boolean | /**
+         * The value of a `daterange` condition. A bound that is absent, `null` or an empty string is an
+         * open end; stored, an open end is an empty string.
+         *
+         */
+        ConditionDateRange | /**
+         * The value of a `location` condition of format `postal_code_city`, its parts named as an entity
+         * address names them.
+         *
+         */
+        PostalCodeCity;
         /**
          * The situation this variant applies to: a flat map keyed by condition name. A condition left
          * out is a wildcard, which is what makes adding a condition to a schema non-breaking for
@@ -16225,7 +16341,12 @@ declare namespace Components {
          * }
          */
         export interface PinnedConditions {
-            [name: string]: any;
+            [name: string]: /**
+             * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+             * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+             *
+             */
+            PinnedConditionValue;
         }
         /**
          * The options a pinned resolve accepts — `hydrate` and nothing else. `resolve_one` has nothing
@@ -16307,6 +16428,23 @@ declare namespace Components {
                 journey_target_block?: string;
             }[];
         }
+        /**
+         * The value of a `location` condition of format `postal_code_city`, its parts named as an entity
+         * address names them.
+         *
+         */
+        export interface PostalCodeCity {
+            /**
+             * example:
+             * 50667
+             */
+            postal_code: string;
+            /**
+             * example:
+             * Köln
+             */
+            city: string;
+        }
         /**
          * Market area details for power
          */
@@ -17170,8 +17308,8 @@ declare namespace Components {
                 /**
                  * Present for a composite price that serves at least one component: the components this
                  * pair is the combination of, each with its variant where one produced it. A conditional
-                 * component with no variant in effect is left out of the composite and is not named here
-                 * (ADR 0048). A component line item carries no reference of its own.
+                 * component with no variant in effect is left out of the composite and is not named here.
+                 * A component line item carries no reference of its own.
                  *
                  */
                 price_components?: /**
@@ -17181,8 +17319,8 @@ declare namespace Components {
                  */
                 CatalogReferenceMember[];
                 /**
-                 * Present when coupons apply to the price. A coupon's `variant` exists only once coupons
-                 * can be conditional.
+                 * Present when coupons apply to the price. Coupons are served as stored, so a coupon member
+                 * carries no `variant`.
                  *
                  */
                 coupons?: /**
@@ -17657,8 +17795,8 @@ declare namespace Components {
                 /**
                  * Present for a composite price that serves at least one component: the components this
                  * pair is the combination of, each with its variant where one produced it. A conditional
-                 * component with no variant in effect is left out of the composite and is not named here
-                 * (ADR 0048). A component line item carries no reference of its own.
+                 * component with no variant in effect is left out of the composite and is not named here.
+                 * A component line item carries no reference of its own.
                  *
                  */
                 price_components?: /**
@@ -17668,8 +17806,8 @@ declare namespace Components {
                  */
                 CatalogReferenceMember[];
                 /**
-                 * Present when coupons apply to the price. A coupon's `variant` exists only once coupons
-                 * can be conditional.
+                 * Present when coupons apply to the price. Coupons are served as stored, so a coupon member
+                 * carries no `variant`.
                  *
                  */
                 coupons?: /**
@@ -19496,7 +19634,12 @@ declare namespace Components {
              * }
              */
             conditions?: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
             };
         }
         /**
@@ -20323,9 +20466,9 @@ declare namespace Components {
             ];
             context: /**
              * One context per entity type, each the authenticated resolve's context and checked against
-             * that type's schema alone. A product resolves against `product`, a price and each of a
-             * composite's components against `price`, and a coupon against `coupon`. A type left out
-             * resolves against an empty context, which serves the `default` variant.
+             * that type's schema alone. A product resolves against `product`, and a price and each of a
+             * composite's components against `price`. A type left out resolves against an empty context,
+             * which serves the `default` variant.
              *
              * example:
              * {
@@ -20422,7 +20565,14 @@ declare namespace Components {
          * }
          */
         export interface ResolveContext {
-            [name: string]: any;
+            [name: string]: /**
+             * One condition's value in a resolve context or listing filter: an exact value, or a predicate.
+             * Which of these a condition takes is set by its type in the entity's schema, and a value of
+             * another shape is refused with `CONTEXT_FORMAT_INVALID`, or `OPERATOR_UNSUPPORTED` for a
+             * predicate its type does not support.
+             *
+             */
+            ContextConditionValue;
         }
         /**
          * The options a context resolve accepts. A pin takes `PinnedResolveOptions` instead.
@@ -20449,8 +20599,7 @@ declare namespace Components {
          * The components of a composite price as the v2 catalog serves them: hydrated in place, and
          * a component that is itself conditional resolved against the same context, carrying the
          * discriminators a resolved payload carries. A conditional component with no variant in
-         * effect — nothing matches and there is no default — is left out, as a deleted component is
-         * (ADR 0048).
+         * effect — nothing matches and there is no default — is left out, as a deleted component is.
          *
          */
         export interface ResolvedPriceComponents {
@@ -20657,7 +20806,12 @@ declare namespace Components {
                  * }
                  */
                 _conditions: {
-                    [name: string]: any;
+                    [name: string]: /**
+                     * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                     * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                     *
+                     */
+                    PinnedConditionValue;
                     default: boolean;
                 };
                 /**
@@ -20737,7 +20891,12 @@ declare namespace Components {
              * }
              */
             _conditions: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
                 default: boolean;
             };
             /**
@@ -21172,7 +21331,14 @@ declare namespace Components {
          * }
          */
         export interface VariantConditionFilter {
-            [name: string]: any;
+            [name: string]: /**
+             * One condition's value in a resolve context or listing filter: an exact value, or a predicate.
+             * Which of these a condition takes is set by its type in the entity's schema, and a value of
+             * another shape is refused with `CONTEXT_FORMAT_INVALID`, or `OPERATOR_UNSUPPORTED` for a
+             * predicate its type does not support.
+             *
+             */
+            ContextConditionValue;
         }
         /**
          * A variant's pinned conditions as a reader sees them: the pins the schema declares, plus a
@@ -21185,7 +21351,12 @@ declare namespace Components {
          * }
          */
         export interface VariantConditions {
-            [name: string]: any;
+            [name: string]: /**
+             * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+             * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+             *
+             */
+            PinnedConditionValue;
             default: boolean;
         }
         export interface VariantList {
@@ -21231,7 +21402,12 @@ declare namespace Components {
              * }
              */
             conditions: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
                 default: boolean;
             };
         }
@@ -21359,7 +21535,12 @@ declare namespace Components {
              * }
              */
             conditions: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
                 default: boolean;
             };
             status: /**
@@ -21398,7 +21579,12 @@ declare namespace Components {
                  * }
                  */
                 conditions: {
-                    [name: string]: any;
+                    [name: string]: /**
+                     * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                     * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                     *
+                     */
+                    PinnedConditionValue;
                     default: boolean;
                 };
                 /**
@@ -21502,7 +21688,12 @@ declare namespace Components {
              * }
              */
             conditions: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
                 default: boolean;
             };
             /**
@@ -21598,7 +21789,12 @@ declare namespace Components {
              * }
              */
             conditions: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
                 default: boolean;
             };
             /**
@@ -21746,7 +21942,12 @@ declare namespace Components {
              * }
              */
             conditions: {
-                [name: string]: any;
+                [name: string]: /**
+                 * One condition's exact value. Which of these shapes a condition takes is set by its type in the
+                 * entity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.
+                 *
+                 */
+                PinnedConditionValue;
                 default: boolean;
             };
             /**
@@ -25548,7 +25749,9 @@ export type ComputePriceResult = Components.Schemas.ComputePriceResult;
 export type ComputedBasePrice = Components.Schemas.ComputedBasePrice;
 export type ComputedPriceBreakdown = Components.Schemas.ComputedPriceBreakdown;
 export type ComputedPriceComponents = Components.Schemas.ComputedPriceComponents;
+export type ConditionDateRange = Components.Schemas.ConditionDateRange;
 export type ConditionDefinition = Components.Schemas.ConditionDefinition;
+export type ConditionPredicate = Components.Schemas.ConditionPredicate;
 export type ConditionSet = Components.Schemas.ConditionSet;
 export type ConditionSetCatalog = Components.Schemas.ConditionSetCatalog;
 export type ConditionType = Components.Schemas.ConditionType;
@@ -25557,6 +25760,7 @@ export type ConditionalPricingError = Components.Schemas.ConditionalPricingError
 export type ConditionalPricingErrorCode = Components.Schemas.ConditionalPricingErrorCode;
 export type ConditionalPricingOptIn = Components.Schemas.ConditionalPricingOptIn;
 export type ConsumptionTypeGetAg = Components.Schemas.ConsumptionTypeGetAg;
+export type ContextConditionValue = Components.Schemas.ContextConditionValue;
 export type Coupon = Components.Schemas.Coupon;
 export type CouponItem = Components.Schemas.CouponItem;
 export type CouponWithoutPromoCodes = Components.Schemas.CouponWithoutPromoCodes;
@@ -25614,11 +25818,14 @@ export type OrderPayload = Components.Schemas.OrderPayload;
 export type OrderRelation = Components.Schemas.OrderRelation;
 export type OrderSource = Components.Schemas.OrderSource;
 export type OrderStatus = Components.Schemas.OrderStatus;
+export type OrderedConditionOperand = Components.Schemas.OrderedConditionOperand;
 export type PatchVersionRequest = Components.Schemas.PatchVersionRequest;
 export type PaymentMethod = Components.Schemas.PaymentMethod;
+export type PinnedConditionValue = Components.Schemas.PinnedConditionValue;
 export type PinnedConditions = Components.Schemas.PinnedConditions;
 export type PinnedResolveOptions = Components.Schemas.PinnedResolveOptions;
 export type PortalContext = Components.Schemas.PortalContext;
+export type PostalCodeCity = Components.Schemas.PostalCodeCity;
 export type PowerMarketAreaDetails = Components.Schemas.PowerMarketAreaDetails;
 export type PowerMeterType = Components.Schemas.PowerMeterType;
 export type Price = Components.Schemas.Price;

package/dist/openapi.json

@@ -6134,7 +6134,9 @@
       },
       "ResolveContext": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": {
+          "$ref": "#/components/schemas/ContextConditionValue"
+        },
         "description": "The situation to resolve for: a flat map keyed by condition name. A condition left out\nmatches only variants that leave it unpinned; an empty map therefore returns the `default`\nvariant.\n\nEach value is an exact value, typed by its condition, or a single-operator predicate:\n\n- `{ \"lt\": v }`, `{ \"lte\": v }`, `{ \"gt\": v }`, `{ \"gte\": v }` — order, against a `number`\n  or `date` condition\n- `{ \"in\": [...] }` — membership, against a `string`, `select` or `number` condition\n- `{ \"between\": \"2026-03-01\" }` — `daterange` containment, which a plain date also means\n- `{ \"exists\": true }` — pinned to any value; `{ \"exists\": false }` — left unpinned\n\nAn `in` list carries at most 50,000 values. A `string` or `select` matches exactly and\ncase-sensitively. A `location` of format\n`postal_code` is the postal code itself; one of format `postal_code_city` is an object carrying\n`postal_code` and `city`, named as an entity address names them, whose city is compared\ncase- and whitespace-insensitively.\n\n`default` and names beginning with `_` are reserved and cannot be supplied.\n",
         "example": {
           "postal_code": "46045",
@@ -6258,7 +6260,9 @@
       },
       "VariantConditions": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": {
+          "$ref": "#/components/schemas/PinnedConditionValue"
+        },
         "required": [
           "default"
         ],
@@ -6275,12 +6279,204 @@
       },
       "PinnedConditions": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": {
+          "$ref": "#/components/schemas/PinnedConditionValue"
+        },
         "description": "The situation this variant applies to: a flat map keyed by condition name. A condition left\nout is a wildcard, which is what makes adding a condition to a schema non-breaking for\nexisting variants.\n\nExact values only; predicates belong to reads. Values are stored canonicalized for their\ntype: a `date` becomes millisecond-precision UTC, a `daterange` an object carrying `from`\nand `until` where an empty string is an open end, a `location` of format `postal_code` the\npostal code itself and one of format `postal_code_city` an object carrying `postal_code` and\n`city`.\n\n`default` and names beginning with `_` are reserved; use the request's `default` flag.\n",
         "example": {
           "postal_code": "46045"
         }
       },
+      "PinnedConditionValue": {
+        "description": "One condition's exact value. Which of these shapes a condition takes is set by its type in the\nentity's schema, and a value of another shape is refused with `PIN_FORMAT_INVALID`.\n",
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "number"
+          },
+          {
+            "type": "boolean"
+          },
+          {
+            "$ref": "#/components/schemas/ConditionDateRange"
+          },
+          {
+            "$ref": "#/components/schemas/PostalCodeCity"
+          }
+        ]
+      },
+      "ConditionDateRange": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "The value of a `daterange` condition. A bound that is absent, `null` or an empty string is an\nopen end; stored, an open end is an empty string.\n",
+        "properties": {
+          "from": {
+            "type": "string",
+            "nullable": true,
+            "example": "2026-01-01"
+          },
+          "until": {
+            "type": "string",
+            "nullable": true,
+            "example": "2027-01-01"
+          }
+        }
+      },
+      "PostalCodeCity": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "The value of a `location` condition of format `postal_code_city`, its parts named as an entity\naddress names them.\n",
+        "required": [
+          "postal_code",
+          "city"
+        ],
+        "properties": {
+          "postal_code": {
+            "type": "string",
+            "minLength": 1,
+            "example": "50667"
+          },
+          "city": {
+            "type": "string",
+            "minLength": 1,
+            "example": "Köln"
+          }
+        }
+      },
+      "ContextConditionValue": {
+        "description": "One condition's value in a resolve context or listing filter: an exact value, or a predicate.\nWhich of these a condition takes is set by its type in the entity's schema, and a value of\nanother shape is refused with `CONTEXT_FORMAT_INVALID`, or `OPERATOR_UNSUPPORTED` for a\npredicate its type does not support.\n",
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "number"
+          },
+          {
+            "type": "boolean"
+          },
+          {
+            "$ref": "#/components/schemas/PostalCodeCity"
+          },
+          {
+            "$ref": "#/components/schemas/ConditionPredicate"
+          }
+        ]
+      },
+      "ConditionPredicate": {
+        "description": "A single-operator predicate.",
+        "oneOf": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "lt"
+            ],
+            "properties": {
+              "lt": {
+                "$ref": "#/components/schemas/OrderedConditionOperand"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "lte"
+            ],
+            "properties": {
+              "lte": {
+                "$ref": "#/components/schemas/OrderedConditionOperand"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "gt"
+            ],
+            "properties": {
+              "gt": {
+                "$ref": "#/components/schemas/OrderedConditionOperand"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "gte"
+            ],
+            "properties": {
+              "gte": {
+                "$ref": "#/components/schemas/OrderedConditionOperand"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "in"
+            ],
+            "properties": {
+              "in": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "number"
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "between"
+            ],
+            "properties": {
+              "between": {
+                "type": "string",
+                "description": "The instant a `daterange` condition's range must contain."
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "exists"
+            ],
+            "properties": {
+              "exists": {
+                "type": "boolean"
+              }
+            }
+          }
+        ]
+      },
+      "OrderedConditionOperand": {
+        "description": "A number, or a date as an RFC 3339 date or date-time.",
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "string"
+          }
+        ]
+      },
       "VariantValues": {
         "type": "object",
         "additionalProperties": true,
@@ -6907,7 +7103,9 @@
       },
       "VariantConditionFilter": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": {
+          "$ref": "#/components/schemas/ContextConditionValue"
+        },
         "description": "Which pins a variant must carry to be listed: a flat map keyed by condition name, taking the\nsame exact values and predicates a resolve context does. A condition left out is not\nfiltered on. An `in` list carries at most 50,000 values.\n\nA variant matches only where it pins the condition — unlike `:resolve`, where an unpinned\ncondition matches any value. `{ \"exists\": false }` selects the variants that leave it\nunpinned.\n\n`default` is accepted as an exact boolean and takes no predicate: `true` selects the\nentity's fallback variant, `false` every variant that is not it. Names beginning with `_`\nare reserved.\n",
         "example": {
           "postal_code": "46045",
@@ -11276,7 +11474,7 @@
       "CatalogContext": {
         "type": "object",
         "additionalProperties": false,
-        "description": "One context per entity type, each the authenticated resolve's context and checked against\nthat type's schema alone. A product resolves against `product`, a price and each of a\ncomposite's components against `price`, and a coupon against `coupon`. A type left out\nresolves against an empty context, which serves the `default` variant.\n",
+        "description": "One context per entity type, each the authenticated resolve's context and checked against\nthat type's schema alone. A product resolves against `product`, and a price and each of a\ncomposite's components against `price`. A type left out resolves against an empty context,\nwhich serves the `default` variant.\n",
         "properties": {
           "product": {
             "$ref": "#/components/schemas/ResolveContext"
@@ -11424,7 +11622,7 @@
       },
       "ResolvedPriceComponents": {
         "type": "object",
-        "description": "The components of a composite price as the v2 catalog serves them: hydrated in place, and\na component that is itself conditional resolved against the same context, carrying the\ndiscriminators a resolved payload carries. A conditional component with no variant in\neffect — nothing matches and there is no default — is left out, as a deleted component is\n(ADR 0048).\n",
+        "description": "The components of a composite price as the v2 catalog serves them: hydrated in place, and\na component that is itself conditional resolved against the same context, carrying the\ndiscriminators a resolved payload carries. A conditional component with no variant in\neffect — nothing matches and there is no default — is left out, as a deleted component is.\n",
         "properties": {
           "price_components": {
             "type": "array",
@@ -11575,14 +11773,14 @@
           },
           "price_components": {
             "type": "array",
-            "description": "Present for a composite price that serves at least one component: the components this\npair is the combination of, each with its variant where one produced it. A conditional\ncomponent with no variant in effect is left out of the composite and is not named here\n(ADR 0048). A component line item carries no reference of its own.\n",
+            "description": "Present for a composite price that serves at least one component: the components this\npair is the combination of, each with its variant where one produced it. A conditional\ncomponent with no variant in effect is left out of the composite and is not named here.\nA component line item carries no reference of its own.\n",
             "items": {
               "$ref": "#/components/schemas/CatalogReferenceMember"
             }
           },
           "coupons": {
             "type": "array",
-            "description": "Present when coupons apply to the price. A coupon's `variant` exists only once coupons\ncan be conditional.\n",
+            "description": "Present when coupons apply to the price. Coupons are served as stored, so a coupon member\ncarries no `variant`.\n",
             "items": {
               "$ref": "#/components/schemas/CatalogReferenceMember"
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/pricing-client",
-  "version": "3.61.1",
+  "version": "3.62.0",
   "description": "Client for epilot Pricing APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",