@v-office/website-sdk 2.15.0 → 2.16.0

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as createWebsiteSDK, zt as defineWebsiteSDKOptions } from "./client-C0pqpk-N.mjs";
+import { t as createWebsiteSDK, zt as defineWebsiteSDKOptions } from "./client-CaZZGJAW.mjs";
 import { SearchSearchSortSchema, defineCustomAttributesFromUnknown } from "@v-office/sdk-core";
 import { 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.15.0";
+var version = "2.16.0";
 //#endregion
 //#region src/cli/output.ts
 const toJson = (value) => Effect.try({

package/dist/{client-C0pqpk-N.mjs → client-CaZZGJAW.mjs}

@@ -5202,7 +5202,7 @@ const bookV9Insurance = ({ quote, bookingNumber, guestToken, v1Client }) => Effe
 //#region src/legacy-v9/live/quote.ts
 const loadQuoteRuntime = Effect.tryPromise({
 	try: async () => {
-		return { toGuestQuote: (await import("./quote-Qy_affum.mjs")).toGuestQuote };
+		return { toGuestQuote: (await import("./quote-C-Bs3XTE.mjs")).toGuestQuote };
 	},
 	catch: (cause) => new CoreSDKError({
 		source: "v10",
@@ -5477,7 +5477,7 @@ const parseV9SearchCursor = (cursor) => Effect.gen(function* () {
 	return page;
 });
 const loadV9SearchRuntime = Effect.tryPromise({
-	try: () => import("./search-X9spQmG5.mjs"),
+	try: () => import("./search-Dqiou4mc.mjs"),
 	catch: (cause) => new CoreSDKError({
 		source: "v10",
 		operation: "v9.search.runtime",

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as ServiceBeonDataSchema, A as ErgoBookRequestSchema, At as quoteEffect, B as OnOfficeUnitSchema, C as DocumentResourceSchema, Ct as clearAdditionalServicesEffect, D as DocumentTypeSchema, Dt as getRentalsEffect, E as DocumentSummarySchema, Et as getInitialAvailabilityEffect, F as ErgoPolicyNumberRequestSchema, Ft as selectInsurancePaymentEffect, G as QuotePricesResponseSchema, H as PaymentScheduleSchema, I as ErgoReadPreContractRequestSchema, It as submitContactEffect, J as RawObjectResponseSchema, K as QuoteSchema, L as ErgoTripAndCustomerRequestSchema, Lt as submitPaymentOption, M as ErgoCreatePreContractRequestSchema, Mt as searchEffect, N as ErgoPersonSchema, Nt as selectCancellationPolicyEffect, O as ErgoAddressSchema, Ot as getStartDateSelectedAvailabilityEffect, P as ErgoPlanSearchRequestSchema, Pt as selectInsuranceEffect, Q as SearchPropertiesResponseSchema, R as FacilityListResponseSchema, Rt as submitPaymentOptionEffect, S as DocumentResourceResponseSchema, St as bookInsuranceEffect, T as DocumentStatusUpdateRequestSchema, Tt as getFiltersEffect, U as QuoteLineSchema, V as PaymentScheduleItemSchema, 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 removeAdditionalServiceEffect, k as ErgoBankSchema, kt as getTermsAndPrivacyPolicyEffect, 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 defineWebsiteSDKOptions } from "./client-C0pqpk-N.mjs";
+import { $ as ServiceBeonDataSchema, A as ErgoBookRequestSchema, At as quoteEffect, B as OnOfficeUnitSchema, C as DocumentResourceSchema, Ct as clearAdditionalServicesEffect, D as DocumentTypeSchema, Dt as getRentalsEffect, E as DocumentSummarySchema, Et as getInitialAvailabilityEffect, F as ErgoPolicyNumberRequestSchema, Ft as selectInsurancePaymentEffect, G as QuotePricesResponseSchema, H as PaymentScheduleSchema, I as ErgoReadPreContractRequestSchema, It as submitContactEffect, J as RawObjectResponseSchema, K as QuoteSchema, L as ErgoTripAndCustomerRequestSchema, Lt as submitPaymentOption, M as ErgoCreatePreContractRequestSchema, Mt as searchEffect, N as ErgoPersonSchema, Nt as selectCancellationPolicyEffect, O as ErgoAddressSchema, Ot as getStartDateSelectedAvailabilityEffect, P as ErgoPlanSearchRequestSchema, Pt as selectInsuranceEffect, Q as SearchPropertiesResponseSchema, R as FacilityListResponseSchema, Rt as submitPaymentOptionEffect, S as DocumentResourceResponseSchema, St as bookInsuranceEffect, T as DocumentStatusUpdateRequestSchema, Tt as getFiltersEffect, U as QuoteLineSchema, V as PaymentScheduleItemSchema, 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 removeAdditionalServiceEffect, k as ErgoBankSchema, kt as getTermsAndPrivacyPolicyEffect, 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 defineWebsiteSDKOptions } from "./client-CaZZGJAW.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 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.16.0/CHANGELOG.md`: `@v-office/website-sdk` 2.16.0 release notes.
 - `versions/2.15.0/CHANGELOG.md`: `@v-office/website-sdk` 2.15.0 release notes.
 - `versions/2.14.0/CHANGELOG.md`: `@v-office/website-sdk` 2.14.0 release notes.
 - `versions/2.13.0/CHANGELOG.md`: `@v-office/website-sdk` 2.13.0 release notes.

package/dist/instructions/MIGRATION.md

@@ -4,6 +4,7 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
+- `versions/2.16.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.15.0 to 2.16.0.
 - `versions/2.15.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.14.0 to 2.15.0.
 - `versions/2.14.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.13.0 to 2.14.0.
 - `versions/2.13.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.12.0 to 2.13.0.

package/dist/instructions/README.md

@@ -1,7 +1,7 @@
 # Website SDK Instructions
 
 These instructions describe the current source targeted for
-`@v-office/website-sdk` 2.15.0. Package versions remain unchanged until the release
+`@v-office/website-sdk` 2.16.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,9 @@ 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.16.0/`: 2.16.0 machine-readable unavailable quote codes,
+  multi-rate configuration diagnostics, and the 2.15.0-to-2.16.0 migration
+  guide.
 - `versions/2.15.0/`: 2.15.0 v9 facility images in normalized
   `property.images`, responsive vOffice image URLs, and the 2.14.0-to-2.15.0
   migration guide.
@@ -93,5 +96,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.15.0. v10 config additionally requires `searchEndpoint` as
+in 2.0.0 and kept in 2.16.0. v10 config additionally requires `searchEndpoint` as
 of 2.5.0.

package/dist/instructions/quote.md

@@ -133,10 +133,40 @@ Unavailable sample:
 ```json
 {
   "status": "unavailable",
+  "code": "NotBookable",
   "reason": "Rental is not available for the selected period."
 }
 ```
 
+From 2.16.0, every unavailable quote includes a machine-readable `code`:
+
+- `NotBookable`: the backend did not return a bookable price, including normal
+  availability failures. Legacy v9 unavailable quotes always use this code.
+- `AmbiguousMultiRate`: v10 priced the stay, but more than one multi-rate
+  matched the default cancellation policy.
+- `UnresolvableMultiRate`: v10 priced the stay, but no multi-rate could be
+  resolved for the default cancellation policy.
+
+Use `code` for application behavior and logging. `reason` remains localized
+display text and can be identical for inventory and multi-rate failures. The SDK
+keeps ambiguous and unresolvable v10 quotes unavailable because booking requires
+one exact multi-rate.
+
+```ts
+const result = await sdk.live.quote.quote(input);
+
+if (result.status === "unavailable") {
+  if (result.code === "AmbiguousMultiRate" || result.code === "UnresolvableMultiRate") {
+    reportQuoteConfigurationProblem(result.code);
+  }
+
+  showUnavailableMessage(result.reason);
+}
+```
+
+See `versions/2.16.0/CHANGELOG.md` and
+`versions/2.16.0/MIGRATION.md` for release and upgrade details.
+
 Selection methods return `{ ok: true, quote }` or `{ ok: false, error }`. Possible selection errors include unknown additional service, additional service limit exceeded, unknown cancellation policy, unavailable cancellation policy quote, and unavailable quote combination.
 
 ## Booking-Card Breakdown

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

@@ -0,0 +1,44 @@
+# Changelog: 2.16.0
+
+This release makes unavailable quote results machine-readable. Applications can
+now distinguish normal booking unavailability from v10 multi-rate
+configuration failures without parsing localized text.
+
+## Added
+
+- Every unavailable `GuestQuoteResult` contains a `code`:
+  - `NotBookable`
+  - `AmbiguousMultiRate`
+  - `UnresolvableMultiRate`
+- The public quote output schema validates the new code.
+- v10 reports `AmbiguousMultiRate` when a priced default cancellation policy
+  matches more than one multi-rate.
+- v10 reports `UnresolvableMultiRate` when a priced default cancellation policy
+  cannot be mapped to a multi-rate.
+
+## Changed
+
+- Legacy v9 unavailable quotes now include `code: "NotBookable"`.
+- Normal v10 quote failures also use `code: "NotBookable"`.
+- v10 retains the exact default-policy multi-rate resolution result instead of
+  reducing it to a boolean before creating the public unavailable result.
+
+## Unchanged
+
+- `sdk.live.quote.quote(input)` and its input are unchanged.
+- Available quote results remain `{ status: "available", quote }`.
+- Unavailable results retain the localized `reason` field.
+- Ambiguous or unresolvable v10 multi-rates remain unavailable. The SDK does not
+  select an arbitrary fallback because booking requires one exact multi-rate.
+- Search and calendar availability behavior are unchanged.
+
+## Compatibility
+
+- Consumers that only inspect `status` and display `reason` continue to work.
+- TypeScript mocks, complete-object assertions, snapshots, and schema fixtures
+  for unavailable quotes must include `code`.
+- Application behavior should branch on `code`, not localized `reason`.
+- `AmbiguousMultiRate` and `UnresolvableMultiRate` indicate configuration or
+  mapping problems and should normally be reported to site operations.
+
+See `versions/2.16.0/MIGRATION.md` and `../../quote.md`.

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

@@ -0,0 +1,109 @@
+# Migration: 2.15.0 to 2.16.0
+
+2.16.0 adds a required machine-readable `code` to unavailable quote results.
+The service call, quote input, available result, and localized unavailable
+`reason` are unchanged.
+
+## 1. Handle the Unavailable Code
+
+An unavailable result now has this shape:
+
+```ts
+type UnavailableGuestQuoteResult = {
+  readonly status: "unavailable";
+  readonly code: "NotBookable" | "AmbiguousMultiRate" | "UnresolvableMultiRate";
+  readonly reason: string;
+};
+```
+
+Branch on `code` after narrowing by `status`:
+
+```ts
+const result = await sdk.live.quote.quote(input);
+
+if (result.status === "unavailable") {
+  switch (result.code) {
+    case "AmbiguousMultiRate":
+    case "UnresolvableMultiRate":
+      reportQuoteConfigurationProblem(result.code);
+      break;
+    case "NotBookable":
+      break;
+  }
+
+  showUnavailableMessage(result.reason);
+}
+```
+
+Keep displaying `reason` when appropriate, but do not parse or compare it to
+select application behavior. It is localized and can still contain the same
+text for different codes.
+
+## 2. Treat Multi-Rate Codes as Operational Failures
+
+The v10-specific codes mean:
+
+- `AmbiguousMultiRate`: the stay was priced, but more than one multi-rate
+  matched the default cancellation policy.
+- `UnresolvableMultiRate`: the stay was priced, but no multi-rate could be
+  resolved for the default cancellation policy.
+
+These are not proof that another guest booked the period. Keep the public quote
+unavailable, show suitable fallback copy, and send the code to monitoring or
+site operations so the rental configuration can be corrected.
+
+Do not retry booking with an arbitrary multi-rate. The price alone does not
+identify the exact multi-rate required by the booking request.
+
+## 3. Keep Normal Unavailability Handling
+
+`NotBookable` represents ordinary unavailable quote results, including backend
+responses without a bookable price:
+
+```ts
+if (result.status === "unavailable" && result.code === "NotBookable") {
+  showUnavailableMessage(result.reason);
+}
+```
+
+Legacy v9 unavailable quotes always use `NotBookable`. No v9 configuration or
+request change is required.
+
+## 4. Update Mocks, Fixtures, and Snapshots
+
+Add `code` anywhere an unavailable result is constructed or compared:
+
+```ts
+const unavailableQuote = {
+  status: "unavailable",
+  code: "NotBookable",
+  reason: "Not available",
+} as const;
+```
+
+Update:
+
+1. TypeScript mocks typed as `GuestQuoteResult` or `QuoteQuoteOutput`.
+2. JSON fixtures decoded with `QuoteQuoteOutputSchema`.
+3. Complete-object assertions and snapshots.
+4. API adapters that persist or forward quote results.
+
+Available-result fixtures require no changes.
+
+## Required Consumer Work
+
+1. Add `code` to unavailable quote mocks and fixtures.
+2. Replace reason-string comparisons with code checks.
+3. Route `AmbiguousMultiRate` and `UnresolvableMultiRate` to operational
+   diagnostics.
+4. Keep all three codes unavailable in booking UI.
+
+## Recommended Verification
+
+1. Confirm a normal blocked period returns `NotBookable`.
+2. Confirm unavailable copy still uses the localized `reason`.
+3. Confirm monitoring distinguishes both multi-rate codes from
+   `NotBookable`.
+4. Confirm the UI never enables booking for either multi-rate code.
+5. Confirm available quote, option selection, and booking flows are unchanged.
+6. Confirm legacy v9 unavailable quote snapshots include `NotBookable`.

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

@@ -286,6 +286,7 @@ const toGuestQuote = (input, guestQuoteResult, locale, translations, options) =>
 	const errorReason = toErrorReason(guestQuoteResult);
 	if (errorReason !== void 0) return {
 		status: "unavailable",
+		code: "NotBookable",
 		reason: errorReason
 	};
 	const sections = yield* toSections({

package/dist/{search-X9spQmG5.mjs → search-Dqiou4mc.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-C0pqpk-N.mjs";
+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 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/instructions/CHANGELOG.md

@@ -4,6 +4,7 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.16.0/CHANGELOG.md`: `@v-office/website-sdk` 2.16.0 release notes.
 - `versions/2.15.0/CHANGELOG.md`: `@v-office/website-sdk` 2.15.0 release notes.
 - `versions/2.14.0/CHANGELOG.md`: `@v-office/website-sdk` 2.14.0 release notes.
 - `versions/2.13.0/CHANGELOG.md`: `@v-office/website-sdk` 2.13.0 release notes.

package/instructions/MIGRATION.md

@@ -4,6 +4,7 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
+- `versions/2.16.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.15.0 to 2.16.0.
 - `versions/2.15.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.14.0 to 2.15.0.
 - `versions/2.14.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.13.0 to 2.14.0.
 - `versions/2.13.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.12.0 to 2.13.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.15.0. Package versions remain unchanged until the release
+`@v-office/website-sdk` 2.16.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,9 @@ 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.16.0/`: 2.16.0 machine-readable unavailable quote codes,
+  multi-rate configuration diagnostics, and the 2.15.0-to-2.16.0 migration
+  guide.
 - `versions/2.15.0/`: 2.15.0 v9 facility images in normalized
   `property.images`, responsive vOffice image URLs, and the 2.14.0-to-2.15.0
   migration guide.
@@ -93,5 +96,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.15.0. v10 config additionally requires `searchEndpoint` as
+in 2.0.0 and kept in 2.16.0. v10 config additionally requires `searchEndpoint` as
 of 2.5.0.

package/instructions/quote.md

@@ -133,10 +133,40 @@ Unavailable sample:
 ```json
 {
   "status": "unavailable",
+  "code": "NotBookable",
   "reason": "Rental is not available for the selected period."
 }
 ```
 
+From 2.16.0, every unavailable quote includes a machine-readable `code`:
+
+- `NotBookable`: the backend did not return a bookable price, including normal
+  availability failures. Legacy v9 unavailable quotes always use this code.
+- `AmbiguousMultiRate`: v10 priced the stay, but more than one multi-rate
+  matched the default cancellation policy.
+- `UnresolvableMultiRate`: v10 priced the stay, but no multi-rate could be
+  resolved for the default cancellation policy.
+
+Use `code` for application behavior and logging. `reason` remains localized
+display text and can be identical for inventory and multi-rate failures. The SDK
+keeps ambiguous and unresolvable v10 quotes unavailable because booking requires
+one exact multi-rate.
+
+```ts
+const result = await sdk.live.quote.quote(input);
+
+if (result.status === "unavailable") {
+  if (result.code === "AmbiguousMultiRate" || result.code === "UnresolvableMultiRate") {
+    reportQuoteConfigurationProblem(result.code);
+  }
+
+  showUnavailableMessage(result.reason);
+}
+```
+
+See `versions/2.16.0/CHANGELOG.md` and
+`versions/2.16.0/MIGRATION.md` for release and upgrade details.
+
 Selection methods return `{ ok: true, quote }` or `{ ok: false, error }`. Possible selection errors include unknown additional service, additional service limit exceeded, unknown cancellation policy, unavailable cancellation policy quote, and unavailable quote combination.
 
 ## Booking-Card Breakdown

package/instructions/versions/2.16.0/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog: 2.16.0
+
+This release makes unavailable quote results machine-readable. Applications can
+now distinguish normal booking unavailability from v10 multi-rate
+configuration failures without parsing localized text.
+
+## Added
+
+- Every unavailable `GuestQuoteResult` contains a `code`:
+  - `NotBookable`
+  - `AmbiguousMultiRate`
+  - `UnresolvableMultiRate`
+- The public quote output schema validates the new code.
+- v10 reports `AmbiguousMultiRate` when a priced default cancellation policy
+  matches more than one multi-rate.
+- v10 reports `UnresolvableMultiRate` when a priced default cancellation policy
+  cannot be mapped to a multi-rate.
+
+## Changed
+
+- Legacy v9 unavailable quotes now include `code: "NotBookable"`.
+- Normal v10 quote failures also use `code: "NotBookable"`.
+- v10 retains the exact default-policy multi-rate resolution result instead of
+  reducing it to a boolean before creating the public unavailable result.
+
+## Unchanged
+
+- `sdk.live.quote.quote(input)` and its input are unchanged.
+- Available quote results remain `{ status: "available", quote }`.
+- Unavailable results retain the localized `reason` field.
+- Ambiguous or unresolvable v10 multi-rates remain unavailable. The SDK does not
+  select an arbitrary fallback because booking requires one exact multi-rate.
+- Search and calendar availability behavior are unchanged.
+
+## Compatibility
+
+- Consumers that only inspect `status` and display `reason` continue to work.
+- TypeScript mocks, complete-object assertions, snapshots, and schema fixtures
+  for unavailable quotes must include `code`.
+- Application behavior should branch on `code`, not localized `reason`.
+- `AmbiguousMultiRate` and `UnresolvableMultiRate` indicate configuration or
+  mapping problems and should normally be reported to site operations.
+
+See `versions/2.16.0/MIGRATION.md` and `../../quote.md`.

package/instructions/versions/2.16.0/MIGRATION.md

@@ -0,0 +1,109 @@
+# Migration: 2.15.0 to 2.16.0
+
+2.16.0 adds a required machine-readable `code` to unavailable quote results.
+The service call, quote input, available result, and localized unavailable
+`reason` are unchanged.
+
+## 1. Handle the Unavailable Code
+
+An unavailable result now has this shape:
+
+```ts
+type UnavailableGuestQuoteResult = {
+  readonly status: "unavailable";
+  readonly code: "NotBookable" | "AmbiguousMultiRate" | "UnresolvableMultiRate";
+  readonly reason: string;
+};
+```
+
+Branch on `code` after narrowing by `status`:
+
+```ts
+const result = await sdk.live.quote.quote(input);
+
+if (result.status === "unavailable") {
+  switch (result.code) {
+    case "AmbiguousMultiRate":
+    case "UnresolvableMultiRate":
+      reportQuoteConfigurationProblem(result.code);
+      break;
+    case "NotBookable":
+      break;
+  }
+
+  showUnavailableMessage(result.reason);
+}
+```
+
+Keep displaying `reason` when appropriate, but do not parse or compare it to
+select application behavior. It is localized and can still contain the same
+text for different codes.
+
+## 2. Treat Multi-Rate Codes as Operational Failures
+
+The v10-specific codes mean:
+
+- `AmbiguousMultiRate`: the stay was priced, but more than one multi-rate
+  matched the default cancellation policy.
+- `UnresolvableMultiRate`: the stay was priced, but no multi-rate could be
+  resolved for the default cancellation policy.
+
+These are not proof that another guest booked the period. Keep the public quote
+unavailable, show suitable fallback copy, and send the code to monitoring or
+site operations so the rental configuration can be corrected.
+
+Do not retry booking with an arbitrary multi-rate. The price alone does not
+identify the exact multi-rate required by the booking request.
+
+## 3. Keep Normal Unavailability Handling
+
+`NotBookable` represents ordinary unavailable quote results, including backend
+responses without a bookable price:
+
+```ts
+if (result.status === "unavailable" && result.code === "NotBookable") {
+  showUnavailableMessage(result.reason);
+}
+```
+
+Legacy v9 unavailable quotes always use `NotBookable`. No v9 configuration or
+request change is required.
+
+## 4. Update Mocks, Fixtures, and Snapshots
+
+Add `code` anywhere an unavailable result is constructed or compared:
+
+```ts
+const unavailableQuote = {
+  status: "unavailable",
+  code: "NotBookable",
+  reason: "Not available",
+} as const;
+```
+
+Update:
+
+1. TypeScript mocks typed as `GuestQuoteResult` or `QuoteQuoteOutput`.
+2. JSON fixtures decoded with `QuoteQuoteOutputSchema`.
+3. Complete-object assertions and snapshots.
+4. API adapters that persist or forward quote results.
+
+Available-result fixtures require no changes.
+
+## Required Consumer Work
+
+1. Add `code` to unavailable quote mocks and fixtures.
+2. Replace reason-string comparisons with code checks.
+3. Route `AmbiguousMultiRate` and `UnresolvableMultiRate` to operational
+   diagnostics.
+4. Keep all three codes unavailable in booking UI.
+
+## Recommended Verification
+
+1. Confirm a normal blocked period returns `NotBookable`.
+2. Confirm unavailable copy still uses the localized `reason`.
+3. Confirm monitoring distinguishes both multi-rate codes from
+   `NotBookable`.
+4. Confirm the UI never enables booking for either multi-rate code.
+5. Confirm available quote, option selection, and booking flows are unchanged.
+6. Confirm legacy v9 unavailable quote snapshots include `NotBookable`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-office/website-sdk",
-  "version": "2.15.0",
+  "version": "2.16.0",
   "description": "Website-facing SDK facade backed by @v-office/sdk-core",
   "bin": {
     "website-sdk": "./dist/cli.mjs"
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "@graphql-typed-document-node/core": "3.2.0",
-    "@v-office/sdk-core": "^1.15.0",
+    "@v-office/sdk-core": "^1.16.0",
     "effect": "4.0.0-beta.85",
     "graphql": "17.0.2",
     "yaml": "^2.9.0"