@v-office/website-sdk 2.17.1 → 2.18.1

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

@@ -0,0 +1,364 @@
+# Migration: 2.17.1 to 2.18.0
+
+2.18.0 adds an opt-in legacy-v9 facility association for tenants whose
+facilities reference vOffice object groups through a custom `p_*` data
+attribute. It also exposes initial-availability calendar prices on available
+dates that cannot be used as a start date, and combines repeated included
+rent rows when a quoted stay crosses seasonal rates.
+
+The default facility association and the public static rental result remain
+unchanged when the new config field is omitted. Public availability and quote
+types are unchanged.
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-sdk@2.18.0
+```
+
+## 2. Keep the Default Relation When Available
+
+No configuration change is required when vOffice units already carry their
+native facility relation:
+
+```ts
+const sdk = createWebsiteSDK({
+  config: {
+    backend: "v9",
+    graphqlUrl: "https://example.com/graphql",
+    apiKey: "...",
+    imageProxyBaseUrl: "https://images.example.com",
+  },
+});
+```
+
+This continues to load the nested `voffice_facility` for each unit. It does not
+request top-level facilities or object-group memberships.
+
+## 3. Enable Object-Group Association When Required
+
+Set the numeric suffix of the facility custom attribute that contains the
+related object-group ID or IDs:
+
+```ts
+const sdk = createWebsiteSDK({
+  config: {
+    backend: "v9",
+    graphqlUrl: "https://example.com/graphql",
+    apiKey: "...",
+    imageProxyBaseUrl: "https://images.example.com",
+    facilityObjectGroupRelationAttributeId: 18962,
+  },
+});
+```
+
+The SDK converts `18962` to the GraphQL facility data attribute `p_18962`.
+Do not pass `"p_18962"` or another string; the config value is a positive
+integer.
+
+When enabled, `getRentals`:
+
+1. Loads all units with `voffice_groups { voffice_group_id }`.
+2. Loads all facilities and requests `p_18962` alongside the normal facility
+   attributes.
+3. Associates each unit with the facility whose configured object-group IDs
+   contain one of the unit's group memberships.
+4. Exposes the resolved facility through the existing `rental.property`.
+5. Applies static rental scope and then loads feedbacks for retained rentals.
+
+### Expanded v9 property fields
+
+Both native and object-group v9 facility relations now populate more of the
+existing `rental.property` shape when the Hub provides the source data:
+
+- `propertyType` from `type`
+- `location` from the GeoJSON `loc`
+- `address` from `address`, with `regionName` used as `province`
+- all existing description components from their corresponding localized
+  facility fields
+- `attributes` for `allergic`, `childrenWelcome`, `pets`, and `youthgroups`
+
+`HOUSE_FAC` becomes `HOLIDAY_HOME_COMPLEX` and `FLAT_FAC` becomes
+`APARTMENT_COMPLEX`. `HOTEL`, `HOSTEL`, `FARM`, and `CAMPGROUND` already match
+the shared values. The normalized value is localized through
+`Property.propertyType.option.*` before it is returned. Unknown facility types
+are omitted.
+
+This uses the existing core `RentalPropertySchema`; no public property field or
+type was added. Missing, empty, zero-valued, or malformed optional source data
+remains omitted. The release does not synthesize property `vicinity` from
+unrelated facility fields.
+
+To select and order v9 property highlights, use the existing website option:
+
+```ts
+const sdk = createWebsiteSDK({
+  config,
+  options: {
+    rentalPropertyHighlightPrioritization: ["childrenWelcome", "pets", "youthgroups"],
+  },
+});
+```
+
+The v9 renderer supports the typed facility attributes `allergic`,
+`childrenWelcome`, `pets`, and `youthgroups`. It preserves the configured order,
+deduplicates keys, and ignores unsupported, missing, or non-renderable values.
+Rental custom attributes are not considered for property highlights.
+
+## 4. Add Tenant-Specific Facility Highlight Text
+
+Use a v9 property-highlight source when a facility custom field contains
+editor-authored highlight lines, such as `p_18963` ("Anlagen Highlights"):
+
+```ts
+import {
+  createWebsiteSDK,
+  defineV9PropertyHighlightSources,
+  defineWebsiteSDKOptions,
+} from "@v-office/website-sdk";
+
+const v9PropertyHighlightSources = defineV9PropertyHighlightSources({
+  facilityHighlights: {
+    v9: "p_18963",
+    type: "line-list",
+  },
+});
+
+const sdk = createWebsiteSDK({
+  config,
+  options: defineWebsiteSDKOptions({
+    v9PropertyHighlightSources,
+    rentalPropertyHighlightPrioritization: [
+      "childrenWelcome",
+      v9PropertyHighlightSources.keys.facilityHighlights,
+      "pets",
+    ],
+  }),
+});
+```
+
+The registry gives the tenant-specific field a stable public selection key.
+Defining a source alone does not request or emit it; add the generated key to
+`rentalPropertyHighlightPrioritization`. The selected `p_*` field is requested
+for both native and object-group facility relations.
+
+Source keys must not reuse the built-in v9 facility keys `allergic`,
+`childrenWelcome`, `pets`, or `youthgroups`; registry creation rejects those
+collisions.
+
+`line-list` resolves the localized field value, splits it at Unix or Windows
+newlines, trims each line, drops empty lines, and deduplicates exact visible
+values while preserving order. Each remaining line becomes one
+`property.highlights` item at the source key's position. Missing and `null`
+values emit nothing. Semicolons remain text; use one highlight per line in
+vOffice.
+
+For CLI JSON, provide the authored source definitions directly:
+
+```json
+{
+  "v9PropertyHighlightSources": {
+    "facilityHighlights": {
+      "v9": "p_18963",
+      "type": "line-list"
+    }
+  },
+  "rentalPropertyHighlightPrioritization": ["childrenWelcome", "facilityHighlights", "pets"]
+}
+```
+
+The CLI builds and validates the registry. TypeScript consumers should use
+`defineV9PropertyHighlightSources` so `keys.facilityHighlights` is inferred and
+checked.
+
+## 5. Prepare the GraphQL Hub
+
+Before enabling the config, verify that the same API key can query:
+
+```graphql
+query FacilityObjectGroupRelations {
+  facilities: voffice_facilities(language: "de") {
+    id
+    name
+    data(attributes: ["p_18962", "p_18963"])
+  }
+
+  all(language: "de") {
+    voffice_id
+    voffice_groups {
+      voffice_group_id
+    }
+  }
+}
+```
+
+The Hub must return:
+
+- the required facilities from `voffice_facilities`
+- a usable relation value in the configured `p_*` attribute
+- any selected facility highlight `p_*` values
+- matching `voffice_group_id` values on the intended units
+
+Do not enable the mode while those resources are only available through v0 or
+v1 and have not yet synchronized to GraphQL.
+
+## 6. Account for Relation Validation
+
+The relation attribute can contain positive numeric IDs as numbers, numeric
+strings, localized string records, arrays, or strings separated by whitespace,
+commas, or semicolons.
+
+The static request fails rather than selecting an arbitrary property when:
+
+- no facility has a usable configured relation value
+- a non-empty relation value cannot be interpreted as positive integer IDs
+- two facilities claim the same object-group ID
+- one unit matches object groups belonging to different facilities
+
+One facility may reference several groups. One unit may match several groups
+when all of them resolve to the same facility.
+
+Facilities whose relation is empty contribute no association. Rentals with no
+matching relation remain in the result and omit `property`. Compatibility mode
+does not fall back to the native facility relation.
+
+## 7. Account for Batched Catalogue Requests
+
+Legacy-v9 static rentals now load a small ordered rental-ID list first. Complete
+rental details and feedbacks are then requested sequentially in batches of 128
+IDs. Object-group mode loads the facility list once.
+
+The public result and rental order are unchanged. HTTP mocks, request counters,
+and GraphQL tracing that expected one detail query and one feedback query must
+allow multiple requests for catalogues larger than 128 rentals.
+
+Do not combine the detail batches into GraphQL aliases in one HTTP request. The
+separate requests are intentional because they bound the amount of data the
+Laravel/PHP Hub must construct and serialize at once.
+
+## 8. Keep Other APIs Unchanged
+
+The facility-association config only changes legacy-v9 static `getRentals`.
+It does not change:
+
+- v9 live search or its `falicityid` rental-scope filter
+- quote inputs, booking, or contact requests
+- start-date-selected availability
+- shared core rental types
+
+If an application uses both static rental scope and live search, verify both
+flows separately because object-group association is intentionally limited to
+the static catalogue.
+
+## 9. Render Prices on Available Non-Start Dates
+
+`getInitialAvailability` can now return a non-null `formattedPrice` on
+available dates whose status is `check_in_not_allowed` or
+`no_valid_check_out_from_start`:
+
+```ts
+const availability = await sdk.live.availability.getInitialAvailability(input);
+
+for (const [date, day] of Object.entries(availability.calendarDays)) {
+  renderCalendarDay({
+    date,
+    status: day.status,
+    price: day.formattedPrice,
+  });
+}
+```
+
+`formattedPrice` is already localized for the input locale. Render it
+directly when non-null. Do not treat a missing price as the only signal that
+a date is unavailable; use `isAvailableDate` and `status`.
+
+The field remains `null` when:
+
+- the calendar marks the day unavailable
+- the source supplies no numeric price
+
+Start-date-selected availability still has no calendar prices. The v10 change
+is delivered by `@v-office/sdk-core`. Refresh the lockfile when upgrading the
+website SDK so it resolves the coordinated core version shipped for 2.18.0.
+
+## 10. Render Combined Seasonal Rent Lines
+
+Included booking-card subitems that share the same localized `position` and
+`appliedCharge` are now one row on both v9 and v10. A stay that crosses
+seasonal rental prices therefore shows a single rent line such as `Miete` /
+`Inklusive` instead of repeating that row once per rate period.
+
+Cleaning, linen, booking fees, and other distinct included labels remain
+separate. The inclusive total still sums every backend rent period; only the
+repeated display rows are combined. Quote inputs and the booking-card schema
+are unchanged.
+
+Render `subItems` as returned. Do not reconstruct a seasonal breakdown from
+duplicate rent labels; those duplicates are no longer emitted. The v10 change
+is delivered by `@v-office/sdk-core`. Refresh the lockfile when upgrading the
+website SDK so it resolves the coordinated core version shipped for 2.18.0.
+
+## Required Consumer Work
+
+Consumers using the default native facility relation and selected availability
+fields only need to upgrade.
+
+Consumers enabling object-group association should:
+
+1. Confirm GraphQL synchronization for facilities, relation values, and groups.
+2. Add `facilityObjectGroupRelationAttributeId` to the v9 config.
+3. Confirm expected rentals contain `property`.
+4. Keep unmatched rentals without `property` valid.
+5. Update complete-output snapshots that gain associated properties.
+6. Update v9 property snapshots that gain `propertyType`, `location`, `address`,
+   description components, or built-in attributes.
+
+Consumers enabling custom v9 property highlight text should:
+
+1. Confirm the facility `p_*` field has synchronized to GraphQL.
+2. Define it with `defineV9PropertyHighlightSources`.
+3. Select its stable key in `rentalPropertyHighlightPrioritization`.
+4. Keep missing or `null` source values valid.
+5. Update complete rental snapshots that gain property highlight lines.
+
+Consumers that snapshot or hide calendar prices should:
+
+1. Render `formattedPrice` directly when non-null, including on available
+   dates that cannot be used as a start date.
+2. Keep `formattedPrice: null` valid for unavailable and price-less dates.
+3. Refresh the lockfile so v10 resolves the coordinated core release.
+4. Update complete initial-availability snapshots that expected `null` on
+   `check_in_not_allowed` or `no_valid_check_out_from_start`.
+
+Consumers that snapshot or expand included quote rows should:
+
+1. Keep rendering each included `subItem` as one row.
+2. Update complete quote snapshots that expected one rent row per seasonal
+   rate period.
+3. Refresh the lockfile so v10 resolves the coordinated core release.
+
+## Recommended Verification
+
+1. Run `getRentals` without the config and confirm native facility associations
+   remain unchanged.
+2. Run it with the configured attribute ID and count rentals by `property.id`.
+3. Verify a facility that references several groups receives every intended
+   rental once.
+4. Verify unmatched rentals remain present without `property`.
+5. Verify the configured `rentalScope.propertyId`, when used, returns only the
+   resolved facility's rentals.
+6. Verify populated facility location, address, type, descriptions, and
+   attributes are represented in `rental.property`.
+7. Test at least one catalogue larger than 128 rentals so detail and feedback
+   batching are exercised.
+8. Select a configured line-list source between two built-in property keys and
+   confirm its non-empty lines appear at that exact position without duplicates.
+9. Confirm an unselected source is not requested or emitted.
+10. Load initial availability for a stay-through or closed-on-arrival date that
+    has a source price and confirm `formattedPrice` is non-null.
+11. Confirm unavailable and price-less dates retain `formattedPrice: null`.
+12. Confirm start-date-selected availability still has no calendar prices.
+13. Quote a stay that crosses a seasonal rental-price change and confirm the
+    included section shows one rent row.
+14. Confirm other included labels still appear as separate rows and that the
+    inclusive total is unchanged.

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

@@ -0,0 +1,16 @@
+# Changelog: 2.18.1
+
+Maintenance release. `@v-office/website-sdk` now pins `@v-office/sdk-core`
+exactly, so one website SDK version always resolves one core version. There
+are no functional changes.
+
+## Changed
+
+- `@v-office/sdk-core` is pinned to exactly `1.20.0` instead of the caret
+  range `^1.19.0`. Installs that had already resolved 1.20.0 through the
+  range see no change; consumers whose lockfile still held 1.19.x move to
+  1.20.0 with this release.
+
+## Unchanged
+
+- Every public API, type and behavior of 2.18.0.

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

@@ -0,0 +1,12 @@
+# Migration: 2.18.0 to 2.18.1
+
+No changes required.
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-sdk@2.18.1
+```
+
+Future core updates arrive through a new website SDK version; the lockfile
+no longer needs a separate refresh to pick up a coordinated core release.

