@v-office/website-sdk 2.16.0 → 2.16.2

package/dist/cli.mjs

@@ -16,7 +16,7 @@ var CLICheckFailed = class extends Error {
 const toCLIError = (message, cause) => cause instanceof Error ? new CLICheckFailed(`${message}: ${cause.message}`, { cause }) : new CLICheckFailed(message, { cause });
 //#endregion
 //#region package.json
-var version = "2.16.0";
+var version = "2.16.2";
 //#endregion
 //#region src/cli/output.ts
 const toJson = (value) => Effect.try({

package/dist/instructions/CHANGELOG.md

@@ -4,6 +4,8 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.16.2/CHANGELOG.md`: `@v-office/website-sdk` 2.16.2 documentation release notes.
+- `versions/2.16.1/CHANGELOG.md`: `@v-office/website-sdk` 2.16.1 release notes.
 - `versions/2.16.0/CHANGELOG.md`: `@v-office/website-sdk` 2.16.0 release notes.
 - `versions/2.15.0/CHANGELOG.md`: `@v-office/website-sdk` 2.15.0 release notes.
 - `versions/2.14.0/CHANGELOG.md`: `@v-office/website-sdk` 2.14.0 release notes.

package/dist/instructions/MIGRATION.md

@@ -4,6 +4,8 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
+- `versions/2.16.2/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.16.1 to 2.16.2.
+- `versions/2.16.1/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.16.0 to 2.16.1.
 - `versions/2.16.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.15.0 to 2.16.0.
 - `versions/2.15.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.14.0 to 2.15.0.
 - `versions/2.14.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.13.0 to 2.14.0.

package/dist/instructions/README.md

@@ -1,7 +1,7 @@
 # Website SDK Instructions
 
 These instructions describe the current source targeted for
-`@v-office/website-sdk` 2.16.0. Package versions remain unchanged until the release
+`@v-office/website-sdk` 2.16.2. Package versions remain unchanged until the release
 workflow performs the coordinated core and website bumps.
 
 Use this directory as the consumer-facing reference for the package:
@@ -18,6 +18,10 @@ Use this directory as the consumer-facing reference for the package:
 - `document-structured-json.md`: `sdk.static.documents.getTermsAndPrivacyPolicy` and structured document JSON rendering rules.
 - `CHANGELOG.md`: versioned changelog index.
 - `MIGRATION.md`: versioned migration index.
+- `versions/2.16.2/`: 2.16.2 documentation release notes and migration guide.
+- `versions/2.16.1/`: 2.16.1 v10 multi-rate resolution restricted to rent rates,
+  restored additional-service availability, and the 2.16.0-to-2.16.1 migration
+  guide.
 - `versions/2.16.0/`: 2.16.0 machine-readable unavailable quote codes,
   multi-rate configuration diagnostics, and the 2.15.0-to-2.16.0 migration
   guide.
@@ -96,5 +100,5 @@ website-sdk --backend v10 search --locale de-DE --query "adults=2" --sort '{"by"
 ```
 
 Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced
-in 2.0.0 and kept in 2.16.0. v10 config additionally requires `searchEndpoint` as
+in 2.0.0 and kept in 2.16.2. v10 config additionally requires `searchEndpoint` as
 of 2.5.0.

package/dist/instructions/quote.md

@@ -310,6 +310,8 @@ if (cleared.ok) quote = cleared.quote;
 
 Each successful change returns a new quote with recalculated `bookingCardInformation.total`. v10 can mark unavailable service/policy combinations with `available: false` and `unavailableReason`; disable those options in the UI. Handle `{ ok: false, error }` for unknown service ids, quantity limits, or `UnavailableQuoteCombination`.
 
+From 2.16.1, v10 resolves the multi-rate from rent rates only. Additional services are priced on top of the resolved multi-rate and no longer make it unresolvable, so they are no longer reported unavailable for that reason.
+
 ## Cancellation Policies
 
 Cancellation policies are exposed on `quote.cancellationPolicies` when the backend offers selectable policies.

package/dist/instructions/versions/2.16.1/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog: 2.16.1
+
+This release restores v10 additional-service selection. Services whose rate type
+took part in multi-rate resolution were reported unavailable and could not be
+added to a quote.
+
+## Fixed
+
+- v10 multi-rate resolution now considers `RENT` rates only. Additional services
+  no longer take part in resolving the multi-rate of the default cancellation
+  policy.
+- v10 additional services are reported with `available: true` again instead of
+  `available: false` plus an unavailable-combination `unavailableReason`.
+- `sdk.live.quote.addAdditionalService` no longer fails with
+  `UnavailableQuoteCombination` for those services, and the quote total rises by
+  the service charge as expected.
+- v10 quotes no longer report `code: "UnresolvableMultiRate"` merely because a
+  priced additional service was listed next to the rent.
+
+## Changed
+
+- `@v-office/sdk-core` was upgraded to 1.16.1.
+- Resolution falls back to the `baseRentRate` multi-rate of the cancellation
+  policy. That is the variant a guest quote request actually specifies, because
+  the request carries no service selection and the backend returns no multi-rate
+  id for it. Selecting a service multi-rate would book a variant the quoted price
+  never reflected.
+- `INTERNET`, `PRIVAT_PARKING`, `BREAKFAST`, and `EXTRABED` remain parked in the
+  core parser until the backend defines what a second multi-rate per cancellation
+  policy means and how a client could book it.
+
+## Unchanged
+
+- The website SDK contains no own source change in this release. The fix arrives
+  through `@v-office/sdk-core`.
+- `sdk.live.quote.quote(input)`, the quote input, and all selection methods keep
+  their signatures and result shapes.
+- The `code` field added in 2.16.0 is unchanged. `AmbiguousMultiRate` and
+  `UnresolvableMultiRate` still exist and still mark a quote unavailable.
+- Additional services can still be reported unavailable for genuine backend
+  reasons, and `available: false` must still be honored.
+- Legacy v9 quote behavior is unchanged. v9 has no multi-rate resolution.
+
+## Compatibility
+
+- No consumer change is required. Upgrading is sufficient.
+- Expect fewer `UnresolvableMultiRate` results and fewer unavailable additional
+  services on v10. Monitoring thresholds built on the previous rate need
+  adjusting.
+- Workarounds that hid affected services or treated an unavailable combination
+  after service selection as normal can be removed.
+
+See `versions/2.16.1/MIGRATION.md` and `../../quote.md`.

package/dist/instructions/versions/2.16.1/MIGRATION.md

@@ -0,0 +1,74 @@
+# Migration: 2.16.0 to 2.16.1
+
+2.16.1 is a behavior fix delivered through `@v-office/sdk-core` 1.16.1. No
+public type, service call, input, or result shape changes. No consumer code
+change is required.
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-sdk@2.16.1
+```
+
+The website SDK forwards the fix by requiring `@v-office/sdk-core` `^1.16.1`.
+Lockfiles pinning 1.16.0 must be refreshed, otherwise the old resolution
+behavior stays in place.
+
+## 2. Expect v10 Additional Services to Become Available
+
+Before this release, a v10 additional service whose rate type participated in
+multi-rate resolution made the multi-rate for the default cancellation policy
+unresolvable. The service was returned as unavailable:
+
+```json
+{
+  "id": "internet",
+  "available": false,
+  "unavailableReason": "Diese Optionskombination ist nicht verfügbar."
+}
+```
+
+Those services now return `available: true` and can be added:
+
+```ts
+const added = await sdk.live.quote.addAdditionalService({ quote, id: "internet" });
+if (added.ok) quote = added.quote;
+```
+
+Keep honoring `available: false` and `unavailableReason`. Both remain valid for
+genuine backend unavailability. Only the false positives caused by multi-rate
+resolution disappear.
+
+## 3. Remove Workarounds
+
+Remove application-side compensation built for the old behavior, such as:
+
+1. Hiding or filtering additional services that were always unavailable on v10.
+2. Treating `UnavailableQuoteCombination` after a service selection as an
+   expected outcome.
+3. Suppressing `UnresolvableMultiRate` reports because they were considered
+   noise.
+
+Point 3 matters most. `UnresolvableMultiRate` is meaningful again and should
+reach site operations as described in `versions/2.16.0/MIGRATION.md`.
+
+## 4. Adjust Monitoring Baselines
+
+The rate of `UnresolvableMultiRate` quote results and of unavailable v10
+additional services drops after the upgrade. Alerts calibrated on the previous
+volume need new thresholds.
+
+## Required Consumer Work
+
+None. Upgrade the dependency and refresh the lockfile.
+
+## Recommended Verification
+
+1. Confirm a v10 rental that offers additional services returns them with
+   `available: true`.
+2. Confirm adding such a service succeeds and raises
+   `bookingCardInformation.total` by the service charge.
+3. Confirm removing it lowers the total again.
+4. Confirm cancellation policy selection still works with services selected.
+5. Confirm booking a quote with a selected additional service succeeds.
+6. Confirm legacy v9 quote and selection flows are unchanged.

package/dist/instructions/versions/2.16.2/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog: 2.16.2
+
+This release adds the instructions that were missing from the 2.16.1 package.
+
+## Added
+
+- Added the 2.16.1 changelog and migration guide for the v10 multi-rate
+  resolution fix and the restored additional-service availability.
+- Documented in `../../quote.md` that v10 resolves the multi-rate from rent
+  rates only and prices additional services on top of it.
+
+## Migration Impact
+
+- No runtime behavior or public API changes are introduced relative to 2.16.1.
+- Consumers upgrading from 2.16.0 or earlier should follow
+  `versions/2.16.1/MIGRATION.md`.

package/dist/instructions/versions/2.16.2/MIGRATION.md

@@ -0,0 +1,5 @@
+# Migration: 2.16.1 to 2.16.2
+
+The 2.16.1 package was published without its release instructions. Version 2.16.2 adds those instructions without changing runtime behavior or the public API.
+
+No migration is required from 2.16.1. If upgrading from 2.16.0 or earlier, follow `versions/2.16.1/MIGRATION.md`.

package/instructions/CHANGELOG.md

@@ -4,6 +4,8 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.16.2/CHANGELOG.md`: `@v-office/website-sdk` 2.16.2 documentation release notes.
+- `versions/2.16.1/CHANGELOG.md`: `@v-office/website-sdk` 2.16.1 release notes.
 - `versions/2.16.0/CHANGELOG.md`: `@v-office/website-sdk` 2.16.0 release notes.
 - `versions/2.15.0/CHANGELOG.md`: `@v-office/website-sdk` 2.15.0 release notes.
 - `versions/2.14.0/CHANGELOG.md`: `@v-office/website-sdk` 2.14.0 release notes.

package/instructions/MIGRATION.md

@@ -4,6 +4,8 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
+- `versions/2.16.2/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.16.1 to 2.16.2.
+- `versions/2.16.1/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.16.0 to 2.16.1.
 - `versions/2.16.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.15.0 to 2.16.0.
 - `versions/2.15.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.14.0 to 2.15.0.
 - `versions/2.14.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.13.0 to 2.14.0.

package/instructions/README.md

@@ -1,7 +1,7 @@
 # Website SDK Instructions
 
 These instructions describe the current source targeted for
-`@v-office/website-sdk` 2.16.0. Package versions remain unchanged until the release
+`@v-office/website-sdk` 2.16.2. Package versions remain unchanged until the release
 workflow performs the coordinated core and website bumps.
 
 Use this directory as the consumer-facing reference for the package:
@@ -18,6 +18,10 @@ Use this directory as the consumer-facing reference for the package:
 - `document-structured-json.md`: `sdk.static.documents.getTermsAndPrivacyPolicy` and structured document JSON rendering rules.
 - `CHANGELOG.md`: versioned changelog index.
 - `MIGRATION.md`: versioned migration index.
+- `versions/2.16.2/`: 2.16.2 documentation release notes and migration guide.
+- `versions/2.16.1/`: 2.16.1 v10 multi-rate resolution restricted to rent rates,
+  restored additional-service availability, and the 2.16.0-to-2.16.1 migration
+  guide.
 - `versions/2.16.0/`: 2.16.0 machine-readable unavailable quote codes,
   multi-rate configuration diagnostics, and the 2.15.0-to-2.16.0 migration
   guide.
@@ -96,5 +100,5 @@ website-sdk --backend v10 search --locale de-DE --query "adults=2" --sort '{"by"
 ```
 
 Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced
-in 2.0.0 and kept in 2.16.0. v10 config additionally requires `searchEndpoint` as
+in 2.0.0 and kept in 2.16.2. v10 config additionally requires `searchEndpoint` as
 of 2.5.0.

package/instructions/quote.md

@@ -310,6 +310,8 @@ if (cleared.ok) quote = cleared.quote;
 
 Each successful change returns a new quote with recalculated `bookingCardInformation.total`. v10 can mark unavailable service/policy combinations with `available: false` and `unavailableReason`; disable those options in the UI. Handle `{ ok: false, error }` for unknown service ids, quantity limits, or `UnavailableQuoteCombination`.
 
+From 2.16.1, v10 resolves the multi-rate from rent rates only. Additional services are priced on top of the resolved multi-rate and no longer make it unresolvable, so they are no longer reported unavailable for that reason.
+
 ## Cancellation Policies
 
 Cancellation policies are exposed on `quote.cancellationPolicies` when the backend offers selectable policies.

package/instructions/versions/2.16.1/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog: 2.16.1
+
+This release restores v10 additional-service selection. Services whose rate type
+took part in multi-rate resolution were reported unavailable and could not be
+added to a quote.
+
+## Fixed
+
+- v10 multi-rate resolution now considers `RENT` rates only. Additional services
+  no longer take part in resolving the multi-rate of the default cancellation
+  policy.
+- v10 additional services are reported with `available: true` again instead of
+  `available: false` plus an unavailable-combination `unavailableReason`.
+- `sdk.live.quote.addAdditionalService` no longer fails with
+  `UnavailableQuoteCombination` for those services, and the quote total rises by
+  the service charge as expected.
+- v10 quotes no longer report `code: "UnresolvableMultiRate"` merely because a
+  priced additional service was listed next to the rent.
+
+## Changed
+
+- `@v-office/sdk-core` was upgraded to 1.16.1.
+- Resolution falls back to the `baseRentRate` multi-rate of the cancellation
+  policy. That is the variant a guest quote request actually specifies, because
+  the request carries no service selection and the backend returns no multi-rate
+  id for it. Selecting a service multi-rate would book a variant the quoted price
+  never reflected.
+- `INTERNET`, `PRIVAT_PARKING`, `BREAKFAST`, and `EXTRABED` remain parked in the
+  core parser until the backend defines what a second multi-rate per cancellation
+  policy means and how a client could book it.
+
+## Unchanged
+
+- The website SDK contains no own source change in this release. The fix arrives
+  through `@v-office/sdk-core`.
+- `sdk.live.quote.quote(input)`, the quote input, and all selection methods keep
+  their signatures and result shapes.
+- The `code` field added in 2.16.0 is unchanged. `AmbiguousMultiRate` and
+  `UnresolvableMultiRate` still exist and still mark a quote unavailable.
+- Additional services can still be reported unavailable for genuine backend
+  reasons, and `available: false` must still be honored.
+- Legacy v9 quote behavior is unchanged. v9 has no multi-rate resolution.
+
+## Compatibility
+
+- No consumer change is required. Upgrading is sufficient.
+- Expect fewer `UnresolvableMultiRate` results and fewer unavailable additional
+  services on v10. Monitoring thresholds built on the previous rate need
+  adjusting.
+- Workarounds that hid affected services or treated an unavailable combination
+  after service selection as normal can be removed.
+
+See `versions/2.16.1/MIGRATION.md` and `../../quote.md`.

package/instructions/versions/2.16.1/MIGRATION.md

@@ -0,0 +1,74 @@
+# Migration: 2.16.0 to 2.16.1
+
+2.16.1 is a behavior fix delivered through `@v-office/sdk-core` 1.16.1. No
+public type, service call, input, or result shape changes. No consumer code
+change is required.
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-sdk@2.16.1
+```
+
+The website SDK forwards the fix by requiring `@v-office/sdk-core` `^1.16.1`.
+Lockfiles pinning 1.16.0 must be refreshed, otherwise the old resolution
+behavior stays in place.
+
+## 2. Expect v10 Additional Services to Become Available
+
+Before this release, a v10 additional service whose rate type participated in
+multi-rate resolution made the multi-rate for the default cancellation policy
+unresolvable. The service was returned as unavailable:
+
+```json
+{
+  "id": "internet",
+  "available": false,
+  "unavailableReason": "Diese Optionskombination ist nicht verfügbar."
+}
+```
+
+Those services now return `available: true` and can be added:
+
+```ts
+const added = await sdk.live.quote.addAdditionalService({ quote, id: "internet" });
+if (added.ok) quote = added.quote;
+```
+
+Keep honoring `available: false` and `unavailableReason`. Both remain valid for
+genuine backend unavailability. Only the false positives caused by multi-rate
+resolution disappear.
+
+## 3. Remove Workarounds
+
+Remove application-side compensation built for the old behavior, such as:
+
+1. Hiding or filtering additional services that were always unavailable on v10.
+2. Treating `UnavailableQuoteCombination` after a service selection as an
+   expected outcome.
+3. Suppressing `UnresolvableMultiRate` reports because they were considered
+   noise.
+
+Point 3 matters most. `UnresolvableMultiRate` is meaningful again and should
+reach site operations as described in `versions/2.16.0/MIGRATION.md`.
+
+## 4. Adjust Monitoring Baselines
+
+The rate of `UnresolvableMultiRate` quote results and of unavailable v10
+additional services drops after the upgrade. Alerts calibrated on the previous
+volume need new thresholds.
+
+## Required Consumer Work
+
+None. Upgrade the dependency and refresh the lockfile.
+
+## Recommended Verification
+
+1. Confirm a v10 rental that offers additional services returns them with
+   `available: true`.
+2. Confirm adding such a service succeeds and raises
+   `bookingCardInformation.total` by the service charge.
+3. Confirm removing it lowers the total again.
+4. Confirm cancellation policy selection still works with services selected.
+5. Confirm booking a quote with a selected additional service succeeds.
+6. Confirm legacy v9 quote and selection flows are unchanged.

package/instructions/versions/2.16.2/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog: 2.16.2
+
+This release adds the instructions that were missing from the 2.16.1 package.
+
+## Added
+
+- Added the 2.16.1 changelog and migration guide for the v10 multi-rate
+  resolution fix and the restored additional-service availability.
+- Documented in `../../quote.md` that v10 resolves the multi-rate from rent
+  rates only and prices additional services on top of it.
+
+## Migration Impact
+
+- No runtime behavior or public API changes are introduced relative to 2.16.1.
+- Consumers upgrading from 2.16.0 or earlier should follow
+  `versions/2.16.1/MIGRATION.md`.

package/instructions/versions/2.16.2/MIGRATION.md

@@ -0,0 +1,5 @@
+# Migration: 2.16.1 to 2.16.2
+
+The 2.16.1 package was published without its release instructions. Version 2.16.2 adds those instructions without changing runtime behavior or the public API.
+
+No migration is required from 2.16.1. If upgrading from 2.16.0 or earlier, follow `versions/2.16.1/MIGRATION.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-office/website-sdk",
-  "version": "2.16.0",
+  "version": "2.16.2",
   "description": "Website-facing SDK facade backed by @v-office/sdk-core",
   "bin": {
     "website-sdk": "./dist/cli.mjs"
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "@graphql-typed-document-node/core": "3.2.0",
-    "@v-office/sdk-core": "^1.16.0",
+    "@v-office/sdk-core": "^1.16.1",
     "effect": "4.0.0-beta.85",
     "graphql": "17.0.2",
     "yaml": "^2.9.0"