@v-office/website-sdk 2.4.0 → 2.4.2

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.0";
+var version = "2.4.2";
 //#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/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/{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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-office/website-sdk",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "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.0",
+    "@v-office/sdk-core": "^1.5.2",
     "effect": "4.0.0-beta.85",
     "graphql": "16.14.2",
     "yaml": "^2.9.0"