package/dist/{quote-C-Bs3XTE.mjs → quote-cjFdLn0m.mjs}

@@ -182,6 +182,7 @@ const toSectionsIncluded = ({ input: _input, guestQuoteResult, locale, translati
 				locale,
 				translations
 			});
+			if (subItems.some((item) => item.position === position)) continue;
 			subItems.push({
 				position,
 				appliedCharge: yield* translations.translate(locale, "quote.sections.included")

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

@@ -1,5 +1,7 @@
-import { a as toAddress, c as rentalsAllFeedbacksQuery, d as VofficeUnitDataPropertyCategoryLabelKeys, f as VofficeUnitDataPropertyCategoryValues, g as parseVofficeUnitData, h as parseVofficeFeedbackData, i as toImages, l as rentalsAllWithoutFeedbacksQuery, m as parseVofficeFacilityData, n as renderVofficePropertyAttribute, o as toLocalizedString, p as VofficeUnitDataPropertyMetadata, r as toFacilityImages, t as toRentalHighlights, u as VofficeUnitDataFieldSchemas } from "./to-rental-highlights-BAsEuxoy.mjs";
-import { makeTranslate, renderResolvedCustomAttribute, toCustomAttributeList, toResolvedCustomAttributeCategoryTranslationKey } from "@v-office/sdk-core";
+import { Ht as V9_FACILITY_ATTRIBUTE_KEYS } from "./client-BnA0oXd_.mjs";
+import { c as parseVofficeUnitData, i as VofficeUnitDataPropertyMetadata, n as VofficeUnitDataPropertyCategoryLabelKeys, o as parseVofficeFacilityData, r as VofficeUnitDataPropertyCategoryValues, s as parseVofficeFeedbackData, t as VofficeUnitDataFieldSchemas } from "./v9-data-BnYxa2Ek.mjs";
+import { a as toAddress, c as rentalFacilitiesForObjectGroupRelationQuery, d as rentalsAllFeedbacksQuery, f as rentalsAllWithoutFeedbacksQuery, i as toImages, l as rentalIdsQuery, n as renderVofficePropertyAttribute, o as toLocalizedString, r as toFacilityImages, t as toRentalHighlights, u as rentalsAllByFacilityObjectGroupsWithoutFeedbacksQuery } from "./to-rental-highlights-CJvDxSLw.mjs";
+import { CoreSDKError, makeTranslate, renderResolvedCustomAttribute, toCustomAttributeList, toResolvedCustomAttributeCategoryTranslationKey } from "@v-office/sdk-core";
 import { Effect } from "effect";
 //#region src/legacy-v9/parser/rentals/to-description.ts
 const toDescription = (data, locale) => {
@@ -33,20 +35,128 @@ const toLocation = (location) => {
 	};
 };
 //#endregion
+//#region src/legacy-v9/parser/rentals/to-property-attributes.ts
+const toPropertyAttributes = ({ attributes, locale, translations }) => Effect.gen(function* () {
+	const items = [];
+	const translate = makeTranslate(translations, locale);
+	for (const key of V9_FACILITY_ATTRIBUTE_KEYS) {
+		const item = yield* renderVofficePropertyAttribute({
+			key,
+			metadata: VofficeUnitDataPropertyMetadata[key],
+			locale,
+			translate,
+			value: attributes.known[key]
+		});
+		if (item != null) items.push(item);
+	}
+	if (items.length === 0) return [];
+	const label = yield* translate(VofficeUnitDataPropertyCategoryLabelKeys.GENERAL, "GENERAL");
+	return [{
+		label,
+		subCategories: [{
+			label,
+			items
+		}]
+	}];
+});
+//#endregion
+//#region src/legacy-v9/parser/rentals/to-line-list.ts
+const toLineList = (value, locale) => {
+	const text = toLocalizedString(value, locale);
+	if (text == null) return [];
+	return [...new Set(text.split(/\r?\n/).map((item) => item.trim()).filter((item) => item.length > 0))];
+};
+//#endregion
+//#region src/legacy-v9/parser/rentals/to-property-highlights.ts
+const facilityAttributeKeys = new Set(V9_FACILITY_ATTRIBUTE_KEYS);
+const isFacilityAttributeKey = (key) => facilityAttributeKeys.has(key);
+const toPropertyHighlights = ({ attributes, highlightPrioritization, highlightSources, locale, translations }) => Effect.gen(function* () {
+	const highlights = [];
+	const seenHighlights = /* @__PURE__ */ new Set();
+	const seenKeys = /* @__PURE__ */ new Set();
+	const translate = makeTranslate(translations, locale);
+	for (const key of highlightPrioritization) {
+		if (seenKeys.has(key)) continue;
+		seenKeys.add(key);
+		if (isFacilityAttributeKey(key)) {
+			const highlight = yield* renderVofficePropertyAttribute({
+				key,
+				metadata: VofficeUnitDataPropertyMetadata[key],
+				locale,
+				translate,
+				value: attributes.known[key]
+			});
+			if (highlight != null && !seenHighlights.has(highlight)) {
+				seenHighlights.add(highlight);
+				highlights.push(highlight);
+			}
+			continue;
+		}
+		const source = Object.hasOwn(highlightSources.byKey, key) ? highlightSources.byKey[key] : void 0;
+		if (source == null) continue;
+		for (const highlight of toLineList(attributes.unknown[source.v9], locale)) {
+			if (seenHighlights.has(highlight)) continue;
+			seenHighlights.add(highlight);
+			highlights.push(highlight);
+		}
+	}
+	return highlights;
+});
+//#endregion
+//#region src/legacy-v9/parser/rentals/to-property-type.ts
+const propertyTypeByV9FacilityType = {
+	CAMPGROUND: "CAMPGROUND",
+	FARM: "FARM",
+	FLAT_FAC: "APARTMENT_COMPLEX",
+	HOSTEL: "HOSTEL",
+	HOTEL: "HOTEL",
+	HOUSE_FAC: "HOLIDAY_HOME_COMPLEX"
+};
+const isV9FacilityType = (value) => Object.hasOwn(propertyTypeByV9FacilityType, value);
+const toPropertyType = ({ facilityType, locale, translations }) => Effect.gen(function* () {
+	if (facilityType == null || !isV9FacilityType(facilityType)) return void 0;
+	const propertyType = propertyTypeByV9FacilityType[facilityType];
+	return yield* makeTranslate(translations, locale)(`Property.propertyType.option.${propertyType}`, propertyType);
+});
+//#endregion
 //#region src/legacy-v9/parser/rentals/to-property.ts
-const toProperty = (facility, locale) => {
+const toProperty = ({ facility, highlightPrioritization, highlightSources, locale, translations }) => Effect.gen(function* () {
 	const data = parseVofficeFacilityData(facility.data);
 	const name = toLocalizedString(data.known.name, locale);
-	const description = toLocalizedString(data.known.description, locale);
+	const description = toDescription(data, locale);
 	const images = toFacilityImages(data.known.images ?? [], locale);
+	const propertyType = yield* toPropertyType({
+		facilityType: data.known.type,
+		locale,
+		translations
+	});
+	const location = toLocation(data.known.loc);
+	const address = toAddress(data, locale);
+	const attributes = yield* toPropertyAttributes({
+		attributes: data,
+		locale,
+		translations
+	});
+	const highlights = yield* toPropertyHighlights({
+		attributes: data,
+		highlightPrioritization,
+		highlightSources,
+		locale,
+		translations
+	});
 	const property = {
 		id: facility.id,
 		nameOrLabel: name ?? facility.name
 	};
-	if (description != null) property.description = { description };
+	if (propertyType != null) property.propertyType = propertyType;
+	if (location != null) property.location = location;
+	if (Object.keys(address).length > 0) property.address = address;
+	if (Object.keys(description).length > 0) property.description = description;
 	if (images.length > 0) property.images = images;
+	if (attributes.length > 0) property.attributes = attributes;
+	if (highlights.length > 0) property.highlights = highlights;
 	return property;
-};
+});
 //#endregion
 //#region src/legacy-v9/parser/rentals/to-rental-attributes.ts
 const GENERAL_CATEGORY$1 = {
@@ -243,21 +353,21 @@ const BED_ATTRIBUTE_LABEL_KEYS = {
 	openFootsection: "Bed.openFootsection.label",
 	raisedBeds: "Bed.raisedBeds.label"
 };
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$1 = (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;
+		if (!isRecord$1(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;
+			if (!isRecord$1(bed)) continue;
 			const bedType = nonEmptyString(bed.type);
 			if (bedType == null) continue;
 			const bedValue = { type: yield* translate(`${BED_TYPE_KEY_PREFIX}.${bedType}`, bedType) };
@@ -277,7 +387,7 @@ const toRooms = ({ locale, translations, roomDetails }) => Effect.gen(function*
 });
 //#endregion
 //#region src/legacy-v9/parser/rentals/to-rental-list-item.ts
-const toRentalRentalsOutput = ({ rental, locale, translations, imageProxyBaseUrl, rentalHighlightPrioritization, customAttributes }) => Effect.gen(function* () {
+const toRentalRentalsOutput = ({ rental, locale, translations, imageProxyBaseUrl, rentalHighlightPrioritization, rentalPropertyHighlightPrioritization, customAttributes, v9PropertyHighlightSources }) => Effect.gen(function* () {
 	const data = parseVofficeUnitData(rental.data);
 	const rawRentalType = data.known.type?.trim();
 	const translatedRentalType = rawRentalType != null && rawRentalType.length > 0 ? yield* toRentalType({
@@ -331,12 +441,95 @@ const toRentalRentalsOutput = ({ rental, locale, translations, imageProxyBaseUrl
 	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 (rental.voffice_facility != null) item.property = yield* toProperty({
+		facility: rental.voffice_facility,
+		highlightPrioritization: rentalPropertyHighlightPrioritization,
+		highlightSources: v9PropertyHighlightSources,
+		locale,
+		translations
+	});
 	if (reviews != null) item.reviews = reviews;
 	return item;
 });
 //#endregion
+//#region src/legacy-v9/static/associate-rentals-with-facilities-by-object-groups.ts
+const operation = "v9.rentals.facility-object-group-relation";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const parseGroupIds = (value) => {
+	if (value == null) return [];
+	if (typeof value === "number") return Number.isSafeInteger(value) && value > 0 ? [value] : void 0;
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		if (trimmed.length === 0) return [];
+		if (!/^[\d\s,;]+$/.test(trimmed)) return void 0;
+		const groupIds = trimmed.split(/[\s,;]+/).filter((part) => part.length > 0).map(Number);
+		return groupIds.every((groupId) => Number.isSafeInteger(groupId) && groupId > 0) ? groupIds : void 0;
+	}
+	if (Array.isArray(value)) {
+		const groupIds = value.flatMap((part) => parseGroupIds(part) ?? [NaN]);
+		return groupIds.every((groupId) => Number.isSafeInteger(groupId) && groupId > 0) ? groupIds : void 0;
+	}
+	if (isRecord(value)) {
+		const groupIds = Object.values(value).flatMap((part) => parseGroupIds(part) ?? [NaN]);
+		return groupIds.every((groupId) => Number.isSafeInteger(groupId) && groupId > 0) ? groupIds : void 0;
+	}
+};
+const toFacilityId = (facility) => {
+	const facilityId = Number(facility.id);
+	if (Number.isSafeInteger(facilityId) && facilityId > 0) return facilityId;
+	throw new CoreSDKError({
+		source: "v9",
+		operation,
+		message: `Expected facility.id to be a positive integer, received "${facility.id}".`
+	});
+};
+const associateRentalsWithFacilitiesByObjectGroups = ({ attributeId, facilities, rentals }) => {
+	const attribute = `p_${attributeId}`;
+	const facilityByGroupId = /* @__PURE__ */ new Map();
+	for (const facility of facilities) {
+		const relation = parseVofficeFacilityData(facility.data).unknown[attribute];
+		const groupIds = parseGroupIds(relation);
+		if (groupIds === void 0) throw new CoreSDKError({
+			source: "v9",
+			operation,
+			message: `Facility "${facility.id}" has an invalid ${attribute} value.`
+		});
+		for (const groupId of new Set(groupIds)) {
+			const existingFacility = facilityByGroupId.get(groupId);
+			if (existingFacility != null && existingFacility.id !== facility.id) throw new CoreSDKError({
+				source: "v9",
+				operation,
+				message: `Object group "${groupId}" is assigned to facilities "${existingFacility.id}" and "${facility.id}".`
+			});
+			facilityByGroupId.set(groupId, facility);
+		}
+	}
+	if (facilityByGroupId.size === 0) throw new CoreSDKError({
+		source: "v9",
+		operation,
+		message: `No facility has a usable ${attribute} object-group relation.`
+	});
+	return rentals.map((rental) => {
+		const matchingFacilities = /* @__PURE__ */ new Map();
+		for (const group of rental.voffice_groups ?? []) {
+			const facility = facilityByGroupId.get(group.voffice_group_id);
+			if (facility != null) matchingFacilities.set(facility.id, facility);
+		}
+		if (matchingFacilities.size > 1) throw new CoreSDKError({
+			source: "v9",
+			operation,
+			message: `Rental "${rental.voffice_id}" matches several facilities through ${attribute}.`
+		});
+		const facility = matchingFacilities.values().next().value;
+		return {
+			...rental,
+			voffice_facility_id: facility == null ? null : toFacilityId(facility),
+			voffice_facility: facility ?? null
+		};
+	});
+};
+//#endregion
 //#region src/legacy-v9/runtime/rentals.ts
 const defaultRentalDataAttributes = Object.keys(VofficeUnitDataFieldSchemas);
 //#endregion
-export { defaultRentalDataAttributes, rentalsAllFeedbacksQuery, rentalsAllWithoutFeedbacksQuery, toRentalRentalsOutput };
+export { associateRentalsWithFacilitiesByObjectGroups, defaultRentalDataAttributes, rentalFacilitiesForObjectGroupRelationQuery, rentalIdsQuery, rentalsAllByFacilityObjectGroupsWithoutFeedbacksQuery, rentalsAllFeedbacksQuery, rentalsAllWithoutFeedbacksQuery, toRentalRentalsOutput };

package/dist/{search-DkXUHJt8.mjs → search-CR1UjnmR.mjs}

@@ -1,5 +1,6 @@
-import { a as parseQueryParameters, i as collectQueryParameters, n as makeV9CustomAttributeFilterCapabilities, o as toQueryString, r as toBasicQueryInputs, s as applyVofficeFilterDerivedBasicQueryInputs } from "./client-yYl7H82t.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 { a as parseQueryParameters, i as collectQueryParameters, n as makeV9CustomAttributeFilterCapabilities, o as toQueryString, r as toBasicQueryInputs, s as applyVofficeFilterDerivedBasicQueryInputs } from "./client-BnA0oXd_.mjs";
+import { c as parseVofficeUnitData, t as VofficeUnitDataFieldSchemas } from "./v9-data-BnYxa2Ek.mjs";
+import { a as toAddress, i as toImages, s as searchQuery, t as toRentalHighlights } from "./to-rental-highlights-CJvDxSLw.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";
 //#region src/legacy-v9/parser/search/input/search-input-error.ts