@v-office/website-sdk 2.16.2 → 2.17.0

package/dist/{rentals--cnnFS4I.mjs → rentals-BokBV-ze.mjs}

@@ -228,6 +228,54 @@ const toReviews = ({ locale, translations, rental }) => Effect.gen(function* ()
 	};
 });
 //#endregion
+//#region src/legacy-v9/parser/rentals/to-rooms.ts
+const ROOM_TYPE_KEY_PREFIX = "Room.type.option";
+const BED_TYPE_KEY_PREFIX = "Bed.type.option";
+const BED_KIND_KEY_PREFIX = "Bed.kind.option";
+const ROOM_ATTRIBUTE_LABEL_KEYS = {
+	hasPrivateBathroom: "RoomAttributes.hasPrivateBathroom.label",
+	roomDarkeningOption: "RoomAttributes.roomDarkeningOption.label",
+	wardrobe: "RoomAttributes.wardrobe.label"
+};
+const BED_ATTRIBUTE_LABEL_KEYS = {
+	childrenOnly: "Bed.childrenOnly.label",
+	extraLongBeds: "Bed.extraLongBeds.label",
+	openFootsection: "Bed.openFootsection.label",
+	raisedBeds: "Bed.raisedBeds.label"
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const nonEmptyString = (value) => typeof value === "string" && value.length > 0 ? value : void 0;
+const positiveInteger = (value) => typeof value === "number" && Number.isInteger(value) && value > 0 ? value : 0;
+const toRooms = ({ locale, translations, roomDetails }) => Effect.gen(function* () {
+	const result = [];
+	const translate = makeTranslate(translations, locale);
+	for (const room of Array.isArray(roomDetails) ? roomDetails : []) {
+		if (!isRecord(room)) continue;
+		const roomType = nonEmptyString(room.type);
+		if (roomType == null) continue;
+		const attributes = [];
+		for (const [key, labelKey] of Object.entries(ROOM_ATTRIBUTE_LABEL_KEYS)) if (room[key] === true) attributes.push(yield* translate(labelKey, key));
+		const beds = [];
+		for (const bed of Array.isArray(room.beds) ? room.beds : []) {
+			if (!isRecord(bed)) continue;
+			const bedType = nonEmptyString(bed.type);
+			if (bedType == null) continue;
+			const bedValue = { type: yield* translate(`${BED_TYPE_KEY_PREFIX}.${bedType}`, bedType) };
+			const bedKind = nonEmptyString(bed.kind);
+			if (bedKind != null) bedValue.kind = yield* translate(`${BED_KIND_KEY_PREFIX}.${bedKind}`, bedKind);
+			const bedAttributes = [];
+			for (const [key, labelKey] of Object.entries(BED_ATTRIBUTE_LABEL_KEYS)) if (bed[key] === true) bedAttributes.push(yield* translate(labelKey, key));
+			if (bedAttributes.length > 0) bedValue.attributes = bedAttributes;
+			for (let index = 0; index < positiveInteger(bed.amount); index++) beds.push(bedValue);
+		}
+		const roomValue = { type: yield* translate(`${ROOM_TYPE_KEY_PREFIX}.${roomType}`, roomType) };
+		if (attributes.length > 0) roomValue.attributes = attributes;
+		if (beds.length > 0) roomValue.beds = beds;
+		result.push(roomValue);
+	}
+	return result;
+});
+//#endregion
 //#region src/legacy-v9/parser/rentals/to-rental-list-item.ts
 const toRentalRentalsOutput = ({ rental, locale, translations, imageProxyBaseUrl, rentalHighlightPrioritization, customAttributes }) => Effect.gen(function* () {
 	const data = parseVofficeUnitData(rental.data);
@@ -259,6 +307,11 @@ const toRentalRentalsOutput = ({ rental, locale, translations, imageProxyBaseUrl
 		customAttributes,
 		attributes: data
 	});
+	const rooms = yield* toRooms({
+		locale,
+		translations,
+		roomDetails: data.known.roomDetails ?? data.unknown.roomDetails
+	});
 	const reviews = yield* toReviews({
 		locale,
 		translations,
@@ -277,6 +330,7 @@ const toRentalRentalsOutput = ({ rental, locale, translations, imageProxyBaseUrl
 	if (attributes != null) item.attributes = attributes;
 	if (vicinity != null) item.vicinity = vicinity;
 	if (highlights != null) item.highlights = highlights;
+	if (rooms.length > 0) item.rooms = rooms;
 	if (rental.voffice_facility != null) item.property = toProperty(rental.voffice_facility, locale);
 	if (reviews != null) item.reviews = reviews;
 	return item;

package/dist/{search-Dqiou4mc.mjs → search-zsnAfUtc.mjs}

@@ -1,4 +1,4 @@
-import { a as parseQueryParameters, i as collectQueryParameters, n as makeV9CustomAttributeFilterCapabilities, o as toQueryString, r as toBasicQueryInputs, s as applyVofficeFilterDerivedBasicQueryInputs } from "./client-CaZZGJAW.mjs";
+import { a as parseQueryParameters, i as collectQueryParameters, n as makeV9CustomAttributeFilterCapabilities, o as toQueryString, r as toBasicQueryInputs, s as applyVofficeFilterDerivedBasicQueryInputs } from "./client-ScO68LGg.mjs";
 import { a as toAddress, g as parseVofficeUnitData, i as toImages, s as searchQuery, t as toRentalHighlights, u as VofficeUnitDataFieldSchemas } from "./to-rental-highlights-BAsEuxoy.mjs";
 import { CoreSDKError, STABLE_SEARCH_INPUTS, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, parseChildrenAges, parseOccupancyCount, resolveExpandedCompositions, toFormattedSearchPrice, toIsoDateFromPeriodQueryDate, toStableSearchInputBackendQueryKeys, toStableSearchInputParameterValues, toStableSearchInputQueryKeys, toUnusedFilterKeys } from "@v-office/sdk-core";
 import { Effect } from "effect";

package/dist/translations/v10/de-DE/core.json

@@ -3004,6 +3004,8 @@
   "PropertyAttributes.communalLoungeTvRoom.label": "Fernsehzimmer",
   "PropertyAttributes.conciergeService.help": "Concierge Hilfe",
   "PropertyAttributes.conciergeService.label": "Concierge",
+  "PropertyAttributes.constructionDate.help": "Jahr oder Datum, in dem die Immobilie gebaut wurde",
+  "PropertyAttributes.constructionDate.label": "Baudatum",
   "PropertyAttributes.contactlessCheckinAvailable.help": "Kontaktloser Check-in verfügbar Hilfe",
   "PropertyAttributes.contactlessCheckinAvailable.label": "Kontaktloser Check-in verfügbar",
   "PropertyAttributes.couplesMassage.help": "Paar Massagen Hilfe",
@@ -3121,6 +3123,8 @@
   "PropertyAttributes.kidMeals.label": "Kinder Gerichte",
   "PropertyAttributes.kidsClub.help": "Kinder-Club Hilfe",
   "PropertyAttributes.kidsClub.label": "Kinder-Club",
+  "PropertyAttributes.lastRenovationDate.help": "Datum der letzten Renovierung",
+  "PropertyAttributes.lastRenovationDate.label": "Letzte Renovierung",
   "PropertyAttributes.laundryService.help": "PropertyAttributes.laundryService.help",
   "PropertyAttributes.laundryService.label": "Wäscheservice",
   "PropertyAttributes.library.help": "Bibliothek Hilfe",
@@ -4516,9 +4520,15 @@
   "RentalAttributes.marquee.help": "Pavillon / Partyzelt verfügbar",
   "RentalAttributes.marquee.label": "Festzelt",
   "RentalAttributes.marquee.placeholder": "Platzhalter",
+  "RentalAttributes.maxAge.help": "Höchstalter der Gäste",
+  "RentalAttributes.maxAge.label": "Höchstalter",
+  "RentalAttributes.maxAge.placeholder": "Platzhalter",
   "RentalAttributes.microwave.help": "Mikrowelle vorhanden",
   "RentalAttributes.microwave.label": "Mikrowelle",
   "RentalAttributes.microwave.placeholder": "Platzhalter",
+  "RentalAttributes.minAge.help": "Mindestalter der Gäste",
+  "RentalAttributes.minAge.label": "Mindestalter",
+  "RentalAttributes.minAge.placeholder": "Platzhalter",
   "RentalAttributes.minibar.help": "Minibar (gefüllt oder leer) vorhanden",
   "RentalAttributes.minibar.label": "Minibar",
   "RentalAttributes.minibar.placeholder": "Platzhalter",

package/dist/translations/v10/en-US/core.json

@@ -3004,6 +3004,8 @@
   "PropertyAttributes.communalLoungeTvRoom.label": "communal lounge / tv room",
   "PropertyAttributes.conciergeService.help": "Concierge HELP",
   "PropertyAttributes.conciergeService.label": "Concierge",
+  "PropertyAttributes.constructionDate.help": "Year or date the property was built",
+  "PropertyAttributes.constructionDate.label": "Construction Date",
   "PropertyAttributes.contactlessCheckinAvailable.help": "contactless check-in available HELP",
   "PropertyAttributes.contactlessCheckinAvailable.label": "contactless check-in available",
   "PropertyAttributes.couplesMassage.help": "Couples massages HELP",
@@ -3121,6 +3123,8 @@
   "PropertyAttributes.kidMeals.label": "Kids meals",
   "PropertyAttributes.kidsClub.help": "Kids club HELP",
   "PropertyAttributes.kidsClub.label": "Kids club",
+  "PropertyAttributes.lastRenovationDate.help": "Date of the most recent renovation",
+  "PropertyAttributes.lastRenovationDate.label": "Last Renovation Date",
   "PropertyAttributes.laundryService.help": "Propertyattributes.laundryservice.help",
   "PropertyAttributes.laundryService.label": "Laundry Service",
   "PropertyAttributes.library.help": "Library HELP",
@@ -4516,9 +4520,15 @@
   "RentalAttributes.marquee.help": "Marquee / garden tent available",
   "RentalAttributes.marquee.label": "Marquee",
   "RentalAttributes.marquee.placeholder": "RentalAttributes.marquee.placeholder",
+  "RentalAttributes.maxAge.help": "Maximum guest age allowed",
+  "RentalAttributes.maxAge.label": "Maximum Age",
+  "RentalAttributes.maxAge.placeholder": "RentalAttributes.maxAge.placeholder",
   "RentalAttributes.microwave.help": "Microwave available",
   "RentalAttributes.microwave.label": "Microwave",
   "RentalAttributes.microwave.placeholder": "RentalAttributes.microwave.placeholder",
+  "RentalAttributes.minAge.help": "Minimum guest age required",
+  "RentalAttributes.minAge.label": "Minimum Age",
+  "RentalAttributes.minAge.placeholder": "RentalAttributes.minAge.placeholder",
   "RentalAttributes.minibar.help": "Minibar available (stocked or empty)",
   "RentalAttributes.minibar.label": "Mini-bar",
   "RentalAttributes.minibar.placeholder": "RentalAttributes.minibar.placeholder",

package/instructions/CHANGELOG.md

@@ -4,6 +4,8 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.17.0/CHANGELOG.md`: `@v-office/website-sdk` 2.17.0 release notes.
+- `versions/2.16.3/CHANGELOG.md`: `@v-office/website-sdk` 2.16.3 release notes.
 - `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.

package/instructions/MIGRATION.md

@@ -4,6 +4,8 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
+- `versions/2.17.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.16.3 to 2.17.0.
+- `versions/2.16.3/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.16.2 to 2.16.3.
 - `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.

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.2. Package versions remain unchanged until the release
+`@v-office/website-sdk` 2.17.0. 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.17.0/`: 2.17.0 legacy-v9 calendar-day prices and structured
+  rooms, shared bed-amount expansion, and the 2.16.3-to-2.17.0 migration guide.
+- `versions/2.16.3/`: 2.16.3 browser-origin resolution for relative payment
+  return URLs and the 2.16.2-to-2.16.3 migration guide.
 - `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
@@ -100,5 +104,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.2. v10 config additionally requires `searchEndpoint` as
+in 2.0.0 and kept in 2.17.0. v10 config additionally requires `searchEndpoint` as
 of 2.5.0.

package/instructions/availability.md

@@ -96,6 +96,31 @@ Start-date-selected availability returns `Promise<StartDateSelectedAvailabilityO
 
 Common statuses include `available`, `before_today`, `check_in_not_allowed`, `no_valid_check_out_from_start`, `after_last_bookable_date`, and `unavailable`. End-date results can also return `same_day`, `not_after_selected_start`, `minimum_stay_not_met`, `check_out_not_allowed`, and range-crossing statuses.
 
+### Legacy v9 Calendar-Day Prices
+
+From 2.17.0, v9 initial availability uses the numeric price supplied by the v1
+calendar to populate `formattedPrice` on valid start dates. The value is already
+localized and formatted in the rental unit's configured booking currency.
+Render it directly rather than parsing or reformatting it.
+
+`formattedPrice` remains `null` when the date cannot be used as a start date,
+the date is unavailable, the v1 calendar supplies no numeric price, or the
+unit's currency cannot be loaded. Start-date-selected availability does not
+include calendar prices.
+
+When no successful unit lookup is cached, a v9 initial-availability request loads
+the calendar and a unit record. Successful unit responses are cached by unit ID
+for the lifetime of the SDK instance, including responses without a currency.
+Failed unit requests are not cached and are retried on the next call. A missing
+currency or failed unit request does not fail availability; calendar prices
+remain `null`.
+
+No new configuration is required. The currency lookup uses the existing
+`v1ApiBaseUrl` and `apiKey`.
+
+See `versions/2.17.0/CHANGELOG.md` and
+`versions/2.17.0/MIGRATION.md`.
+
 ## Configuration
 
 Use flat `WebsiteSDKConfig` files.

package/instructions/booking.md

@@ -68,6 +68,10 @@ const booking = await sdk.live.booking.book({
 `kind: "OPTION"` creates an option booking on v10 and legacy v9. Omitting `kind`,
 or passing `"CONFIRMED"`, retains the existing confirmed-booking behavior.
 `relativeRedirectUrl` is used for online payment redirects after booking creation.
+In a browser, the SDK resolves a relative value against `window.location.origin`
+before initializing a v10 Adyen payment. An absolute HTTP or HTTPS URL is passed
+through unchanged. Server-side callers must provide an absolute HTTP or HTTPS URL
+because no browser origin is available.
 
 ## Output
 
@@ -167,7 +171,13 @@ try {
 
 ## Payment Return
 
-Online payment providers return the guest to a URL derived from `relativeRedirectUrl`. Stripe returns to that path with `payment=stripe&success=true` after payment and `payment=stripe&cancel=true` after cancellation, so the path must exist in your site and should read those query parameters.
+Online payment providers return the guest to a URL derived from
+`relativeRedirectUrl`. A relative value such as `/booking/payment-return` uses
+the active browser origin, including `http://localhost:<port>` during local
+development and the deployed website origin in production. Stripe returns to
+that path with `payment=stripe&success=true` after payment and
+`payment=stripe&cancel=true` after cancellation, so the path must exist in your
+site and should read those query parameters.
 
 `relativeRedirectUrl` is supplied before the reservation exists, so the return URL cannot carry the booking number. Persist whatever the return page needs, for example in `sessionStorage`, before submitting a payment option.
 

package/instructions/rentals.md

@@ -123,6 +123,47 @@ list.
 
 See `versions/2.15.0/CHANGELOG.md` and `versions/2.15.0/MIGRATION.md`.
 
+### Structured Bed Quantities
+
+From 2.17.0, both backends expand each source bed according to its `amount`.
+Because the public bed shape has no quantity field, a source amount greater than
+one is returned as that many identical entries in `rooms[].beds`. Each entry
+represents one bed and must not be deduplicated by its visible value.
+
+The v10 behavior is delivered by `@v-office/sdk-core`. Refresh the lockfile when
+upgrading so the website package resolves the coordinated core version shipped
+for 2.17.0.
+
+### Legacy v9 Structured Rooms
+
+From 2.17.0, when vOffice supplies `roomDetails`, v9 rentals return them as
+`rooms`. Room types, bed types, bed kinds, and supported room and bed attributes
+are localized.
+
+Supported per-room Boolean attributes are `hasPrivateBathroom`,
+`roomDarkeningOption`, and `wardrobe`. Supported per-bed Boolean attributes are
+`childrenOnly`, `extraLongBeds`, `openFootsection`, and `raisedBeds`.
+
+Translation overrides use:
+
+```text
+Room.type.option.<TYPE>
+RoomAttributes.<attribute>.label
+Bed.type.option.<TYPE>
+Bed.kind.option.<KIND>
+Bed.<attribute>.label
+```
+
+Incomplete room details are handled independently: rooms without a type and beds
+without a type or positive integer amount are omitted. The rental remains
+available, and `rooms` is omitted when no usable room remains.
+
+v9 rooms do not expose per-room descriptions, source `maxGuests`, a structured
+bed amount, room IDs or room-image associations, or `roomSummary`.
+
+See `versions/2.17.0/CHANGELOG.md` and
+`versions/2.17.0/MIGRATION.md`.
+
 ### Legacy v9 Built-In Attributes
 
 From 2.14.0, built-in v9 property types and ordered option values come from the

package/instructions/versions/2.16.3/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog: 2.16.3
+
+This release fixes v10 Adyen payment return URLs when booking is initiated with
+a relative `relativeRedirectUrl`.
+
+## Fixed
+
+- Relative payment return URLs are resolved against `window.location.origin`
+  before the SDK initializes an Adyen payment.
+- Adyen receives the website's complete return URL instead of an unresolved
+  path that could be interpreted relative to the payment provider's origin.
+- Local development can initialize test payments with return URLs such as
+  `http://localhost:4321/booking/payment-return`.
+
+## Unchanged
+
+- `sdk.live.booking.book`, its input, and its output keep the same public types.
+- Existing relative values such as `/booking/payment-return` require no code
+  changes.
+- Absolute HTTP and HTTPS return URLs continue to be passed through unchanged.
+- Legacy v9 booking and payment behavior is unchanged.
+
+## Compatibility
+
+- No consumer code change is required. Upgrade the website SDK and refresh the
+  lockfile.
+- Browser callers can keep supplying a site-relative return path. Server-side
+  callers must supply an absolute HTTP or HTTPS URL because no browser origin is
+  available.
+
+See `versions/2.16.3/MIGRATION.md` and `../../booking.md`.

package/instructions/versions/2.16.3/MIGRATION.md

@@ -0,0 +1,51 @@
+# Migration: 2.16.2 to 2.16.3
+
+2.16.3 fixes relative v10 Adyen payment return URLs through
+`@v-office/sdk-core` 1.16.2. No public type, service call, input, or result shape
+changes.
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-sdk@2.16.3
+```
+
+Refresh the lockfile so the website SDK resolves `@v-office/sdk-core` 1.16.2.
+
+## 2. Keep the Existing Return Path
+
+No application code change is required. Existing relative return paths continue
+to work:
+
+```ts
+const booking = await sdk.live.booking.book({
+  quote,
+  contact,
+  relativeRedirectUrl: "/booking/payment-return",
+});
+```
+
+In a browser, the SDK now resolves that path against `window.location.origin`.
+For example:
+
+```text
+http://localhost:4321 + /booking/payment-return
+→ http://localhost:4321/booking/payment-return
+```
+
+Absolute HTTP and HTTPS return URLs remain unchanged. Server-side callers must
+provide an absolute URL because `window.location.origin` is unavailable.
+
+## Required Consumer Work
+
+None beyond upgrading the dependency and refreshing the lockfile.
+
+## Recommended Verification
+
+1. Start the website locally and create a deliberate v10 test booking.
+2. Confirm the Adyen initiation request contains the local website origin in its
+   `redirectUrl`.
+3. Complete or cancel the hosted test payment and confirm the browser returns to
+   the local payment-return page.
+4. Confirm a deployed website uses its own active origin for the same relative
+   return path.

package/instructions/versions/2.17.0/CHANGELOG.md

@@ -0,0 +1,83 @@
+# Changelog: 2.17.0
+
+This release restores presentation-ready prices to legacy-v9 initial
+availability calendars and exposes structured v9 room and bed data through the
+shared rental contract. Bed quantities are represented consistently on v9 and
+v10 by returning one public bed entry for each source bed amount.
+
+## Added
+
+- Legacy-v9 static rentals expose source `roomDetails` through the existing
+  optional `rooms` field.
+- v9 room output includes localized room types, bed types, bed kinds, and the
+  supported room and bed attributes supplied by vOffice.
+- Supported v9 room attributes are `hasPrivateBathroom`,
+  `roomDarkeningOption`, and `wardrobe`. Supported bed attributes are
+  `childrenOnly`, `extraLongBeds`, `openFootsection`, and `raisedBeds`.
+
+## Fixed
+
+- Legacy-v9 initial availability calendar days once again expose a localized
+  `formattedPrice` when the date is a valid start date and the v1 calendar
+  supplies a numeric price.
+- Unavailable dates, dates that cannot be used as a start date, and dates without
+  a numeric source price continue to return `formattedPrice: null`.
+
+## Changed
+
+- v9 calendar prices use the rental unit's configured booking currency. The SDK
+  loads that currency through the existing v1 unit endpoint and caches successful
+  unit lookups for the lifetime of the SDK instance.
+- v9 calendar prices remain `null` when the unit currency is missing or cannot
+  be loaded. A currency lookup failure does not make the availability request
+  fail.
+- A source bed with `amount: 3` is represented as three identical entries in
+  `rooms[].beds`. This applies to v9 and v10, whose shared public bed shape does
+  not contain a separate amount field.
+- The first initial v9 availability request for a unit loads both its calendar
+  and unit record. Subsequent calls reuse a successfully loaded unit response,
+  including one that contains no currency. Failed unit requests are not cached
+  and are retried on the next call.
+- v9 room data that does not satisfy the stricter generated heuristic schema is
+  read leniently from the preserved unknown data instead of being discarded as a
+  complete array.
+- One incomplete v9 room or bed does not remove otherwise usable room data or
+  fail the rental.
+
+## Unchanged
+
+- `sdk.live.availability.getInitialAvailability(input)` and
+  `sdk.static.rentals.getRentals({ locale })` keep their existing signatures and
+  public TypeScript contracts.
+- No new v9 configuration value or endpoint is required. The existing
+  `v1ApiBaseUrl` and API key are used for the unit-currency lookup, and
+  `roomDetails` is already requested by the v9 rentals GraphQL operation.
+- v10 initial-availability pricing is unchanged.
+- Start-date-selected availability output does not gain calendar prices.
+- v9 `rooms` remains optional and is omitted when vOffice supplies no usable
+  room details.
+- v9 still does not expose per-room descriptions, source `maxGuests`, a
+  structured bed amount, room IDs or room-image associations, or `roomSummary`.
+- Existing localized `attributes` and `highlights` remain available and are not
+  removed when structured rooms are present.
+
+## Compatibility
+
+- Both features are additive for consumers that read selected fields.
+- Complete v9 availability snapshots can now contain non-null `formattedPrice`
+  values on valid start dates.
+- Complete v9 rental snapshots can now contain `rooms`.
+- v9 and v10 snapshots or UIs that assumed one public bed entry per source bed
+  record must account for repeated entries when the source amount is greater
+  than one.
+- Consumers must not deduplicate identical bed entries: repetition represents
+  the source quantity.
+- The v10 bed expansion is delivered through `@v-office/sdk-core`. Refresh the
+  lockfile when upgrading so the website package resolves the coordinated core
+  version shipped for 2.17.0.
+- A first initial-availability request for a v9 rental can perform one additional
+  v1 unit request for its currency. Applications with request-level mocks or
+  network assertions must account for it.
+
+See `versions/2.17.0/MIGRATION.md`, `../../availability.md`, and
+`../../rentals.md`.