@v-office/website-sdk 2.4.1 → 2.4.3

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Pt as defineWebsiteSDKOptions, t as createWebsiteSDK } from "./client-DcBxVHpl.mjs";
+import { Pt as defineWebsiteSDKOptions, t as createWebsiteSDK } from "./client-BORwUo4_.mjs";
 import { Console, Effect, FileSystem, Layer, Option, Path, Schema, Stdio, Terminal } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
 import { inspect } from "node:util";
@@ -15,7 +15,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.4.1";
+var version = "2.4.3";
 //#endregion
 //#region src/cli/output.ts
 const toJson = (value) => Effect.try({

package/dist/{client-DcBxVHpl.mjs → client-BORwUo4_.mjs}

@@ -8,13 +8,15 @@ const normalizeWebsiteSDKOptions = (options = {}) => ({
 	customAttributeFilterDefinitions: options.customAttributeFilterDefinitions ?? [],
 	rentalHighlightPrioritization: options.rentalHighlightPrioritization ?? DEFAULT_RENTAL_HIGHLIGHT_PRIORITIZATION,
 	rentalPropertyHighlightPrioritization: options.rentalPropertyHighlightPrioritization ?? DEFAULT_RENTAL_PROPERTY_HIGHLIGHT_PRIORITIZATION,
-	rentalScope: options.rentalScope ?? {}
+	rentalScope: options.rentalScope ?? {},
+	shouldAddProposedAdditionalServiceAmount: options.shouldAddProposedAdditionalServiceAmount ?? false
 });
 const toV9Options = (options) => ({
 	...options.translationOverrides === void 0 ? {} : { translationOverrides: options.translationOverrides },
 	customAttributeFilterDefinitions: options.customAttributeFilterDefinitions,
 	rentalHighlightPrioritization: options.rentalHighlightPrioritization,
-	rentalScope: options.rentalScope
+	rentalScope: options.rentalScope,
+	shouldAddProposedAdditionalServiceAmount: options.shouldAddProposedAdditionalServiceAmount
 });
 const defineWebsiteSDKOptions = (options) => options;
 //#endregion
@@ -4415,7 +4417,7 @@ const bookV9Insurance = ({ quote, bookingNumber, guestToken, v1Client }) => Effe
 //#region src/legacy-v9/live/quote.ts
 const loadQuoteRuntime = Effect.tryPromise({
 	try: async () => {
-		return { toGuestQuote: (await import("./quote-_lvxNgiO.mjs")).toGuestQuote };
+		return { toGuestQuote: (await import("./quote-Cs6jGoRS.mjs")).toGuestQuote };
 	},
 	catch: (cause) => new CoreSDKError({
 		source: "v10",
@@ -4433,7 +4435,7 @@ const toVofficeUnitId = (input) => {
 		message: `Expected rentalId to be a vOffice unit ID, received "${input.rentalId}".`
 	}));
 };
-const quote = (client, v0Client, translations, limitQuote, input) => Effect.gen(function* () {
+const quote = (client, v0Client, translations, limitQuote, input, shouldAddProposedAdditionalServiceAmount) => Effect.gen(function* () {
 	const unitId = yield* toVofficeUnitId(input);
 	const result = yield* limitQuote(client.execute("getUnitQuotePrices", {
 		path: { voffice_unit: unitId },
@@ -4455,7 +4457,7 @@ const quote = (client, v0Client, translations, limitQuote, input) => Effect.gen(
 		cause
 	}))));
 	const { toGuestQuote } = yield* loadQuoteRuntime;
-	const guestQuoteResult = yield* toGuestQuote(input, result.raw?.data.quote ?? result.data.data.quote, input.locale, translations);
+	const guestQuoteResult = yield* toGuestQuote(input, result.raw?.data.quote ?? result.data.data.quote, input.locale, translations, { shouldAddProposedAdditionalServiceAmount });
 	if (guestQuoteResult.status === "unavailable") return guestQuoteResult;
 	return {
 		status: "available",
@@ -4499,7 +4501,7 @@ const makeV9QuoteApi = ({ config, options }) => {
 		v1Client: clients.v1Client
 	});
 	return {
-		quote: (input) => withClients(({ v0Client, v1Client }) => quote(v1Client, v0Client, translations, limitQuote, input)),
+		quote: (input) => withClients(({ v0Client, v1Client }) => quote(v1Client, v0Client, translations, limitQuote, input, options.shouldAddProposedAdditionalServiceAmount)),
 		addAdditionalService: ({ quote, id }) => withClients((clients) => withGuestQuoteInsuranceRefresh({
 			result: addGuestQuoteAdditionalServiceSelection({
 				quote,
@@ -4670,7 +4672,7 @@ const parseV9SearchCursor = (cursor) => Effect.gen(function* () {
 	return page;
 });
 const loadV9SearchRuntime = Effect.tryPromise({
-	try: () => import("./search-CnE272WG.mjs"),
+	try: () => import("./search-Ckz48lwV.mjs"),
 	catch: (cause) => new CoreSDKError({
 		source: "v10",
 		operation: "v9.search.runtime",

package/dist/index.d.mts

@@ -24,6 +24,7 @@ type WebsiteSDKOptions = {
   readonly rentalHighlightPrioritization?: readonly RentalHighlightPrioritizationKey$1[];
   readonly rentalPropertyHighlightPrioritization?: readonly RentalPropertyHighlightPrioritizationKey$1[];
   readonly rentalScope?: RentalScope;
+  readonly shouldAddProposedAdditionalServiceAmount?: boolean;
 };
 declare const defineWebsiteSDKOptions: <Options extends WebsiteSDKOptions>(options: Options) => Options;
 //#endregion

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as SetupResponseSchema, A as ErgoPolicyNumberRequestSchema, At as selectInsurancePaymentEffect, B as QuotePricesResponseSchema, C as ErgoAddressSchema, Ct as getStartDateSelectedAvailabilityEffect, D as ErgoCreatePreContractRequestSchema, Dt as searchEffect, E as ErgoCommonFieldsSchema, Et as removeAdditionalServiceEffect, F as OnOfficeUnitSchema, G as RegionListResponseSchema, H as QuoteServiceSchema, I as PaymentScheduleItemSchema, J as ServiceBeonDataSchema, K as RoomImageSchema, L as PaymentScheduleSchema, M as ErgoTripAndCustomerRequestSchema, Mt as submitPaymentOption, N as FacilityListResponseSchema, Nt as submitPaymentOptionEffect, O as ErgoPersonSchema, Ot as selectCancellationPolicyEffect, P as OnOfficeUnitCollectionResponseSchema, Pt as defineWebsiteSDKOptions, Q as SetupDataSchema, R as QuoteLineSchema, S as DocumentTypeSchema, St as getRentalsEffect, T as ErgoBookRequestSchema, Tt as quoteEffect, U as RawObjectResponseSchema, V as QuoteSchema, W as RawVofficeObjectSchema, X as ServiceLimitSchema, Y as ServiceImageSchema, Z as ServiceListResponseSchema, _ as DocumentResourceResponseSchema, _t as bookInsuranceEffect, a as makeV0OpenApiClientFetchLive, at as UnitIdsResponseSchema, b as DocumentStatusUpdateRequestSchema, bt as getFiltersEffect, c as V1OpenApiClientError, ct as UnitOfferSchema, d as ApiEnvelopeBaseSchema, dt as V1_BASE_URL, et as TileCollectionResponseSchema, f as CalendarDaySchema, ft as V1_OPERATIONS, g as DocumentCollectionResponseSchema, gt as bookEffect, h as CustomerUnitSummarySchema, ht as addAdditionalServiceEffect, i as V0OpenApiClientError, it as TravelInsuranceBookingStoreRequestSchema, j as ErgoReadPreContractRequestSchema, jt as submitContactEffect, k as ErgoPlanSearchRequestSchema, kt as selectInsuranceEffect, l as makeV1OpenApiClientFetchLive, lt as UnitResponseSchema, m as CurrentMemberResponseSchema, mt as decodeV1OperationResponse, nt as TileTagSchema, o as makeV0OpenApiClientLive, ot as UnitListItemSchema, p as CalendarResponseSchema, pt as VideoResponseSchema, q as SearchPropertiesResponseSchema, r as V0OpenApiClient, rt as TravelInsuranceBookingSchema, s as V1OpenApiClient, st as UnitListResponseSchema, t as createWebsiteSDK, tt as TileSchema, u as makeV1OpenApiClientLive, ut as UnitServicePriceSchema, v as DocumentResourceSchema, vt as clearAdditionalServicesEffect, w as ErgoBankSchema, wt as getTermsAndPrivacyPolicyEffect, x as DocumentSummarySchema, xt as getInitialAvailabilityEffect, y as DocumentStatusSchema, yt as createInsurancePreContractEffect, z as QuotePricesPayloadSchema } from "./client-DcBxVHpl.mjs";
+import { $ as SetupResponseSchema, A as ErgoPolicyNumberRequestSchema, At as selectInsurancePaymentEffect, B as QuotePricesResponseSchema, C as ErgoAddressSchema, Ct as getStartDateSelectedAvailabilityEffect, D as ErgoCreatePreContractRequestSchema, Dt as searchEffect, E as ErgoCommonFieldsSchema, Et as removeAdditionalServiceEffect, F as OnOfficeUnitSchema, G as RegionListResponseSchema, H as QuoteServiceSchema, I as PaymentScheduleItemSchema, J as ServiceBeonDataSchema, K as RoomImageSchema, L as PaymentScheduleSchema, M as ErgoTripAndCustomerRequestSchema, Mt as submitPaymentOption, N as FacilityListResponseSchema, Nt as submitPaymentOptionEffect, O as ErgoPersonSchema, Ot as selectCancellationPolicyEffect, P as OnOfficeUnitCollectionResponseSchema, Pt as defineWebsiteSDKOptions, Q as SetupDataSchema, R as QuoteLineSchema, S as DocumentTypeSchema, St as getRentalsEffect, T as ErgoBookRequestSchema, Tt as quoteEffect, U as RawObjectResponseSchema, V as QuoteSchema, W as RawVofficeObjectSchema, X as ServiceLimitSchema, Y as ServiceImageSchema, Z as ServiceListResponseSchema, _ as DocumentResourceResponseSchema, _t as bookInsuranceEffect, a as makeV0OpenApiClientFetchLive, at as UnitIdsResponseSchema, b as DocumentStatusUpdateRequestSchema, bt as getFiltersEffect, c as V1OpenApiClientError, ct as UnitOfferSchema, d as ApiEnvelopeBaseSchema, dt as V1_BASE_URL, et as TileCollectionResponseSchema, f as CalendarDaySchema, ft as V1_OPERATIONS, g as DocumentCollectionResponseSchema, gt as bookEffect, h as CustomerUnitSummarySchema, ht as addAdditionalServiceEffect, i as V0OpenApiClientError, it as TravelInsuranceBookingStoreRequestSchema, j as ErgoReadPreContractRequestSchema, jt as submitContactEffect, k as ErgoPlanSearchRequestSchema, kt as selectInsuranceEffect, l as makeV1OpenApiClientFetchLive, lt as UnitResponseSchema, m as CurrentMemberResponseSchema, mt as decodeV1OperationResponse, nt as TileTagSchema, o as makeV0OpenApiClientLive, ot as UnitListItemSchema, p as CalendarResponseSchema, pt as VideoResponseSchema, q as SearchPropertiesResponseSchema, r as V0OpenApiClient, rt as TravelInsuranceBookingSchema, s as V1OpenApiClient, st as UnitListResponseSchema, t as createWebsiteSDK, tt as TileSchema, u as makeV1OpenApiClientLive, ut as UnitServicePriceSchema, v as DocumentResourceSchema, vt as clearAdditionalServicesEffect, w as ErgoBankSchema, wt as getTermsAndPrivacyPolicyEffect, x as DocumentSummarySchema, xt as getInitialAvailabilityEffect, y as DocumentStatusSchema, yt as createInsurancePreContractEffect, z as QuotePricesPayloadSchema } from "./client-BORwUo4_.mjs";
 import { AdditionalServiceLimitExceeded, CoreSDKError, CoreSDKError as CMSError, GuestQuoteSchema, InvalidAdditionalServiceQuantity, LocaleSchema, SearchSearchInputSchema, SearchSearchOutputSchema, UnknownAdditionalService, validateContactSubmitInput } from "@v-office/sdk-core";
 //#region codegen/v9/heuristic-generation/public-api.ts
 const customDataAttribute = (name) => name;

package/dist/instructions/CHANGELOG.md

@@ -4,6 +4,8 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.4.3/CHANGELOG.md`: `@v-office/website-sdk` 2.4.3 documentation release notes.
+- `versions/2.4.2/CHANGELOG.md`: `@v-office/website-sdk` 2.4.2 release notes.
 - `versions/2.4.0/CHANGELOG.md`: `@v-office/website-sdk` 2.4.0 release notes.
 - `versions/2.3.0/CHANGELOG.md`: `@v-office/website-sdk` 2.3.0 release notes.
 - `versions/2.1.0/CHANGELOG.md`: `@v-office/website-sdk` 2.1.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.4.3/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.4.2 to 2.4.3.
+- `versions/2.4.2/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.4.1 to 2.4.2.
 - `versions/2.4.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.3.x to 2.4.0.
 - `versions/2.3.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.1.0 to 2.3.0.
 - `versions/2.1.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.0.0 to 2.1.0.

package/dist/instructions/README.md

@@ -1,6 +1,6 @@
 # Website SDK Instructions
 
-These instructions describe `@v-office/website-sdk` 2.4.0.
+These instructions describe `@v-office/website-sdk` 2.4.3.
 
 Use this directory as the consumer-facing reference for the package:
 
@@ -15,6 +15,8 @@ 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.4.3/`: 2.4.3 documentation release notes and migration guide.
+- `versions/2.4.2/`: 2.4.2 release notes and 2.4.1-to-2.4.2 migration guide.
 - `versions/2.4.0/`: 2.4.0 release notes and 2.3.x-to-2.4.0 migration guide.
 - `versions/2.3.0/`: 2.3.0 release notes and 2.1.0-to-2.3.0 migration guide.
 - `versions/2.1.0/`: 2.1.0 release notes and 2.0.0-to-2.1.0 migration guide.
@@ -63,4 +65,4 @@ website-sdk --backend v9 filters --locale en-US
 website-sdk --backend v10 search --locale de-DE --query "adults=2"
 ```
 
-Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced in 2.0.0 and kept in 2.4.0.
+Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced in 2.0.0 and kept in 2.4.3.

package/dist/instructions/creation.md

@@ -91,6 +91,7 @@ type WebsiteSDKOptions = {
   rentalHighlightPrioritization?: readonly RentalHighlightPrioritizationKey[];
   rentalPropertyHighlightPrioritization?: readonly RentalPropertyHighlightPrioritizationKey[];
   rentalScope?: RentalScope;
+  shouldAddProposedAdditionalServiceAmount?: boolean;
 };
 ```
 
@@ -100,6 +101,7 @@ Unset options are normalized by the SDK:
 - `rentalHighlightPrioritization` defaults to the SDK default rental highlight order.
 - `rentalPropertyHighlightPrioritization` defaults to the SDK default property highlight order.
 - `rentalScope` defaults to `{}`.
+- `shouldAddProposedAdditionalServiceAmount` defaults to `false`.
 - `translationOverrides` is omitted unless provided.
 
 ## Rental Scope

package/dist/instructions/quote.md

@@ -165,11 +165,14 @@ Additional services are exposed on an available quote as `quote.additionalServic
   "label": "Bed linen",
   "charge": "25.00 EUR",
   "available": true,
+  "proposedQuantity": 1,
   "maxPerBooking": 1,
   "description": "Bed linen package"
 }
 ```
 
+When the backend provides a line amount for an optional service, it is exposed as `proposedQuantity` (including `0`). By default this is informational only and is not added to the quote. Set `shouldAddProposedAdditionalServiceAmount: true` in `WebsiteSDKOptions` to automatically select proposed quantities greater than zero when the quote is created.
+
 Use the service `id` to add or remove a service selection:
 
 ```ts
@@ -314,6 +317,8 @@ const insuranceBooking = await sdk.live.quote.bookInsurance({
 
 Quote requests are rate-limited to one backend request per second with a queue size of five. `v9` supports insurance option refresh and insurance actions; `v10` currently returns a no-insurance placeholder and insurance actions resolve as not required.
 
+`shouldAddProposedAdditionalServiceAmount` defaults to `false`. When `true`, proposed optional service quantities greater than zero are automatically selected on quote creation. `proposedQuantity` is returned whenever the backend provides a line amount (including `0`), regardless of this setting.
+
 ## CLI Usage
 
 Create `quote-input.json` with a `QuoteQuoteInput` object, then run:

package/dist/instructions/rentals.md

@@ -69,15 +69,10 @@ Sample item:
   "reviews": {
     "items": [
       {
-        "id": "rating-answer-1",
+        "id": "form-response-1",
+        "author": "Ada Lovelace, visited in July 2026",
         "rating": "5",
-        "label": "Overall satisfaction",
-        "createdAt": "2026-07-10T10:00:00.000Z"
-      },
-      {
-        "id": "text-answer-1",
-        "label": "Personal feedback",
-        "createdAt": "2026-07-10T10:00:01.000Z",
+        "createdAt": "2026-07-10T10:00:00.000Z",
         "text": "Great stay."
       }
     ],
@@ -116,9 +111,9 @@ type RentalReview =
     };
 ```
 
-For v10, public `STARS` and `TEXT` answers may be returned as separate items because the backend does not always expose a reliable relationship between them. Do not assign a rating-only item to a text-only item. Missing public customer data leaves `author` undefined.
+For v10, public answers with the same form-response ID are combined into one review item. Its `rating` is the average of the valid `STARS` answers in that response, and its `text` contains the non-empty `TEXT` answers. Missing public customer data leaves `author` undefined.
 
-`createdAt` is the feedback answer's creation timestamp, not a travel date. A text-only rental can have `reviews.items` without `reviews.summary`, so check the summary independently. The localized `summary.count` describes aggregated rating answers and does not necessarily equal `items.length`.
+`createdAt` is the form response's creation timestamp, not a travel date. A text-only rental can have `reviews.items` without `reviews.summary`, so check the summary independently. The localized `summary.count` describes form responses with valid ratings and does not necessarily equal `items.length`.
 
 ## Configuration
 

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

@@ -0,0 +1,30 @@
+# Changelog: 2.4.2
+
+Release date: 2026-07-20
+
+This release adds proposed additional-service quantities and combines related v10 public feedback answers into complete review items.
+
+## Added
+
+- Added optional `proposedQuantity` to additional services for both v9 and v10. The field is returned when the backend supplies a line amount, including `0`.
+- Added the `shouldAddProposedAdditionalServiceAmount` website SDK option. When enabled, proposed quantities greater than zero are selected on the initial quote.
+- Added deterministic pagination for v10 public feedback so rental reviews are not limited to the first backend result page.
+
+## Changed
+
+- Renamed the additional-service field `preSelectedQuantity` to `proposedQuantity`.
+- `shouldAddProposedAdditionalServiceAmount` defaults to `false`, so proposed quantities are informational unless consumers opt in to automatic initial selection.
+- Optional services with a backend amount of `0` can still be returned with their unit charge when the backend provides enough pricing data.
+- v10 public feedback answers with the same form-response ID are now combined into one review item instead of being returned as independent rating-only and text-only items.
+- A combined v10 review uses the form-response ID and creation time, averages valid `STARS` answers, and includes its non-empty `TEXT` answers.
+- v10 review summaries now count form responses with a valid rating rather than individual rating answers.
+
+## Migration Impact
+
+- Replace reads of `additionalService.preSelectedQuantity` with `additionalService.proposedQuantity`.
+- Leave `shouldAddProposedAdditionalServiceAmount` unset or `false` to preserve explicit additional-service selection.
+- Set `shouldAddProposedAdditionalServiceAmount: true` only when the initial quote should include positive backend-proposed quantities.
+- Do not assume each v10 review item represents one feedback answer. It now represents one form response and can contain both `rating` and `text`.
+- Treat a v10 review item's `id` and `createdAt` as form-response metadata.
+- Do not use `reviews.items.length` as the review-summary count.
+- No SDK config-shape or service-call changes are required.

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

@@ -0,0 +1,94 @@
+# Migration: 2.4.1 to 2.4.2
+
+This guide covers upgrading `@v-office/website-sdk` from 2.4.1 to 2.4.2.
+
+2.4.2 keeps `createWebsiteSDK({ config, options })`, the flat `WebsiteSDKConfig`, and the existing quote and rental service calls. The migration affects additional-service quantities and v10 review grouping.
+
+## Additional Services
+
+### Renamed Quantity
+
+The optional `preSelectedQuantity` field is now named `proposedQuantity`:
+
+```ts
+for (const service of quote.additionalServices) {
+  if (service.proposedQuantity !== undefined) {
+    renderProposedQuantity(service.proposedQuantity);
+  }
+}
+```
+
+The value is the backend-proposed quantity, including `0`. It does not indicate that the service is selected in the quote.
+
+Migration: replace every read of `preSelectedQuantity` with `proposedQuantity` and continue to handle the field as optional.
+
+### Initial Selection
+
+Proposed quantities are not selected by default. To add positive proposed quantities to the initial quote, enable the new website SDK option:
+
+```ts
+const sdk = createWebsiteSDK({
+  config,
+  options: defineWebsiteSDKOptions({
+    shouldAddProposedAdditionalServiceAmount: true,
+  }),
+});
+```
+
+When this option is `true`, the SDK adds each service up to its positive `proposedQuantity` while creating the quote. Normal availability and quantity-limit checks still apply. A proposed quantity of `0` is never selected automatically.
+
+Leave the option unset or set it to `false` when users must explicitly select every optional service.
+
+## v10 Rental Reviews
+
+v10 now combines public answers that have the same form-response ID. One review item can therefore contain both its averaged star rating and its text:
+
+```ts
+const review = {
+  id: "form-response-1",
+  author: "Ada Lovelace, visited in July 2026",
+  rating: "5",
+  createdAt: "2026-07-10T10:00:00.000Z",
+  text: "Great stay.",
+};
+```
+
+For each v10 form response:
+
+- `id` is the form-response ID.
+- `createdAt` is the form-response creation time.
+- `rating` is the average of its valid public `STARS` values.
+- `text` contains its non-empty public `TEXT` answers.
+- `author` remains optional when no public customer information is available.
+- The item is omitted when the response has neither a valid rating nor non-empty text.
+
+If a response contains multiple text answers, they are separated by blank lines and non-empty question titles identify the corresponding text. Review items remain sorted by form-response creation time, newest first.
+
+Rendering should continue to check optional fields independently:
+
+```ts
+for (const rental of await sdk.static.rentals.getRentals({ locale: "de-DE" })) {
+  for (const item of rental.reviews?.items ?? []) {
+    if (item.rating !== undefined) renderReviewRating(item.rating);
+    if (item.text !== undefined) renderReviewText(item.text);
+    renderReviewAuthor(item.author ?? "Anonymous");
+  }
+
+  if (rental.reviews?.summary !== undefined) {
+    renderReviewSummary(rental.reviews.summary);
+  }
+}
+```
+
+The localized `reviews.summary.count` now counts form responses that contain a valid rating. It can differ from both the number of raw answers and `reviews.items.length`. Text-only reviews can still produce `reviews.items` without a summary.
+
+The SDK now fetches all v10 public-feedback pages. Consumers do not need to add pagination logic to `getRentals`.
+
+## Recommended Steps
+
+1. Upgrade to `@v-office/website-sdk` 2.4.2.
+2. Rename `preSelectedQuantity` reads to `proposedQuantity`.
+3. Decide whether backend-proposed quantities should be selected automatically.
+4. Expect one v10 review item per usable form response rather than one item per answer.
+5. Keep presence checks for review `rating`, `text`, `author`, and `summary`.
+6. Smoke-test quotes with absent, zero, and positive proposed quantities and rentals with rating-only, text-only, and combined feedback.

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

@@ -0,0 +1,14 @@
+# Changelog: 2.4.3
+
+Release date: 2026-07-20
+
+This release adds the instructions that were missing from the 2.4.2 package.
+
+## Added
+
+- Added the missing 2.4.2 changelog and migration instructions for proposed additional-service quantities and grouped v10 reviews.
+
+## Migration Impact
+
+- No runtime behavior or public API changes are introduced relative to 2.4.2.
+- Consumers upgrading from 2.4.1 or earlier should follow `versions/2.4.2/MIGRATION.md`.

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

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

package/dist/{quote-_lvxNgiO.mjs → quote-Cs6jGoRS.mjs}

@@ -22,13 +22,13 @@ const toCharge = ({ serviceLine, chargeAmount, currency, locale, translations })
 //#endregion
 //#region src/legacy-v9/parser/quote/to-charge-amount.ts
 const toChargeAmount = ({ input, serviceLine }) => {
-	const amount = serviceLine.amount ?? 1;
-	if (amount <= 0 || serviceLine.total == null) return void 0;
+	if (serviceLine.total == null) return void 0;
+	const quantity = serviceLine.amount != null && serviceLine.amount > 0 ? serviceLine.amount : 1;
 	switch (serviceLine.calculation) {
-		case "NIGHT": return serviceLine.total / toNightCount(input.period) / amount;
-		case "DAY": return serviceLine.total / toNightCount(input.period) / amount;
-		case "USAGE": return serviceLine.total / amount;
-		default: return serviceLine.total / amount;
+		case "NIGHT": return serviceLine.total / toNightCount(input.period) / quantity;
+		case "DAY": return serviceLine.total / toNightCount(input.period) / quantity;
+		case "USAGE": return serviceLine.total / quantity;
+		default: return serviceLine.total / quantity;
 	}
 };
 //#endregion
@@ -67,6 +67,7 @@ const toImages = (line) => {
 	return images.length === 0 ? void 0 : images;
 };
 const toPositiveQuantity = (value) => value == null || value <= 0 ? void 0 : value;
+const toNonNegativeQuantity = (value) => value == null || value < 0 ? void 0 : value;
 const toAdditionalServices = ({ input, guestQuoteResult, locale, translations }) => Effect.gen(function* () {
 	const additionalServices = [];
 	const currency = guestQuoteResult?.currency ?? "EUR";
@@ -99,8 +100,8 @@ const toAdditionalServices = ({ input, guestQuoteResult, locale, translations })
 			translations
 		});
 		const maxPerBooking = toPositiveQuantity(limit?.maxPerBooking);
-		const lineAmount = toPositiveQuantity(line.amount);
-		const preSelectedQuantity = lineAmount === void 0 ? void 0 : Math.min(lineAmount, maxPerBooking ?? lineAmount);
+		const lineAmount = toNonNegativeQuantity(line.amount);
+		const proposedQuantity = lineAmount === void 0 ? void 0 : Math.min(lineAmount, maxPerBooking ?? lineAmount);
 		const description = toDescription(line);
 		const images = toImages(line);
 		additionalServices.push({
@@ -109,7 +110,7 @@ const toAdditionalServices = ({ input, guestQuoteResult, locale, translations })
 			charge,
 			chargeAmount,
 			calculation: toAdditionalServiceCalculation(line),
-			...preSelectedQuantity === void 0 ? {} : { preSelectedQuantity },
+			...proposedQuantity === void 0 ? {} : { proposedQuantity },
 			...maxPerBooking === void 0 ? {} : { maxPerBooking },
 			...leadTimeDays === void 0 ? {} : { leadTimeDays },
 			...description === void 0 ? {} : { description },
@@ -281,7 +282,7 @@ const toVoucher = ({ input, locale, translations }) => Effect.gen(function* () {
 		message: yield* translations.translate(locale, "quote.voucher.unknown", "The backend did not confirm whether the voucher code was applied.")
 	};
 });
-const toGuestQuote = (input, guestQuoteResult, locale, translations) => Effect.gen(function* () {
+const toGuestQuote = (input, guestQuoteResult, locale, translations, options) => Effect.gen(function* () {
 	const errorReason = toErrorReason(guestQuoteResult);
 	if (errorReason !== void 0) return {
 		status: "unavailable",
@@ -319,9 +320,9 @@ const toGuestQuote = (input, guestQuoteResult, locale, translations) => Effect.g
 		backendContext: toV9QuoteBackendContext(input, guestQuoteResult),
 		updateBackendContext: updateV9QuoteBackendContext
 	});
-	for (const additionalService of additionalServices) {
-		if (additionalService.preSelectedQuantity === void 0) continue;
-		for (let quantity = 0; quantity < additionalService.preSelectedQuantity; quantity++) {
+	if (options?.shouldAddProposedAdditionalServiceAmount === true) for (const additionalService of additionalServices) {
+		if (additionalService.proposedQuantity === void 0 || additionalService.proposedQuantity <= 0) continue;
+		for (let quantity = 0; quantity < additionalService.proposedQuantity; quantity++) {
 			const result = addGuestQuoteAdditionalServiceSelection({
 				quote: guestQuote,
 				id: additionalService.id

package/dist/{search-CnE272WG.mjs → search-Ckz48lwV.mjs}

@@ -1,4 +1,4 @@
-import { n as stable_filters_default } from "./client-DcBxVHpl.mjs";
+import { n as stable_filters_default } from "./client-BORwUo4_.mjs";
 import { a as searchQuery, c as VofficeUnitDataFieldSchemas, m as parseVofficeUnitData, n as toImages, r as toAddress, t as toRentalHighlights } from "./to-rental-highlights-CxWlq76f.mjs";
 import { CoreSDKError, STABLE_SEARCH_INPUTS, collectQueryParameters, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, parseChildrenAges, parseOccupancyCount, parseQueryParameters, toCustomAttributeFilterLabel, toFormattedSearchPrice, toIsoDateFromPeriodQueryDate, toQueryString, toStableSearchInputBackendQueryKeys, toStableSearchInputParameterValues, toStableSearchInputQueryKeys, toUnusedFilterKeys } from "@v-office/sdk-core";
 import { Effect } from "effect";

package/instructions/CHANGELOG.md

@@ -4,6 +4,8 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.4.3/CHANGELOG.md`: `@v-office/website-sdk` 2.4.3 documentation release notes.
+- `versions/2.4.2/CHANGELOG.md`: `@v-office/website-sdk` 2.4.2 release notes.
 - `versions/2.4.0/CHANGELOG.md`: `@v-office/website-sdk` 2.4.0 release notes.
 - `versions/2.3.0/CHANGELOG.md`: `@v-office/website-sdk` 2.3.0 release notes.
 - `versions/2.1.0/CHANGELOG.md`: `@v-office/website-sdk` 2.1.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.4.3/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.4.2 to 2.4.3.
+- `versions/2.4.2/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.4.1 to 2.4.2.
 - `versions/2.4.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.3.x to 2.4.0.
 - `versions/2.3.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.1.0 to 2.3.0.
 - `versions/2.1.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.0.0 to 2.1.0.

package/instructions/README.md

@@ -1,6 +1,6 @@
 # Website SDK Instructions
 
-These instructions describe `@v-office/website-sdk` 2.4.0.
+These instructions describe `@v-office/website-sdk` 2.4.3.
 
 Use this directory as the consumer-facing reference for the package:
 
@@ -15,6 +15,8 @@ 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.4.3/`: 2.4.3 documentation release notes and migration guide.
+- `versions/2.4.2/`: 2.4.2 release notes and 2.4.1-to-2.4.2 migration guide.
 - `versions/2.4.0/`: 2.4.0 release notes and 2.3.x-to-2.4.0 migration guide.
 - `versions/2.3.0/`: 2.3.0 release notes and 2.1.0-to-2.3.0 migration guide.
 - `versions/2.1.0/`: 2.1.0 release notes and 2.0.0-to-2.1.0 migration guide.
@@ -63,4 +65,4 @@ website-sdk --backend v9 filters --locale en-US
 website-sdk --backend v10 search --locale de-DE --query "adults=2"
 ```
 
-Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced in 2.0.0 and kept in 2.4.0.
+Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced in 2.0.0 and kept in 2.4.3.

package/instructions/creation.md

@@ -91,6 +91,7 @@ type WebsiteSDKOptions = {
   rentalHighlightPrioritization?: readonly RentalHighlightPrioritizationKey[];
   rentalPropertyHighlightPrioritization?: readonly RentalPropertyHighlightPrioritizationKey[];
   rentalScope?: RentalScope;
+  shouldAddProposedAdditionalServiceAmount?: boolean;
 };
 ```
 
@@ -100,6 +101,7 @@ Unset options are normalized by the SDK:
 - `rentalHighlightPrioritization` defaults to the SDK default rental highlight order.
 - `rentalPropertyHighlightPrioritization` defaults to the SDK default property highlight order.
 - `rentalScope` defaults to `{}`.
+- `shouldAddProposedAdditionalServiceAmount` defaults to `false`.
 - `translationOverrides` is omitted unless provided.
 
 ## Rental Scope

package/instructions/quote.md

@@ -165,11 +165,14 @@ Additional services are exposed on an available quote as `quote.additionalServic
   "label": "Bed linen",
   "charge": "25.00 EUR",
   "available": true,
+  "proposedQuantity": 1,
   "maxPerBooking": 1,
   "description": "Bed linen package"
 }
 ```
 
+When the backend provides a line amount for an optional service, it is exposed as `proposedQuantity` (including `0`). By default this is informational only and is not added to the quote. Set `shouldAddProposedAdditionalServiceAmount: true` in `WebsiteSDKOptions` to automatically select proposed quantities greater than zero when the quote is created.
+
 Use the service `id` to add or remove a service selection:
 
 ```ts
@@ -314,6 +317,8 @@ const insuranceBooking = await sdk.live.quote.bookInsurance({
 
 Quote requests are rate-limited to one backend request per second with a queue size of five. `v9` supports insurance option refresh and insurance actions; `v10` currently returns a no-insurance placeholder and insurance actions resolve as not required.
 
+`shouldAddProposedAdditionalServiceAmount` defaults to `false`. When `true`, proposed optional service quantities greater than zero are automatically selected on quote creation. `proposedQuantity` is returned whenever the backend provides a line amount (including `0`), regardless of this setting.
+
 ## CLI Usage
 
 Create `quote-input.json` with a `QuoteQuoteInput` object, then run:

package/instructions/rentals.md

@@ -69,15 +69,10 @@ Sample item:
   "reviews": {
     "items": [
       {
-        "id": "rating-answer-1",
+        "id": "form-response-1",
+        "author": "Ada Lovelace, visited in July 2026",
         "rating": "5",
-        "label": "Overall satisfaction",
-        "createdAt": "2026-07-10T10:00:00.000Z"
-      },
-      {
-        "id": "text-answer-1",
-        "label": "Personal feedback",
-        "createdAt": "2026-07-10T10:00:01.000Z",
+        "createdAt": "2026-07-10T10:00:00.000Z",
         "text": "Great stay."
       }
     ],
@@ -116,9 +111,9 @@ type RentalReview =
     };
 ```
 
-For v10, public `STARS` and `TEXT` answers may be returned as separate items because the backend does not always expose a reliable relationship between them. Do not assign a rating-only item to a text-only item. Missing public customer data leaves `author` undefined.
+For v10, public answers with the same form-response ID are combined into one review item. Its `rating` is the average of the valid `STARS` answers in that response, and its `text` contains the non-empty `TEXT` answers. Missing public customer data leaves `author` undefined.
 
-`createdAt` is the feedback answer's creation timestamp, not a travel date. A text-only rental can have `reviews.items` without `reviews.summary`, so check the summary independently. The localized `summary.count` describes aggregated rating answers and does not necessarily equal `items.length`.
+`createdAt` is the form response's creation timestamp, not a travel date. A text-only rental can have `reviews.items` without `reviews.summary`, so check the summary independently. The localized `summary.count` describes form responses with valid ratings and does not necessarily equal `items.length`.
 
 ## Configuration
 

package/instructions/versions/2.4.2/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog: 2.4.2
+
+Release date: 2026-07-20
+
+This release adds proposed additional-service quantities and combines related v10 public feedback answers into complete review items.
+
+## Added
+
+- Added optional `proposedQuantity` to additional services for both v9 and v10. The field is returned when the backend supplies a line amount, including `0`.
+- Added the `shouldAddProposedAdditionalServiceAmount` website SDK option. When enabled, proposed quantities greater than zero are selected on the initial quote.
+- Added deterministic pagination for v10 public feedback so rental reviews are not limited to the first backend result page.
+
+## Changed
+
+- Renamed the additional-service field `preSelectedQuantity` to `proposedQuantity`.
+- `shouldAddProposedAdditionalServiceAmount` defaults to `false`, so proposed quantities are informational unless consumers opt in to automatic initial selection.
+- Optional services with a backend amount of `0` can still be returned with their unit charge when the backend provides enough pricing data.
+- v10 public feedback answers with the same form-response ID are now combined into one review item instead of being returned as independent rating-only and text-only items.
+- A combined v10 review uses the form-response ID and creation time, averages valid `STARS` answers, and includes its non-empty `TEXT` answers.
+- v10 review summaries now count form responses with a valid rating rather than individual rating answers.
+
+## Migration Impact
+
+- Replace reads of `additionalService.preSelectedQuantity` with `additionalService.proposedQuantity`.
+- Leave `shouldAddProposedAdditionalServiceAmount` unset or `false` to preserve explicit additional-service selection.
+- Set `shouldAddProposedAdditionalServiceAmount: true` only when the initial quote should include positive backend-proposed quantities.
+- Do not assume each v10 review item represents one feedback answer. It now represents one form response and can contain both `rating` and `text`.
+- Treat a v10 review item's `id` and `createdAt` as form-response metadata.
+- Do not use `reviews.items.length` as the review-summary count.
+- No SDK config-shape or service-call changes are required.

package/instructions/versions/2.4.2/MIGRATION.md

@@ -0,0 +1,94 @@
+# Migration: 2.4.1 to 2.4.2
+
+This guide covers upgrading `@v-office/website-sdk` from 2.4.1 to 2.4.2.
+
+2.4.2 keeps `createWebsiteSDK({ config, options })`, the flat `WebsiteSDKConfig`, and the existing quote and rental service calls. The migration affects additional-service quantities and v10 review grouping.
+
+## Additional Services
+
+### Renamed Quantity
+
+The optional `preSelectedQuantity` field is now named `proposedQuantity`:
+
+```ts
+for (const service of quote.additionalServices) {
+  if (service.proposedQuantity !== undefined) {
+    renderProposedQuantity(service.proposedQuantity);
+  }
+}
+```
+
+The value is the backend-proposed quantity, including `0`. It does not indicate that the service is selected in the quote.
+
+Migration: replace every read of `preSelectedQuantity` with `proposedQuantity` and continue to handle the field as optional.
+
+### Initial Selection
+
+Proposed quantities are not selected by default. To add positive proposed quantities to the initial quote, enable the new website SDK option:
+
+```ts
+const sdk = createWebsiteSDK({
+  config,
+  options: defineWebsiteSDKOptions({
+    shouldAddProposedAdditionalServiceAmount: true,
+  }),
+});
+```
+
+When this option is `true`, the SDK adds each service up to its positive `proposedQuantity` while creating the quote. Normal availability and quantity-limit checks still apply. A proposed quantity of `0` is never selected automatically.
+
+Leave the option unset or set it to `false` when users must explicitly select every optional service.
+
+## v10 Rental Reviews
+
+v10 now combines public answers that have the same form-response ID. One review item can therefore contain both its averaged star rating and its text:
+
+```ts
+const review = {
+  id: "form-response-1",
+  author: "Ada Lovelace, visited in July 2026",
+  rating: "5",
+  createdAt: "2026-07-10T10:00:00.000Z",
+  text: "Great stay.",
+};
+```
+
+For each v10 form response:
+
+- `id` is the form-response ID.
+- `createdAt` is the form-response creation time.
+- `rating` is the average of its valid public `STARS` values.
+- `text` contains its non-empty public `TEXT` answers.
+- `author` remains optional when no public customer information is available.
+- The item is omitted when the response has neither a valid rating nor non-empty text.
+
+If a response contains multiple text answers, they are separated by blank lines and non-empty question titles identify the corresponding text. Review items remain sorted by form-response creation time, newest first.
+
+Rendering should continue to check optional fields independently:
+
+```ts
+for (const rental of await sdk.static.rentals.getRentals({ locale: "de-DE" })) {
+  for (const item of rental.reviews?.items ?? []) {
+    if (item.rating !== undefined) renderReviewRating(item.rating);
+    if (item.text !== undefined) renderReviewText(item.text);
+    renderReviewAuthor(item.author ?? "Anonymous");
+  }
+
+  if (rental.reviews?.summary !== undefined) {
+    renderReviewSummary(rental.reviews.summary);
+  }
+}
+```
+
+The localized `reviews.summary.count` now counts form responses that contain a valid rating. It can differ from both the number of raw answers and `reviews.items.length`. Text-only reviews can still produce `reviews.items` without a summary.
+
+The SDK now fetches all v10 public-feedback pages. Consumers do not need to add pagination logic to `getRentals`.
+
+## Recommended Steps
+
+1. Upgrade to `@v-office/website-sdk` 2.4.2.
+2. Rename `preSelectedQuantity` reads to `proposedQuantity`.
+3. Decide whether backend-proposed quantities should be selected automatically.
+4. Expect one v10 review item per usable form response rather than one item per answer.
+5. Keep presence checks for review `rating`, `text`, `author`, and `summary`.
+6. Smoke-test quotes with absent, zero, and positive proposed quantities and rentals with rating-only, text-only, and combined feedback.

package/instructions/versions/2.4.3/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog: 2.4.3
+
+Release date: 2026-07-20
+
+This release adds the instructions that were missing from the 2.4.2 package.
+
+## Added
+
+- Added the missing 2.4.2 changelog and migration instructions for proposed additional-service quantities and grouped v10 reviews.
+
+## Migration Impact
+
+- No runtime behavior or public API changes are introduced relative to 2.4.2.
+- Consumers upgrading from 2.4.1 or earlier should follow `versions/2.4.2/MIGRATION.md`.

package/instructions/versions/2.4.3/MIGRATION.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-office/website-sdk",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "Website-facing SDK facade backed by @v-office/sdk-core",
   "bin": {
     "website-sdk": "./dist/cli.mjs"
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@graphql-typed-document-node/core": "3.2.0",
-    "@v-office/sdk-core": "^1.5.1",
+    "@v-office/sdk-core": "^1.5.3",
     "effect": "4.0.0-beta.85",
     "graphql": "16.14.2",
     "yaml": "^2.9.0"