@v-office/website-sdk 2.21.0 → 2.22.0

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Bt as defineWebsiteSDKOptions, Ht as defineV9PropertyHighlightSourcesFromUnknown, t as createWebsiteSDK } from "./client-dWCukmLr.mjs";
+import { Bt as defineWebsiteSDKOptions, Ht as defineV9PropertyHighlightSourcesFromUnknown, t as createWebsiteSDK } from "./client-BtZ30vTP.mjs";
 import { SearchSearchSortSchema, defineCustomAttributesFromUnknown } from "@v-office/sdk-core";
 import { ByteSize, Console, Effect, FileSystem, Layer, Option, Path, Schema, Stdio, Terminal } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
@@ -16,7 +16,7 @@ var CLICheckFailed = class extends Error {
 const toCLIError = (message, cause) => cause instanceof Error ? new CLICheckFailed(`${message}: ${cause.message}`, { cause }) : new CLICheckFailed(message, { cause });
 //#endregion
 //#region package.json
-var version = "2.21.0";
+var version = "2.22.0";
 //#endregion
 //#region src/cli/output.ts
 const toJson = (value) => Effect.try({

package/dist/{client-dWCukmLr.mjs → client-BtZ30vTP.mjs}

@@ -5687,7 +5687,7 @@ const parseV9SearchCursor = (cursor) => Effect.gen(function* () {
 	return page;
 });
 const loadV9SearchRuntime = Effect.tryPromise({
-	try: () => import("./search-D9xq3Z-m.mjs"),
+	try: () => import("./search-CZ1TRGAB.mjs"),
 	catch: (cause) => new CoreSDKError({
 		source: "v10",
 		operation: "v9.search.runtime",
@@ -5709,7 +5709,7 @@ const makeV9SearchApi = ({ config, options }) => {
 		})
 	}));
 	return { search: (input) => Effect.runPromise(limitSearch(Effect.gen(function* () {
-		const { defaultSearchDataAttributes, resolveExactMatch, searchQuery, toAlternativePeriods, toQueryInput, toSearchOutputItem } = yield* loadV9SearchRuntime;
+		const { defaultSearchDataAttributes, resolveExactMatch, searchQuery, toQueryInput, toSearchOutputItem, toSearchPeriods } = yield* loadV9SearchRuntime;
 		const dataAttributes = [
 			...defaultSearchDataAttributes,
 			...config.rentalDataAttributes ?? [],
@@ -5748,17 +5748,26 @@ const makeV9SearchApi = ({ config, options }) => {
 				exactMatchCalc,
 				translations
 			});
-			if (isExactMatch) return {
-				type: "item",
-				item
-			};
+			if (isExactMatch) {
+				const matchingPeriods = yield* toSearchPeriods({
+					locale: input.locale,
+					periods
+				});
+				return {
+					type: "item",
+					item: matchingPeriods.length > 0 ? {
+						...item,
+						matchingPeriods
+					} : item
+				};
+			}
 			if (periods.length === 0) return {
 				type: "item",
 				item
 			};
-			const alternativePeriods = yield* toAlternativePeriods({
+			const alternativePeriods = yield* toSearchPeriods({
 				locale: input.locale,
-				alternatives: periods
+				periods
 			});
 			if (alternativePeriods.length === 0) return {
 				type: "item",
@@ -6085,7 +6094,7 @@ const orderRentalsById = ({ rentalIds, rentals }) => {
 	});
 };
 const loadV9RentalsRuntime = Effect.tryPromise({
-	try: () => import("./rentals-CIhOx3dS.mjs"),
+	try: () => import("./rentals-DfNu7s7w.mjs"),
 	catch: (cause) => new CoreSDKError({
 		source: "v10",
 		operation: "v9.rentals.runtime",

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AdditionalServiceLimitExceeded, AvailabilityGetInitialAvailabilityInput, AvailabilityGetInitialAvailabilityInput as AvailabilityGetInitialAvailabilityInput$1, AvailabilityGetInitialAvailabilityOutput, AvailabilityGetInitialAvailabilityOutput as AvailabilityGetInitialAvailabilityOutput$1, AvailabilityGetStartDateSelectedAvailabilityInput, AvailabilityGetStartDateSelectedAvailabilityInput as AvailabilityGetStartDateSelectedAvailabilityInput$1, AvailabilityGetStartDateSelectedAvailabilityOutput, AvailabilityGetStartDateSelectedAvailabilityOutput as AvailabilityGetStartDateSelectedAvailabilityOutput$1, AvailabilityService, BackendKind, BookingBankTransferDetails, BookingBankTransferDetails as BookingBankTransferDetails$1, BookingBookInput, BookingBookInput as BookingBookInput$1, BookingBookOutput, BookingBookOutput as BookingBookOutput$1, BookingPayment, BookingPaymentAlternative, BookingPaymentOption, BookingPaymentScheduleItem, BookingPaymentScheduleKind, BookingPaymentScheduleLine, BookingService, ContactService, ContactSubmitInput, ContactSubmitInput as ContactSubmitInput$1, ContactSubmitOutput, ContactSubmitOutput as ContactSubmitOutput$1, ContactSubmitValidationIssue, ContactSubmitValidationIssueCode, CoreSDKError, CoreSDKError as CMSError, CoreSDKError as CoreSDKError$1, CustomAttributeCatalog, CustomAttributeCatalogDefinitionInput, CustomAttributeCatalogInput, CustomAttributeCatalogSchema, CustomAttributeCategoryKey, CustomAttributeFilterCategoryKey, CustomAttributeFilterDefinition, CustomAttributeFilterDefinition as CustomAttributeFilterDefinition$1, CustomAttributeFilterExpression, CustomAttributeFilterLabel, CustomAttributeFilterNumericBounds, CustomAttributeFilterOption, CustomAttributeOverridesInput, CustomAttributeRegistry, CustomAttributeRegistrySnapshot, CustomAttributeRegistrySnapshot as CustomAttributeRegistrySnapshot$1, CustomAttributeSelection, DocumentsGetTermsAndPrivacyPolicyInput, DocumentsGetTermsAndPrivacyPolicyInput as DocumentsGetTermsAndPrivacyPolicyInput$1, DocumentsGetTermsAndPrivacyPolicyOutput, DocumentsGetTermsAndPrivacyPolicyOutput as DocumentsGetTermsAndPrivacyPolicyOutput$1, DocumentsService, FilterGetFiltersInput, FilterGetFiltersInput as FilterGetFiltersInput$1, FilterGetFiltersOutput, FilterGetFiltersOutput as FilterGetFiltersOutput$1, FilterService, GuestQuote, GuestQuoteInput, GuestQuoteInsurance, GuestQuoteResult, GuestQuoteSchema, GuestQuoteSelectionResult, GuestQuoteVoucher, InsuranceBookingOutput, InsuranceCustomerInformationInput, InsurancePaymentInformationInput, InsurancePaymentOptionOutput, InsurancePreContractOutput, InvalidAdditionalServiceQuantity, Locale, LocaleSchema, QuoteAddAdditionalServiceInput, QuoteAddAdditionalServiceOutput, QuoteBookInsuranceInput, QuoteBookInsuranceOutput, QuoteClearAdditionalServicesInput, QuoteClearAdditionalServicesOutput, QuoteCreateInsurancePreContractInput, QuoteCreateInsurancePreContractOutput, QuoteQuoteInput, QuoteQuoteInput as QuoteQuoteInput$1, QuoteQuoteOutput, QuoteQuoteOutput as QuoteQuoteOutput$1, QuoteRemoveAdditionalServiceInput, QuoteRemoveAdditionalServiceOutput, QuoteSelectCancellationPolicyInput, QuoteSelectCancellationPolicyOutput, QuoteSelectInsuranceInput, QuoteSelectInsuranceOutput, QuoteSelectInsurancePaymentInput, QuoteSelectInsurancePaymentOutput, QuoteService as QuoteService$1, RentalGetRentalsInput, RentalGetRentalsInput as RentalGetRentalsInput$1, RentalGetRentalsOutput, RentalGetRentalsOutput as RentalGetRentalsOutput$1, RentalHighlightPrioritizationKey, RentalHighlightPrioritizationKey as RentalHighlightPrioritizationKey$1, RentalPropertyHighlightPrioritizationKey, RentalPropertyHighlightPrioritizationKey as RentalPropertyHighlightPrioritizationKey$1, RentalScope, RentalService, ResolvedCustomAttribute, SearchSearchFieldOrderBy, SearchSearchFieldOrderBySchema, SearchSearchFieldSort, SearchSearchFieldSort as SearchSearchFieldSort$1, SearchSearchFieldSortSchema, SearchSearchInput, SearchSearchInput as SearchSearchInput$1, SearchSearchInputSchema, SearchSearchOutput, SearchSearchOutput as SearchSearchOutput$1, SearchSearchOutputSchema, SearchSearchPriceSort, SearchSearchPriceSortSchema, SearchSearchRandomSort, SearchSearchRandomSortSchema, SearchSearchRatingSort, SearchSearchRatingSortSchema, SearchSearchSort, SearchSearchSort as SearchSearchSort$1, SearchSearchSortSchema, SearchService, SearchSortDirection, SearchSortDirectionSchema, SelectableInsuranceOptionOutput, SelectedInsuranceInformationInput, SubmittableBookingPaymentOption, SubmittableBookingPaymentOption as SubmittableBookingPaymentOption$1, TranslationOverrides, TranslationOverrides as TranslationOverrides$1, UnknownAdditionalService, V10CoreConfig, V9OnlyCustomAttributeInput, defineCustomAttributes, defineCustomAttributesFromUnknown, fetchCustomAttributeCatalog, parseCustomAttributeCatalog, validateContactSubmitInput } from "@v-office/sdk-core";
+import { AdditionalServiceLimitExceeded, AvailabilityGetInitialAvailabilityInput, AvailabilityGetInitialAvailabilityInput as AvailabilityGetInitialAvailabilityInput$1, AvailabilityGetInitialAvailabilityOutput, AvailabilityGetInitialAvailabilityOutput as AvailabilityGetInitialAvailabilityOutput$1, AvailabilityGetStartDateSelectedAvailabilityInput, AvailabilityGetStartDateSelectedAvailabilityInput as AvailabilityGetStartDateSelectedAvailabilityInput$1, AvailabilityGetStartDateSelectedAvailabilityOutput, AvailabilityGetStartDateSelectedAvailabilityOutput as AvailabilityGetStartDateSelectedAvailabilityOutput$1, AvailabilityService, BackendKind, BookingBankTransferDetails, BookingBankTransferDetails as BookingBankTransferDetails$1, BookingBookInput, BookingBookInput as BookingBookInput$1, BookingBookOutput, BookingBookOutput as BookingBookOutput$1, BookingPayment, BookingPaymentAlternative, BookingPaymentOption, BookingPaymentScheduleItem, BookingPaymentScheduleKind, BookingPaymentScheduleLine, BookingService, ContactService, ContactSubmitInput, ContactSubmitInput as ContactSubmitInput$1, ContactSubmitOutput, ContactSubmitOutput as ContactSubmitOutput$1, ContactSubmitValidationIssue, ContactSubmitValidationIssueCode, CoreSDKError, CoreSDKError as CMSError, CoreSDKError as CoreSDKError$1, CustomAttributeCatalog, CustomAttributeCatalogDefinitionInput, CustomAttributeCatalogInput, CustomAttributeCatalogSchema, CustomAttributeCategoryKey, CustomAttributeFilterCategoryKey, CustomAttributeFilterDefinition, CustomAttributeFilterDefinition as CustomAttributeFilterDefinition$1, CustomAttributeFilterExpression, CustomAttributeFilterLabel, CustomAttributeFilterNumericBounds, CustomAttributeFilterOption, CustomAttributeOverridesInput, CustomAttributeRegistry, CustomAttributeRegistrySnapshot, CustomAttributeRegistrySnapshot as CustomAttributeRegistrySnapshot$1, CustomAttributeSelection, DocumentsGetTermsAndPrivacyPolicyInput, DocumentsGetTermsAndPrivacyPolicyInput as DocumentsGetTermsAndPrivacyPolicyInput$1, DocumentsGetTermsAndPrivacyPolicyOutput, DocumentsGetTermsAndPrivacyPolicyOutput as DocumentsGetTermsAndPrivacyPolicyOutput$1, DocumentsService, FilterGetFiltersInput, FilterGetFiltersInput as FilterGetFiltersInput$1, FilterGetFiltersOutput, FilterGetFiltersOutput as FilterGetFiltersOutput$1, FilterService, GuestQuote, GuestQuoteInput, GuestQuoteInsurance, GuestQuoteResult, GuestQuoteSchema, GuestQuoteSelectionResult, GuestQuoteVoucher, InsuranceBookingOutput, InsuranceCustomerInformationInput, InsurancePaymentInformationInput, InsurancePaymentOptionOutput, InsurancePreContractOutput, InvalidAdditionalServiceQuantity, Locale, LocaleSchema, QuoteAddAdditionalServiceInput, QuoteAddAdditionalServiceOutput, QuoteBookInsuranceInput, QuoteBookInsuranceOutput, QuoteClearAdditionalServicesInput, QuoteClearAdditionalServicesOutput, QuoteCreateInsurancePreContractInput, QuoteCreateInsurancePreContractOutput, QuoteQuoteInput, QuoteQuoteInput as QuoteQuoteInput$1, QuoteQuoteOutput, QuoteQuoteOutput as QuoteQuoteOutput$1, QuoteRemoveAdditionalServiceInput, QuoteRemoveAdditionalServiceOutput, QuoteSelectCancellationPolicyInput, QuoteSelectCancellationPolicyOutput, QuoteSelectInsuranceInput, QuoteSelectInsuranceOutput, QuoteSelectInsurancePaymentInput, QuoteSelectInsurancePaymentOutput, QuoteService as QuoteService$1, RentalGetRentalsInput, RentalGetRentalsInput as RentalGetRentalsInput$1, RentalGetRentalsOutput, RentalGetRentalsOutput as RentalGetRentalsOutput$1, RentalHighlightPrioritizationKey, RentalHighlightPrioritizationKey as RentalHighlightPrioritizationKey$1, RentalPropertyHighlightPrioritizationKey, RentalPropertyHighlightPrioritizationKey as RentalPropertyHighlightPrioritizationKey$1, RentalScope, RentalService, ResolvedCustomAttribute, SearchSearchAlternative, SearchSearchFieldOrderBy, SearchSearchFieldOrderBySchema, SearchSearchFieldSort, SearchSearchFieldSort as SearchSearchFieldSort$1, SearchSearchFieldSortSchema, SearchSearchInput, SearchSearchInput as SearchSearchInput$1, SearchSearchInputSchema, SearchSearchOutput, SearchSearchOutput as SearchSearchOutput$1, SearchSearchOutputItem, SearchSearchOutputSchema, SearchSearchPriceSort, SearchSearchPriceSortSchema, SearchSearchRandomSort, SearchSearchRandomSortSchema, SearchSearchRatingSort, SearchSearchRatingSortSchema, SearchSearchSort, SearchSearchSort as SearchSearchSort$1, SearchSearchSortSchema, SearchService, SearchSortDirection, SearchSortDirectionSchema, SelectableInsuranceOptionOutput, SelectedInsuranceInformationInput, SubmittableBookingPaymentOption, SubmittableBookingPaymentOption as SubmittableBookingPaymentOption$1, TranslationOverrides, TranslationOverrides as TranslationOverrides$1, UnknownAdditionalService, V10CoreConfig, V9OnlyCustomAttributeInput, defineCustomAttributes, defineCustomAttributesFromUnknown, fetchCustomAttributeCatalog, parseCustomAttributeCatalog, validateContactSubmitInput } from "@v-office/sdk-core";
 import { Context, Effect, Layer, Schema } from "effect";
 import { HttpClient } from "effect/unstable/http";
 //#region src/legacy-v9/property-highlight-sources.d.ts
@@ -77,6 +77,14 @@ type V9SearchSearchInput = Omit<SearchSearchInput$1, "rentalIdsIn" | "voucher" |
   readonly sort?: V9SearchSearchSort;
 };
 //#endregion
+//#region src/legacy-v9/search-output.d.ts
+type V9SearchSearchOutputItem = SearchSearchOutputItem & {
+  readonly matchingPeriods?: SearchSearchAlternative["alternativePeriods"];
+};
+type V9SearchSearchOutput = Omit<SearchSearchOutput$1, "items"> & {
+  readonly items: readonly V9SearchSearchOutputItem[];
+};
+//#endregion
 //#region src/client.d.ts
 type WebsiteSDKSharedStatic = {
   readonly rentals: {
@@ -130,7 +138,7 @@ type WebsiteSDKSharedLive = {
 type WebsiteSDKV10Live = WebsiteSDKSharedLive;
 type WebsiteSDKV9Live = Omit<WebsiteSDKSharedLive, "search"> & {
   readonly search: {
-    readonly search: (input: V9SearchSearchInput) => Promise<SearchSearchOutput$1>;
+    readonly search: (input: V9SearchSearchInput) => Promise<V9SearchSearchOutput>;
   };
 };
 type WebsiteSDKBase<Static extends WebsiteSDKSharedStatic, Live> = {
@@ -7518,4 +7526,4 @@ export type RentalRentalsOutput = RentalGetRentalsOutput$1[number];
 export type RentalSearchInput = SearchSearchInput$1;
 export type RentalSearchOutput = SearchSearchOutput$1;
 //#endregion
-export { AdditionalServiceLimitExceeded, type AvailabilityGetInitialAvailabilityInput, type AvailabilityGetInitialAvailabilityOutput, type AvailabilityGetStartDateSelectedAvailabilityInput, type AvailabilityGetStartDateSelectedAvailabilityOutput, type BackendKind, type BookingBankTransferDetails, type BookingBookInput, type BookingBookOutput, type BookingPayment, type BookingPaymentAlternative, type BookingPaymentOption, type BookingPaymentScheduleItem, type BookingPaymentScheduleKind, type BookingPaymentScheduleLine, CMSError, type ContactSubmitInput, type ContactSubmitOutput, type ContactSubmitValidationIssue, type ContactSubmitValidationIssueCode, CoreSDKError, type CustomAttributeCatalog, type CustomAttributeCatalogDefinitionInput, type CustomAttributeCatalogInput, CustomAttributeCatalogSchema, type CustomAttributeCategoryKey, type CustomAttributeFilterCategoryKey, type CustomAttributeFilterDefinition, type CustomAttributeFilterExpression, type CustomAttributeFilterLabel, type CustomAttributeFilterNumericBounds, type CustomAttributeFilterOption, type CustomAttributeOverridesInput, type CustomAttributeRegistry, type CustomAttributeRegistrySnapshot, type CustomAttributeSelection, type CustomDataAttribute, type DataAttribute, type DocumentsGetTermsAndPrivacyPolicyInput, type DocumentsGetTermsAndPrivacyPolicyOutput, type FilterGetFiltersInput, type FilterGetFiltersOutput, type GeoLocation, type GuestQuote, type GuestQuoteInput, type GuestQuoteInsurance, type GuestQuoteResult, GuestQuoteSchema, type GuestQuoteSelectionResult, type GuestQuoteVoucher, type ImageData, type InsuranceBookingOutput, type InsuranceCustomerInformationInput, type InsurancePaymentInformationInput, type InsurancePaymentOptionOutput, type InsurancePreContractOutput, InvalidAdditionalServiceQuantity, type KnownVofficeFacilityData, type KnownVofficeFacilityDataAttribute, type KnownVofficeFeedbackData, type KnownVofficeFeedbackDataAttribute, type KnownVofficeImageData, type KnownVofficeImageDataAttribute, type KnownVofficeOfferData, type KnownVofficeOfferDataAttribute, type KnownVofficePriceData, type KnownVofficePriceDataAttribute, type KnownVofficeRatingData, type KnownVofficeRatingDataAttribute, type KnownVofficeServiceData, type KnownVofficeServiceDataAttribute, type KnownVofficeTotalRatingData, type KnownVofficeTotalRatingDataAttribute, type KnownVofficeUnitData, type KnownVofficeUnitDataAttribute, type Locale, LocaleSchema, type ParsedJsonData, type ParsedVofficeFacilityData, type ParsedVofficeFeedbackData, type ParsedVofficeImageData, type ParsedVofficeOfferData, type ParsedVofficePriceData, type ParsedVofficeRatingData, type ParsedVofficeServiceData, type ParsedVofficeTotalRatingData, type ParsedVofficeUnitData, type QuoteQuoteInput, type QuoteQuoteOutput, type RentalGetRentalsInput, type RentalGetRentalsOutput, type RentalHighlightPrioritizationKey, type RentalPropertyHighlightPrioritizationKey, type ResolvedCustomAttribute, type ResolvedV9PropertyHighlightSource, type SearchSearchFieldOrderBy, SearchSearchFieldOrderBySchema, type SearchSearchFieldSort, SearchSearchFieldSortSchema, type SearchSearchInput, SearchSearchInputSchema, type SearchSearchOutput, SearchSearchOutputSchema, type SearchSearchPriceSort, SearchSearchPriceSortSchema, type SearchSearchRandomSort, SearchSearchRandomSortSchema, type SearchSearchRatingSort, SearchSearchRatingSortSchema, type SearchSearchSort, SearchSearchSortSchema, type SearchSortDirection, SearchSortDirectionSchema, type SelectableInsuranceOptionOutput, type SelectedInsuranceInformationInput, type SubmittableBookingPaymentOption, type TranslationOverrides, UnknownAdditionalService, type V0OpenApiClientOptions, type V0OpenApiOperationId, type V0OpenApiOperationRequest, type V0OpenApiOperationResponse, type V1OpenApiClientOptions, type components as V1OpenApiComponents, type V1OpenApiOperationId, type V1OpenApiOperationRequest, type V1OpenApiOperationResponse, type operations as V1OpenApiOperations, type paths as V1OpenApiPaths, type V9OnlyCustomAttributeInput, type V9PropertyHighlightDataAttribute, type V9PropertyHighlightSourceInput, type V9PropertyHighlightSourceRegistry, type V9PropertyHighlightSourcesInput, type V9SearchSearchInput, type V9SearchSearchSort, type VofficeFacilityDataAttribute, type VofficeFacilityDataAttributes, type VofficeFeedbackDataAttribute, type VofficeFeedbackDataAttributes, type VofficeImageDataAttribute, type VofficeImageDataAttributes, type VofficeOfferDataAttribute, type VofficeOfferDataAttributes, type VofficePriceDataAttribute, type VofficePriceDataAttributes, type VofficeRatingDataAttribute, type VofficeRatingDataAttributes, type VofficeServiceDataAttribute, type VofficeServiceDataAttributes, type VofficeTotalRatingDataAttribute, type VofficeTotalRatingDataAttributes, type VofficeUnitDataAttribute, type VofficeUnitDataAttributes, type WebsiteSDK, type WebsiteSDKConfig, type WebsiteSDKOptions, type WebsiteSDKSharedLive, type WebsiteSDKSharedStatic, type WebsiteSDKV10, type WebsiteSDKV10Live, type WebsiteSDKV10Static, type WebsiteSDKV9, type WebsiteSDKV9Live, defineWebsiteSDKOptions as defineCMSSDKOptions, defineCustomAttributes, defineCustomAttributesFromUnknown, fetchCustomAttributeCatalog, parseCustomAttributeCatalog, validateContactSubmitInput };
+export { AdditionalServiceLimitExceeded, type AvailabilityGetInitialAvailabilityInput, type AvailabilityGetInitialAvailabilityOutput, type AvailabilityGetStartDateSelectedAvailabilityInput, type AvailabilityGetStartDateSelectedAvailabilityOutput, type BackendKind, type BookingBankTransferDetails, type BookingBookInput, type BookingBookOutput, type BookingPayment, type BookingPaymentAlternative, type BookingPaymentOption, type BookingPaymentScheduleItem, type BookingPaymentScheduleKind, type BookingPaymentScheduleLine, CMSError, type ContactSubmitInput, type ContactSubmitOutput, type ContactSubmitValidationIssue, type ContactSubmitValidationIssueCode, CoreSDKError, type CustomAttributeCatalog, type CustomAttributeCatalogDefinitionInput, type CustomAttributeCatalogInput, CustomAttributeCatalogSchema, type CustomAttributeCategoryKey, type CustomAttributeFilterCategoryKey, type CustomAttributeFilterDefinition, type CustomAttributeFilterExpression, type CustomAttributeFilterLabel, type CustomAttributeFilterNumericBounds, type CustomAttributeFilterOption, type CustomAttributeOverridesInput, type CustomAttributeRegistry, type CustomAttributeRegistrySnapshot, type CustomAttributeSelection, type CustomDataAttribute, type DataAttribute, type DocumentsGetTermsAndPrivacyPolicyInput, type DocumentsGetTermsAndPrivacyPolicyOutput, type FilterGetFiltersInput, type FilterGetFiltersOutput, type GeoLocation, type GuestQuote, type GuestQuoteInput, type GuestQuoteInsurance, type GuestQuoteResult, GuestQuoteSchema, type GuestQuoteSelectionResult, type GuestQuoteVoucher, type ImageData, type InsuranceBookingOutput, type InsuranceCustomerInformationInput, type InsurancePaymentInformationInput, type InsurancePaymentOptionOutput, type InsurancePreContractOutput, InvalidAdditionalServiceQuantity, type KnownVofficeFacilityData, type KnownVofficeFacilityDataAttribute, type KnownVofficeFeedbackData, type KnownVofficeFeedbackDataAttribute, type KnownVofficeImageData, type KnownVofficeImageDataAttribute, type KnownVofficeOfferData, type KnownVofficeOfferDataAttribute, type KnownVofficePriceData, type KnownVofficePriceDataAttribute, type KnownVofficeRatingData, type KnownVofficeRatingDataAttribute, type KnownVofficeServiceData, type KnownVofficeServiceDataAttribute, type KnownVofficeTotalRatingData, type KnownVofficeTotalRatingDataAttribute, type KnownVofficeUnitData, type KnownVofficeUnitDataAttribute, type Locale, LocaleSchema, type ParsedJsonData, type ParsedVofficeFacilityData, type ParsedVofficeFeedbackData, type ParsedVofficeImageData, type ParsedVofficeOfferData, type ParsedVofficePriceData, type ParsedVofficeRatingData, type ParsedVofficeServiceData, type ParsedVofficeTotalRatingData, type ParsedVofficeUnitData, type QuoteQuoteInput, type QuoteQuoteOutput, type RentalGetRentalsInput, type RentalGetRentalsOutput, type RentalHighlightPrioritizationKey, type RentalPropertyHighlightPrioritizationKey, type ResolvedCustomAttribute, type ResolvedV9PropertyHighlightSource, type SearchSearchFieldOrderBy, SearchSearchFieldOrderBySchema, type SearchSearchFieldSort, SearchSearchFieldSortSchema, type SearchSearchInput, SearchSearchInputSchema, type SearchSearchOutput, SearchSearchOutputSchema, type SearchSearchPriceSort, SearchSearchPriceSortSchema, type SearchSearchRandomSort, SearchSearchRandomSortSchema, type SearchSearchRatingSort, SearchSearchRatingSortSchema, type SearchSearchSort, SearchSearchSortSchema, type SearchSortDirection, SearchSortDirectionSchema, type SelectableInsuranceOptionOutput, type SelectedInsuranceInformationInput, type SubmittableBookingPaymentOption, type TranslationOverrides, UnknownAdditionalService, type V0OpenApiClientOptions, type V0OpenApiOperationId, type V0OpenApiOperationRequest, type V0OpenApiOperationResponse, type V1OpenApiClientOptions, type components as V1OpenApiComponents, type V1OpenApiOperationId, type V1OpenApiOperationRequest, type V1OpenApiOperationResponse, type operations as V1OpenApiOperations, type paths as V1OpenApiPaths, type V9OnlyCustomAttributeInput, type V9PropertyHighlightDataAttribute, type V9PropertyHighlightSourceInput, type V9PropertyHighlightSourceRegistry, type V9PropertyHighlightSourcesInput, type V9SearchSearchInput, type V9SearchSearchOutput, type V9SearchSearchOutputItem, type V9SearchSearchSort, type VofficeFacilityDataAttribute, type VofficeFacilityDataAttributes, type VofficeFeedbackDataAttribute, type VofficeFeedbackDataAttributes, type VofficeImageDataAttribute, type VofficeImageDataAttributes, type VofficeOfferDataAttribute, type VofficeOfferDataAttributes, type VofficePriceDataAttribute, type VofficePriceDataAttributes, type VofficeRatingDataAttribute, type VofficeRatingDataAttributes, type VofficeServiceDataAttribute, type VofficeServiceDataAttributes, type VofficeTotalRatingDataAttribute, type VofficeTotalRatingDataAttributes, type VofficeUnitDataAttribute, type VofficeUnitDataAttributes, type WebsiteSDK, type WebsiteSDKConfig, type WebsiteSDKOptions, type WebsiteSDKSharedLive, type WebsiteSDKSharedStatic, type WebsiteSDKV10, type WebsiteSDKV10Live, type WebsiteSDKV10Static, type WebsiteSDKV9, type WebsiteSDKV9Live, defineWebsiteSDKOptions as defineCMSSDKOptions, defineCustomAttributes, defineCustomAttributesFromUnknown, fetchCustomAttributeCatalog, parseCustomAttributeCatalog, validateContactSubmitInput };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as ServiceBeonDataSchema, A as ErgoBookRequestSchema, At as getTermsAndPrivacyPolicyEffect, B as OnOfficeUnitSchema, Bt as defineWebsiteSDKOptions, C as DocumentResourceSchema, Ct as clearAdditionalServicesEffect, D as DocumentTypeSchema, Dt as getInitialAvailabilityEffect, E as DocumentSummarySchema, Et as getFiltersEffect, F as ErgoPolicyNumberRequestSchema, Ft as selectInsuranceEffect, G as QuotePricesResponseSchema, H as PaymentScheduleSchema, Ht as defineV9PropertyHighlightSourcesFromUnknown, I as ErgoReadPreContractRequestSchema, It as selectInsurancePaymentEffect, J as RawObjectResponseSchema, K as QuoteSchema, L as ErgoTripAndCustomerRequestSchema, Lt as submitContactEffect, M as ErgoCreatePreContractRequestSchema, Mt as removeAdditionalServiceEffect, N as ErgoPersonSchema, Nt as searchEffect, O as ErgoAddressSchema, Ot as getRentalsEffect, P as ErgoPlanSearchRequestSchema, Pt as selectCancellationPolicyEffect, Q as SearchPropertiesResponseSchema, R as FacilityListResponseSchema, Rt as submitPaymentOption, S as DocumentResourceResponseSchema, St as bookInsuranceEffect, T as DocumentStatusUpdateRequestSchema, Tt as getBankTransferDetailsEffect, U as QuoteLineSchema, V as PaymentScheduleItemSchema, Vt as defineV9PropertyHighlightSources, W as QuotePricesPayloadSchema, X as RegionListResponseSchema, Y as RawVofficeObjectSchema, Z as RoomImageSchema, _ as CalendarDaySchema, _t as V1_OPERATIONS, at as TileCollectionResponseSchema, b as CustomerUnitSummarySchema, bt as addAdditionalServiceEffect, c as V0OpenApiClient, ct as TravelInsuranceBookingSchema, d as makeV0OpenApiClientLive, dt as UnitListItemSchema, et as ServiceImageSchema, f as V1OpenApiClient, ft as UnitListResponseSchema, g as ApiEnvelopeBaseSchema, gt as V1_BASE_URL, h as makeV1OpenApiClientLive, ht as UnitServicePriceSchema, it as SetupResponseSchema, j as ErgoCommonFieldsSchema, jt as quoteEffect, k as ErgoBankSchema, kt as getStartDateSelectedAvailabilityEffect, l as V0OpenApiClientError, lt as TravelInsuranceBookingStoreRequestSchema, m as makeV1OpenApiClientFetchLive, mt as UnitResponseSchema, nt as ServiceListResponseSchema, ot as TileSchema, p as V1OpenApiClientError, pt as UnitOfferSchema, q as QuoteServiceSchema, rt as SetupDataSchema, st as TileTagSchema, t as createWebsiteSDK, tt as ServiceLimitSchema, u as makeV0OpenApiClientFetchLive, ut as UnitIdsResponseSchema, v as CalendarResponseSchema, vt as VideoResponseSchema, w as DocumentStatusSchema, wt as createInsurancePreContractEffect, x as DocumentCollectionResponseSchema, xt as bookEffect, y as CurrentMemberResponseSchema, yt as decodeV1OperationResponse, z as OnOfficeUnitCollectionResponseSchema, zt as submitPaymentOptionEffect } from "./client-dWCukmLr.mjs";
+import { $ as ServiceBeonDataSchema, A as ErgoBookRequestSchema, At as getTermsAndPrivacyPolicyEffect, B as OnOfficeUnitSchema, Bt as defineWebsiteSDKOptions, C as DocumentResourceSchema, Ct as clearAdditionalServicesEffect, D as DocumentTypeSchema, Dt as getInitialAvailabilityEffect, E as DocumentSummarySchema, Et as getFiltersEffect, F as ErgoPolicyNumberRequestSchema, Ft as selectInsuranceEffect, G as QuotePricesResponseSchema, H as PaymentScheduleSchema, Ht as defineV9PropertyHighlightSourcesFromUnknown, I as ErgoReadPreContractRequestSchema, It as selectInsurancePaymentEffect, J as RawObjectResponseSchema, K as QuoteSchema, L as ErgoTripAndCustomerRequestSchema, Lt as submitContactEffect, M as ErgoCreatePreContractRequestSchema, Mt as removeAdditionalServiceEffect, N as ErgoPersonSchema, Nt as searchEffect, O as ErgoAddressSchema, Ot as getRentalsEffect, P as ErgoPlanSearchRequestSchema, Pt as selectCancellationPolicyEffect, Q as SearchPropertiesResponseSchema, R as FacilityListResponseSchema, Rt as submitPaymentOption, S as DocumentResourceResponseSchema, St as bookInsuranceEffect, T as DocumentStatusUpdateRequestSchema, Tt as getBankTransferDetailsEffect, U as QuoteLineSchema, V as PaymentScheduleItemSchema, Vt as defineV9PropertyHighlightSources, W as QuotePricesPayloadSchema, X as RegionListResponseSchema, Y as RawVofficeObjectSchema, Z as RoomImageSchema, _ as CalendarDaySchema, _t as V1_OPERATIONS, at as TileCollectionResponseSchema, b as CustomerUnitSummarySchema, bt as addAdditionalServiceEffect, c as V0OpenApiClient, ct as TravelInsuranceBookingSchema, d as makeV0OpenApiClientLive, dt as UnitListItemSchema, et as ServiceImageSchema, f as V1OpenApiClient, ft as UnitListResponseSchema, g as ApiEnvelopeBaseSchema, gt as V1_BASE_URL, h as makeV1OpenApiClientLive, ht as UnitServicePriceSchema, it as SetupResponseSchema, j as ErgoCommonFieldsSchema, jt as quoteEffect, k as ErgoBankSchema, kt as getStartDateSelectedAvailabilityEffect, l as V0OpenApiClientError, lt as TravelInsuranceBookingStoreRequestSchema, m as makeV1OpenApiClientFetchLive, mt as UnitResponseSchema, nt as ServiceListResponseSchema, ot as TileSchema, p as V1OpenApiClientError, pt as UnitOfferSchema, q as QuoteServiceSchema, rt as SetupDataSchema, st as TileTagSchema, t as createWebsiteSDK, tt as ServiceLimitSchema, u as makeV0OpenApiClientFetchLive, ut as UnitIdsResponseSchema, v as CalendarResponseSchema, vt as VideoResponseSchema, w as DocumentStatusSchema, wt as createInsurancePreContractEffect, x as DocumentCollectionResponseSchema, xt as bookEffect, y as CurrentMemberResponseSchema, yt as decodeV1OperationResponse, z as OnOfficeUnitCollectionResponseSchema, zt as submitPaymentOptionEffect } from "./client-BtZ30vTP.mjs";
 import { AdditionalServiceLimitExceeded, CoreSDKError, CoreSDKError as CMSError, CustomAttributeCatalogSchema, GuestQuoteSchema, InvalidAdditionalServiceQuantity, LocaleSchema, SearchSearchFieldOrderBySchema, SearchSearchFieldSortSchema, SearchSearchInputSchema, SearchSearchOutputSchema, SearchSearchPriceSortSchema, SearchSearchRandomSortSchema, SearchSearchRatingSortSchema, SearchSearchSortSchema, SearchSortDirectionSchema, UnknownAdditionalService, defineCustomAttributes, defineCustomAttributesFromUnknown, fetchCustomAttributeCatalog, parseCustomAttributeCatalog, 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,7 @@
 
 Release notes of `@v-office/website-sdk`, newest first. Each version has its own directory.
 
+- `versions/2.22.0/CHANGELOG.md`: release notes for 2.22.0
 - `versions/2.21.0/CHANGELOG.md`: release notes for 2.21.0
 - `versions/2.20.4/CHANGELOG.md`: release notes for 2.20.4
 - `versions/2.20.3/CHANGELOG.md`: release notes for 2.20.3

package/dist/instructions/MIGRATION.md

@@ -4,6 +4,7 @@
 
 Migration guides of `@v-office/website-sdk`, newest first. Apply them in order when skipping versions.
 
+- `versions/2.22.0/MIGRATION.md`: Migration: 2.21.0 to 2.22.0
 - `versions/2.21.0/MIGRATION.md`: Migration: 2.20.4 to 2.21.0
 - `versions/2.20.4/MIGRATION.md`: Migration: 2.20.3 to 2.20.4
 - `versions/2.20.3/MIGRATION.md`: Migration: 2.20.2 to 2.20.3

package/dist/instructions/search.md

@@ -374,6 +374,35 @@ requested locale; backend numeric amounts and modifier type keys are not exposed
 individual modifier lines. Exact-period results are returned in `items`;
 alternative-period suggestions are returned in root-level `alternatives`.
 
+On legacy v9 only, an exact match may include `matchingPeriods` when the backend
+chose the dates itself in a window search (`start`/`end` plus `minNights`/`maxNights`).
+The field exists only on the v9 facade: `sdk.live.search.search` of a
+`WebsiteSDKV9` returns `V9SearchSearchOutput`, whose items are
+`V9SearchSearchOutputItem`. Narrow on `sdk.backend === "v9"` to read it. Each entry has the same shape as an `alternativePeriods` entry: `start`, `end`,
+and the optional `formattedTotal` and `discount` for that period. Entries keep the
+backend order. The item's own `formattedTotal` and `discount` are the price of the
+first entry when that entry has one; otherwise they are the backend's overall price
+for the hit. Show `matchingPeriods[0]` as the dates the card price is for, and open
+the rental page with those dates so card and detail price agree. For a
+fixed-period search without a window, the dates are the requested ones and
+`matchingPeriods` is absent, never an empty array.
+
+```json
+{
+  "id": "214950",
+  "nameOrLabel": "Ferienhaus Seeblick",
+  "timeZone": "Europe/Berlin",
+  "formattedTotal": "1.144,10 €",
+  "matchingPeriods": [
+    {
+      "start": "2026-10-01",
+      "end": "2026-10-08",
+      "formattedTotal": "1.144,10 €"
+    }
+  ]
+}
+```
+
 `appliedFilters` reports what the backend actually applied, and is what a "remove
 this filter" chip should be built from. `label` is localized presentation and can
 repeat, so it cannot identify a filter; `key` plus `value` can. `value` is the
@@ -421,6 +450,10 @@ projection:
   and booking flow.
 - Pagination uses the backend `from`/`size` window behind the same opaque `cursor`,
   capped at 1,000 results.
+- v10 items have no `matchingPeriods`. A v10 hit counts as exact only when its period
+  equals the requested fixed period; a hit the backend priced for other dates,
+  including every hit of a `minNights`/`maxNights` window search, is returned in
+  `alternatives` with its dates in `alternativePeriods`.
 
 ### Legacy v9
 
@@ -442,6 +475,12 @@ shape:
   formatted original total.
 - The same mapping applies to exact-period items and individual alternative
   periods.
+- For an exact match, every `additional_voffice_data.matchingPeriods` entry with
+  both dates becomes a `matchingPeriods` entry (`fromdate`/`tilldate` become
+  `start`/`end`, its `calc` becomes the period's price fields); entries without
+  dates are dropped. In a window search the guest enters a window and a stay
+  length, not the stay itself. The backend returns the bookable stays inside the
+  window, earliest first; the SDK keeps that order.
 - v9 never executes a custom-attribute search filter.
 
 The field is omitted when v9 returns no final total or when its original total is

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

@@ -0,0 +1,30 @@
+# Changelog: 2.22.0
+
+On a v9 hub, a search over a date window (`start`/`end` with `minNights`/`maxNights`)
+lets the hub pick the stay itself: the earliest bookable stay in the window. Such a hit came back as an exact result with a price but without the
+dates that price was for. A site could only link the rental page with the
+window the guest typed, and the detail page then showed a different price than
+the card.
+
+## Added
+
+- `v9`: exact search results carry `matchingPeriods` when the hub chose the
+  dates. Each entry has `start`, `end` and the optional `formattedTotal` and
+  `discount` for that period, in the hub's order. The field is absent for a
+  fixed-period search, never an empty array.
+- Types `V9SearchSearchOutput` and `V9SearchSearchOutputItem`.
+  `sdk.live.search.search` of a `WebsiteSDKV9` now returns
+  `V9SearchSearchOutput`; narrow on `sdk.backend === "v9"` to read
+  `matchingPeriods`.
+
+## Changed
+
+- `v9`: the `formattedTotal` and `discount` of an exact result are the price of
+  its first `matchingPeriods` entry when that entry has a price.
+
+## Unchanged
+
+- Fixed-period searches on v9: same items, same prices, no new field.
+- Alternatives and their `alternativePeriods`.
+- The v10 backend. v10 items have no `matchingPeriods`; a v10 hit for other
+  dates than the requested ones is still returned in `alternatives`.

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

@@ -0,0 +1,27 @@
+# Migration: 2.21.0 to 2.22.0
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-sdk@2.22.0
+```
+
+No changes are required. The v9 search result type is a superset of the
+previous one, so existing code compiles and renders as before.
+
+## 2. Show the dates of a window-search hit (`v9`)
+
+A v9 site that offers a date window with a night range should show
+`matchingPeriods[0]` on the result card as the dates the price is for, and open
+the rental page with those dates instead of the typed window. Card and detail
+page then show the same price.
+
+```ts
+if (sdk.backend === "v9") {
+  const output = await sdk.live.search.search(input);
+  for (const item of output.items) {
+    const period = item.matchingPeriods?.[0];
+    // period?.start, period?.end: dates for the card and the rental link
+  }
+}
+```

package/dist/{rentals-CIhOx3dS.mjs → rentals-DfNu7s7w.mjs}

@@ -1,4 +1,4 @@
-import { Ut as V9_FACILITY_ATTRIBUTE_KEYS } from "./client-dWCukmLr.mjs";
+import { Ut as V9_FACILITY_ATTRIBUTE_KEYS } from "./client-BtZ30vTP.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-CN-wpRh3.mjs";
 import { CoreSDKError, makeTranslate, renderResolvedCustomAttribute, toCustomAttributeList, toResolvedCustomAttributeCategoryTranslationKey } from "@v-office/sdk-core";

package/dist/{search-D9xq3Z-m.mjs → search-CZ1TRGAB.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-dWCukmLr.mjs";
+import { a as parseQueryParameters, i as collectQueryParameters, n as makeV9CustomAttributeFilterCapabilities, o as toQueryString, r as toBasicQueryInputs, s as applyVofficeFilterDerivedBasicQueryInputs } from "./client-BtZ30vTP.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-CN-wpRh3.mjs";
 import { CoreSDKError, STABLE_SEARCH_INPUTS, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, parseChildrenAges, parseOccupancyCount, resolveExpandedCompositions, toFormattedSearchPrice, toIsoDateFromPeriodQueryDate, toStableSearchInputBackendQueryKeys, toStableSearchInputParameterValues, toStableSearchInputQueryKeys, toUnusedFilterKeys } from "@v-office/sdk-core";
@@ -235,12 +235,18 @@ const toQueryInput = ({ query, sort, customAttributeFilterDefinitions, locale, t
 //#region src/legacy-v9/parser/search/resolve-exact-match.ts
 const resolveExactMatch = (additionalData) => {
 	const alternatives = additionalData?.alternatives ?? [];
-	const calc = additionalData?.calc ?? additionalData?.matchingPeriods?.[0]?.calc;
-	const isExactMatch = additionalData?.foundExactMatch === true || additionalData?.foundExactMatch == null && alternatives.length === 0 && calc != null;
+	const matchingPeriods = additionalData?.matchingPeriods ?? [];
+	const calcCandidates = [
+		matchingPeriods.find((period) => period.fromdate != null && period.tilldate != null)?.calc,
+		additionalData?.calc,
+		matchingPeriods[0]?.calc
+	];
+	const calc = calcCandidates.find((candidate) => candidate?.total != null);
+	const isExactMatch = additionalData?.foundExactMatch === true || additionalData?.foundExactMatch == null && alternatives.length === 0 && calcCandidates.some((candidate) => candidate != null);
 	return {
 		isExactMatch,
 		exactMatchCalc: isExactMatch ? calc : void 0,
-		periods: isExactMatch ? [] : alternatives
+		periods: isExactMatch ? matchingPeriods : alternatives
 	};
 };
 //#endregion
@@ -302,15 +308,15 @@ const toSearchOutputItem = ({ locale, imageProxyBaseUrl, rentalHighlightPrioriti
 	return item;
 });
 //#endregion
-//#region src/legacy-v9/parser/search/output/to-alternative-periods.ts
-const toAlternativePeriods = ({ locale, alternatives }) => Effect.succeed((alternatives ?? []).flatMap((alternative) => {
-	if (alternative.fromdate == null || alternative.tilldate == null) return [];
+//#region src/legacy-v9/parser/search/output/to-search-periods.ts
+const toSearchPeriods = ({ locale, periods }) => Effect.succeed((periods ?? []).flatMap((period) => {
+	if (period.fromdate == null || period.tilldate == null) return [];
 	return [{
-		start: alternative.fromdate,
-		end: alternative.tilldate,
+		start: period.fromdate,
+		end: period.tilldate,
 		...toSearchPriceFields({
 			locale,
-			calc: alternative.calc
+			calc: period.calc
 		})
 	}];
 }));
@@ -318,4 +324,4 @@ const toAlternativePeriods = ({ locale, alternatives }) => Effect.succeed((alter
 //#region src/legacy-v9/runtime/search.ts
 const defaultSearchDataAttributes = Object.keys(VofficeUnitDataFieldSchemas);
 //#endregion
-export { defaultSearchDataAttributes, resolveExactMatch, searchQuery, toAlternativePeriods, toQueryInput, toSearchOutputItem };
+export { defaultSearchDataAttributes, resolveExactMatch, searchQuery, toQueryInput, toSearchOutputItem, toSearchPeriods };

package/instructions/CHANGELOG.md

@@ -4,6 +4,7 @@
 
 Release notes of `@v-office/website-sdk`, newest first. Each version has its own directory.
 
+- `versions/2.22.0/CHANGELOG.md`: release notes for 2.22.0
 - `versions/2.21.0/CHANGELOG.md`: release notes for 2.21.0
 - `versions/2.20.4/CHANGELOG.md`: release notes for 2.20.4
 - `versions/2.20.3/CHANGELOG.md`: release notes for 2.20.3

package/instructions/MIGRATION.md

@@ -4,6 +4,7 @@
 
 Migration guides of `@v-office/website-sdk`, newest first. Apply them in order when skipping versions.
 
+- `versions/2.22.0/MIGRATION.md`: Migration: 2.21.0 to 2.22.0
 - `versions/2.21.0/MIGRATION.md`: Migration: 2.20.4 to 2.21.0
 - `versions/2.20.4/MIGRATION.md`: Migration: 2.20.3 to 2.20.4
 - `versions/2.20.3/MIGRATION.md`: Migration: 2.20.2 to 2.20.3

package/instructions/search.md

@@ -374,6 +374,35 @@ requested locale; backend numeric amounts and modifier type keys are not exposed
 individual modifier lines. Exact-period results are returned in `items`;
 alternative-period suggestions are returned in root-level `alternatives`.
 
+On legacy v9 only, an exact match may include `matchingPeriods` when the backend
+chose the dates itself in a window search (`start`/`end` plus `minNights`/`maxNights`).
+The field exists only on the v9 facade: `sdk.live.search.search` of a
+`WebsiteSDKV9` returns `V9SearchSearchOutput`, whose items are
+`V9SearchSearchOutputItem`. Narrow on `sdk.backend === "v9"` to read it. Each entry has the same shape as an `alternativePeriods` entry: `start`, `end`,
+and the optional `formattedTotal` and `discount` for that period. Entries keep the
+backend order. The item's own `formattedTotal` and `discount` are the price of the
+first entry when that entry has one; otherwise they are the backend's overall price
+for the hit. Show `matchingPeriods[0]` as the dates the card price is for, and open
+the rental page with those dates so card and detail price agree. For a
+fixed-period search without a window, the dates are the requested ones and
+`matchingPeriods` is absent, never an empty array.
+
+```json
+{
+  "id": "214950",
+  "nameOrLabel": "Ferienhaus Seeblick",
+  "timeZone": "Europe/Berlin",
+  "formattedTotal": "1.144,10 €",
+  "matchingPeriods": [
+    {
+      "start": "2026-10-01",
+      "end": "2026-10-08",
+      "formattedTotal": "1.144,10 €"
+    }
+  ]
+}
+```
+
 `appliedFilters` reports what the backend actually applied, and is what a "remove
 this filter" chip should be built from. `label` is localized presentation and can
 repeat, so it cannot identify a filter; `key` plus `value` can. `value` is the
@@ -421,6 +450,10 @@ projection:
   and booking flow.
 - Pagination uses the backend `from`/`size` window behind the same opaque `cursor`,
   capped at 1,000 results.
+- v10 items have no `matchingPeriods`. A v10 hit counts as exact only when its period
+  equals the requested fixed period; a hit the backend priced for other dates,
+  including every hit of a `minNights`/`maxNights` window search, is returned in
+  `alternatives` with its dates in `alternativePeriods`.
 
 ### Legacy v9
 
@@ -442,6 +475,12 @@ shape:
   formatted original total.
 - The same mapping applies to exact-period items and individual alternative
   periods.
+- For an exact match, every `additional_voffice_data.matchingPeriods` entry with
+  both dates becomes a `matchingPeriods` entry (`fromdate`/`tilldate` become
+  `start`/`end`, its `calc` becomes the period's price fields); entries without
+  dates are dropped. In a window search the guest enters a window and a stay
+  length, not the stay itself. The backend returns the bookable stays inside the
+  window, earliest first; the SDK keeps that order.
 - v9 never executes a custom-attribute search filter.
 
 The field is omitted when v9 returns no final total or when its original total is

package/instructions/versions/2.22.0/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog: 2.22.0
+
+On a v9 hub, a search over a date window (`start`/`end` with `minNights`/`maxNights`)
+lets the hub pick the stay itself: the earliest bookable stay in the window. Such a hit came back as an exact result with a price but without the
+dates that price was for. A site could only link the rental page with the
+window the guest typed, and the detail page then showed a different price than
+the card.
+
+## Added
+
+- `v9`: exact search results carry `matchingPeriods` when the hub chose the
+  dates. Each entry has `start`, `end` and the optional `formattedTotal` and
+  `discount` for that period, in the hub's order. The field is absent for a
+  fixed-period search, never an empty array.
+- Types `V9SearchSearchOutput` and `V9SearchSearchOutputItem`.
+  `sdk.live.search.search` of a `WebsiteSDKV9` now returns
+  `V9SearchSearchOutput`; narrow on `sdk.backend === "v9"` to read
+  `matchingPeriods`.
+
+## Changed
+
+- `v9`: the `formattedTotal` and `discount` of an exact result are the price of
+  its first `matchingPeriods` entry when that entry has a price.
+
+## Unchanged
+
+- Fixed-period searches on v9: same items, same prices, no new field.
+- Alternatives and their `alternativePeriods`.
+- The v10 backend. v10 items have no `matchingPeriods`; a v10 hit for other
+  dates than the requested ones is still returned in `alternatives`.

package/instructions/versions/2.22.0/MIGRATION.md

@@ -0,0 +1,27 @@
+# Migration: 2.21.0 to 2.22.0
+
+## 1. Upgrade
+
+```sh
+pnpm add @v-office/website-sdk@2.22.0
+```
+
+No changes are required. The v9 search result type is a superset of the
+previous one, so existing code compiles and renders as before.
+
+## 2. Show the dates of a window-search hit (`v9`)
+
+A v9 site that offers a date window with a night range should show
+`matchingPeriods[0]` on the result card as the dates the price is for, and open
+the rental page with those dates instead of the typed window. Card and detail
+page then show the same price.
+
+```ts
+if (sdk.backend === "v9") {
+  const output = await sdk.live.search.search(input);
+  for (const item of output.items) {
+    const period = item.matchingPeriods?.[0];
+    // period?.start, period?.end: dates for the card and the rental link
+  }
+}
+```

package/instructions/versions/2.22.0/release.json

@@ -0,0 +1,3 @@
+{
+  "componentsAffectedByHeadlessChange": ["searchResults"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-office/website-sdk",
-  "version": "2.21.0",
+  "version": "2.22.0",
   "description": "Website-facing SDK facade backed by @v-office/sdk-core",
   "bin": {
     "website-sdk": "./dist/cli.mjs"