@v-office/website-sdk 2.0.0 → 2.1.0

package/dist/{rentals-Quwc78o2.mjs → rentals-DCKUaLnB.mjs}

@@ -1,4 +1,4 @@
-import { c as VofficeUnitDataFieldSchemas, d as VofficeUnitDataPropertyMetadata, f as parseVofficeFacilityData, i as toLocalizedString, l as VofficeUnitDataPropertyCategoryLabelKeys, m as parseVofficeUnitData, n as toImages, o as rentalsAllFeedbacksQuery, p as parseVofficeFeedbackData, r as toAddress, s as rentalsAllWithoutFeedbacksQuery, t as toRentalHighlights, u as VofficeUnitDataPropertyCategoryValues } from "./to-rental-highlights-FNZBR4aD.mjs";
+import { c as VofficeUnitDataFieldSchemas, d as VofficeUnitDataPropertyMetadata, f as parseVofficeFacilityData, i as toLocalizedString, l as VofficeUnitDataPropertyCategoryLabelKeys, m as parseVofficeUnitData, n as toImages, o as rentalsAllFeedbacksQuery, p as parseVofficeFeedbackData, r as toAddress, s as rentalsAllWithoutFeedbacksQuery, t as toRentalHighlights, u as VofficeUnitDataPropertyCategoryValues } from "./to-rental-highlights-CZYJeR1D.mjs";
 import { makeTranslate, renderCustomAttributeHighlight, renderLabeledAttributeValue } from "@v-office/sdk-core";
 import { Effect } from "effect";
 //#region src/legacy-v9/parser/rentals/to-description.ts

package/dist/{search-GRQeXDvo.mjs → search-8iCC0Nel.mjs}

@@ -1,5 +1,5 @@
-import { n as stable_filters_default } from "./client-BSUd3vuc.mjs";
-import { a as searchQuery, c as VofficeUnitDataFieldSchemas, m as parseVofficeUnitData, n as toImages, r as toAddress, t as toRentalHighlights } from "./to-rental-highlights-FNZBR4aD.mjs";
+import { n as stable_filters_default } from "./client-xkXV7Nf-.mjs";
+import { a as searchQuery, c as VofficeUnitDataFieldSchemas, m as parseVofficeUnitData, n as toImages, r as toAddress, t as toRentalHighlights } from "./to-rental-highlights-CZYJeR1D.mjs";
 import { CoreSDKError, STABLE_SEARCH_INPUTS, collectQueryParameters, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, parseChildrenAges, parseOccupancyCount, parseQueryParameters, toCustomAttributeFilterLabel, toFormattedSearchPrice, toIsoDateFromPeriodQueryDate, toQueryString, toStableSearchInputBackendQueryKeys, toStableSearchInputParameterValues, toStableSearchInputQueryKeys, toUnusedFilterKeys } from "@v-office/sdk-core";
 import { Effect } from "effect";
 //#region src/legacy-v9/parser/search/input/filter/apply-voffice-filter-derived-basic-query-inputs.ts

package/dist/{to-rental-highlights-FNZBR4aD.mjs → to-rental-highlights-CZYJeR1D.mjs}

@@ -3568,14 +3568,14 @@ Schema.Number, Schema.Number, Schema.Number, Schema.Number;
 //#endregion
 //#region codegen/v9/graphql-codegen/generated/gql.ts
 const documents = {
-	"\n  query CMSSDK_RentalsAllWithoutFeedbacks(\n    $language: String\n    $voffice_ids: [Int!]\n    $rentalDataAttributes: [String!]! = []\n    $rentalFacilityDataAttributes: [String!]! = []\n    $rentalRatingDataAttributes: [String!]! = []\n  ) {\n    all(language: $language, voffice_ids: $voffice_ids) {\n      id\n      voffice_id\n      voffice_facility_id\n      name\n      publish\n      data(attributes: $rentalDataAttributes)\n      additional_voffice_data {\n        beds\n      }\n      voffice_facility {\n        id\n        voffice_id\n        name\n        publish\n        data(attributes: $rentalFacilityDataAttributes)\n      }\n      voffice_images {\n        id\n        path\n        title\n        description\n      }\n      voffice_room_images {\n        id\n        path\n        name\n        title\n        description\n      }\n      voffice_rating {\n        id\n        data(attributes: $rentalRatingDataAttributes)\n      }\n    }\n  }\n": {
+	"\n  query CoreSDK_RentalsAllWithoutFeedbacks(\n    $language: String\n    $voffice_ids: [Int!]\n    $rentalDataAttributes: [String!]! = []\n    $rentalFacilityDataAttributes: [String!]! = []\n    $rentalRatingDataAttributes: [String!]! = []\n  ) {\n    all(language: $language, voffice_ids: $voffice_ids) {\n      id\n      voffice_id\n      voffice_facility_id\n      name\n      publish\n      data(attributes: $rentalDataAttributes)\n      additional_voffice_data {\n        beds\n      }\n      voffice_facility {\n        id\n        voffice_id\n        name\n        publish\n        data(attributes: $rentalFacilityDataAttributes)\n      }\n      voffice_images {\n        id\n        path\n        title\n        description\n      }\n      voffice_room_images {\n        id\n        path\n        name\n        title\n        description\n      }\n      voffice_rating {\n        id\n        data(attributes: $rentalRatingDataAttributes)\n      }\n    }\n  }\n": {
 		kind: "Document",
 		definitions: [{
 			kind: "OperationDefinition",
 			operation: "query",
 			name: {
 				kind: "Name",
-				value: "CMSSDK_RentalsAllWithoutFeedbacks"
+				value: "CoreSDK_RentalsAllWithoutFeedbacks"
 			},
 			variableDefinitions: [
 				{
@@ -4011,14 +4011,14 @@ const documents = {
 			}
 		}]
 	},
-	"\n  query CMSSDK_RentalsAllFeedbacks(\n    $language: String\n    $voffice_ids: [Int!]\n    $rentalFeedbackDataAttributes: [String!]! = []\n  ) {\n    all(language: $language, voffice_ids: $voffice_ids) {\n      voffice_id\n      voffice_feedbacks {\n        data(attributes: $rentalFeedbackDataAttributes)\n      }\n    }\n  }\n": {
+	"\n  query CoreSDK_RentalsAllFeedbacks(\n    $language: String\n    $voffice_ids: [Int!]\n    $rentalFeedbackDataAttributes: [String!]! = []\n  ) {\n    all(language: $language, voffice_ids: $voffice_ids) {\n      voffice_id\n      voffice_feedbacks {\n        data(attributes: $rentalFeedbackDataAttributes)\n      }\n    }\n  }\n": {
 		kind: "Document",
 		definitions: [{
 			kind: "OperationDefinition",
 			operation: "query",
 			name: {
 				kind: "Name",
-				value: "CMSSDK_RentalsAllFeedbacks"
+				value: "CoreSDK_RentalsAllFeedbacks"
 			},
 			variableDefinitions: [
 				{
@@ -4171,14 +4171,14 @@ const documents = {
 			}
 		}]
 	},
-	"\n  query CMSSDK_RentalsAll(\n    $language: String\n    $voffice_ids: [Int!]\n    $rentalDataAttributes: [String!]! = []\n    $rentalFacilityDataAttributes: [String!]! = []\n    $rentalRatingDataAttributes: [String!]! = []\n    $rentalFeedbackDataAttributes: [String!]! = []\n  ) {\n    all(language: $language, voffice_ids: $voffice_ids) {\n      id\n      voffice_id\n      voffice_facility_id\n      name\n      publish\n      data(attributes: $rentalDataAttributes)\n      additional_voffice_data {\n        beds\n      }\n      voffice_facility {\n        id\n        voffice_id\n        name\n        publish\n        data(attributes: $rentalFacilityDataAttributes)\n      }\n      voffice_images {\n        id\n        path\n        title\n        description\n      }\n      voffice_room_images {\n        id\n        path\n        name\n        title\n        description\n      }\n      voffice_rating {\n        id\n        data(attributes: $rentalRatingDataAttributes)\n      }\n      voffice_feedbacks {\n        data(attributes: $rentalFeedbackDataAttributes)\n      }\n    }\n  }\n": {
+	"\n  query CoreSDK_RentalsAll(\n    $language: String\n    $voffice_ids: [Int!]\n    $rentalDataAttributes: [String!]! = []\n    $rentalFacilityDataAttributes: [String!]! = []\n    $rentalRatingDataAttributes: [String!]! = []\n    $rentalFeedbackDataAttributes: [String!]! = []\n  ) {\n    all(language: $language, voffice_ids: $voffice_ids) {\n      id\n      voffice_id\n      voffice_facility_id\n      name\n      publish\n      data(attributes: $rentalDataAttributes)\n      additional_voffice_data {\n        beds\n      }\n      voffice_facility {\n        id\n        voffice_id\n        name\n        publish\n        data(attributes: $rentalFacilityDataAttributes)\n      }\n      voffice_images {\n        id\n        path\n        title\n        description\n      }\n      voffice_room_images {\n        id\n        path\n        name\n        title\n        description\n      }\n      voffice_rating {\n        id\n        data(attributes: $rentalRatingDataAttributes)\n      }\n      voffice_feedbacks {\n        data(attributes: $rentalFeedbackDataAttributes)\n      }\n    }\n  }\n": {
 		kind: "Document",
 		definitions: [{
 			kind: "OperationDefinition",
 			operation: "query",
 			name: {
 				kind: "Name",
-				value: "CMSSDK_RentalsAll"
+				value: "CoreSDK_RentalsAll"
 			},
 			variableDefinitions: [
 				{
@@ -4675,14 +4675,14 @@ const documents = {
 			}
 		}]
 	},
-	"\n  query CMSSDK_Search(\n    $first: Int!\n    $page: Int\n    $language: String\n    $vofficeData: VofficeData\n    $basicQueryInputs: [BasicQueryInput!]\n    $dataAttributes: [String!]! = []\n  ) {\n    search(\n      first: $first\n      page: $page\n      language: $language\n      voffice: $vofficeData\n      data: $basicQueryInputs\n    ) {\n      paginatorInfo {\n        hasMorePages\n        currentPage\n      }\n      data {\n        voffice_id\n        voffice_images {\n          id\n          path\n          title\n          description\n        }\n        voffice_room_images {\n          id\n          path\n          name\n          title\n          description\n        }\n        additional_voffice_data {\n          alternatives {\n            fromdate\n            tilldate\n            calc {\n              total\n              rent\n              summary\n              oTotal\n              oRent\n              oSummary\n              discountName\n            }\n          }\n          calc {\n            total\n            rent\n            summary\n            oTotal\n            oRent\n            oSummary\n            discountName\n          }\n        }\n        data(attributes: $dataAttributes)\n      }\n    }\n  }\n": {
+	"\n  query CoreSDK_Search(\n    $first: Int!\n    $page: Int\n    $language: String\n    $vofficeData: VofficeData\n    $basicQueryInputs: [BasicQueryInput!]\n    $dataAttributes: [String!]! = []\n  ) {\n    search(\n      first: $first\n      page: $page\n      language: $language\n      voffice: $vofficeData\n      data: $basicQueryInputs\n    ) {\n      paginatorInfo {\n        hasMorePages\n        currentPage\n      }\n      data {\n        voffice_id\n        voffice_images {\n          id\n          path\n          title\n          description\n        }\n        voffice_room_images {\n          id\n          path\n          name\n          title\n          description\n        }\n        additional_voffice_data {\n          alternatives {\n            fromdate\n            tilldate\n            calc {\n              total\n              rent\n              summary\n              oTotal\n              oRent\n              oSummary\n              discountName\n            }\n          }\n          calc {\n            total\n            rent\n            summary\n            oTotal\n            oRent\n            oSummary\n            discountName\n          }\n        }\n        data(attributes: $dataAttributes)\n      }\n    }\n  }\n": {
 		kind: "Document",
 		definitions: [{
 			kind: "OperationDefinition",
 			operation: "query",
 			name: {
 				kind: "Name",
-				value: "CMSSDK_Search"
+				value: "CoreSDK_Search"
 			},
 			variableDefinitions: [
 				{
@@ -5210,7 +5210,7 @@ function graphql(source) {
 //#endregion
 //#region codegen/v9/graphql-codegen/operations/rentals.ts
 const rentalsAllWithoutFeedbacksQuery = graphql(`
-  query CMSSDK_RentalsAllWithoutFeedbacks(
+  query CoreSDK_RentalsAllWithoutFeedbacks(
     $language: String
     $voffice_ids: [Int!]
     $rentalDataAttributes: [String!]! = []
@@ -5255,7 +5255,7 @@ const rentalsAllWithoutFeedbacksQuery = graphql(`
   }
 `);
 const rentalsAllFeedbacksQuery = graphql(`
-  query CMSSDK_RentalsAllFeedbacks(
+  query CoreSDK_RentalsAllFeedbacks(
     $language: String
     $voffice_ids: [Int!]
     $rentalFeedbackDataAttributes: [String!]! = []
@@ -5269,7 +5269,7 @@ const rentalsAllFeedbacksQuery = graphql(`
   }
 `);
 graphql(`
-  query CMSSDK_RentalsAll(
+  query CoreSDK_RentalsAll(
     $language: String
     $voffice_ids: [Int!]
     $rentalDataAttributes: [String!]! = []
@@ -5320,7 +5320,7 @@ graphql(`
 //#endregion
 //#region codegen/v9/graphql-codegen/operations/search.ts
 const searchQuery = graphql(`
-  query CMSSDK_Search(
+  query CoreSDK_Search(
     $first: Int!
     $page: Int
     $language: String

package/dist/translations/shared/de-DE/contact.json

@@ -0,0 +1,19 @@
+{
+  "contact.submit.field.title": "Anrede",
+  "contact.submit.field.professionalTitle": "Titel",
+  "contact.submit.field.forename": "Vorname",
+  "contact.submit.field.surname": "Nachname",
+  "contact.submit.field.address.streetAndHousenumber": "Straße und Hausnummer",
+  "contact.submit.field.address.postalCode": "Postleitzahl",
+  "contact.submit.field.address.city": "Ort",
+  "contact.submit.field.address.countryCode": "Land",
+  "contact.submit.field.email": "E-Mail",
+  "contact.submit.field.phone": "Telefon",
+  "contact.submit.field.subject": "Betreff",
+  "contact.submit.field.message": "Nachricht",
+  "contact.submit.validation.summary": "Bitte prüfen Sie Ihre Kontaktanfrage.",
+  "contact.submit.validation.required": "{field} ist erforderlich.",
+  "contact.submit.validation.invalid_email": "Bitte geben Sie eine gültige E-Mail-Adresse ein.",
+  "contact.submit.validation.invalid_country_code": "Bitte geben Sie ein gültiges Land an.",
+  "contact.submit.validation.tooLong": "{field} darf höchstens {maxLength} Zeichen lang sein."
+}

package/dist/translations/shared/de-DE/quote.json

@@ -4,5 +4,9 @@
   "quote.sections.tax": "Steuern & Abgaben",
   "quote.additionalService.day": " / Tag",
   "quote.additionalService.night": " / Nacht",
-  "quote.status.unavailable.notBookable": "Nicht verfügbar"
+  "quote.status.unavailable.notBookable": "Nicht verfügbar",
+  "quote.optionCombination.unavailable": "Diese Optionskombination ist nicht verfügbar.",
+  "quote.voucher.applied": "Der Rabattcode wurde angewendet.",
+  "quote.voucher.notApplied": "Der Rabattcode konnte nicht angewendet werden.",
+  "quote.voucher.unknown": "Das Backend hat nicht bestätigt, ob der Rabattcode angewendet wurde."
 }

package/dist/translations/shared/en-US/contact.json

@@ -0,0 +1,19 @@
+{
+  "contact.submit.field.title": "Title",
+  "contact.submit.field.professionalTitle": "Professional title",
+  "contact.submit.field.forename": "First name",
+  "contact.submit.field.surname": "Last name",
+  "contact.submit.field.address.streetAndHousenumber": "Street and house number",
+  "contact.submit.field.address.postalCode": "Postal code",
+  "contact.submit.field.address.city": "City",
+  "contact.submit.field.address.countryCode": "Country",
+  "contact.submit.field.email": "Email",
+  "contact.submit.field.phone": "Phone",
+  "contact.submit.field.subject": "Subject",
+  "contact.submit.field.message": "Message",
+  "contact.submit.validation.summary": "Please check your contact request.",
+  "contact.submit.validation.required": "{field} is required.",
+  "contact.submit.validation.invalid_email": "Please enter a valid email address.",
+  "contact.submit.validation.invalid_country_code": "Please enter a valid country.",
+  "contact.submit.validation.tooLong": "{field} must be at most {maxLength} characters long."
+}

package/dist/translations/shared/en-US/quote.json

@@ -4,5 +4,9 @@
   "quote.sections.tax": "Taxes & Fees",
   "quote.additionalService.day": " / day",
   "quote.additionalService.night": " / night",
-  "quote.status.unavailable.notBookable": "Not available"
+  "quote.status.unavailable.notBookable": "Not available",
+  "quote.optionCombination.unavailable": "This option combination is unavailable.",
+  "quote.voucher.applied": "The voucher code was applied.",
+  "quote.voucher.notApplied": "The voucher code could not be applied.",
+  "quote.voucher.unknown": "The backend did not confirm whether the voucher code was applied."
 }

package/dist/translations/v10/de-DE/mapped-search-filters.json

@@ -0,0 +1,3 @@
+{
+  "MappedSearchFilters.pets.label": "Hunde willkommen"
+}

package/dist/translations/v10/en-US/mapped-search-filters.json

@@ -0,0 +1,3 @@
+{
+  "MappedSearchFilters.pets.label": "Dogs welcome"
+}

package/instructions/CHANGELOG.md

@@ -4,6 +4,7 @@ This file is the versioned changelog index for the website SDK instructions.
 
 ## Versions
 
+- `versions/2.1.0/CHANGELOG.md`: `@v-office/website-sdk` 2.1.0 release notes.
 - `versions/2.0.0/CHANGELOG.md`: `@v-office/website-sdk` 2.0.0 release notes.
 
 Keep each future release in its own version directory so consumers can see which package version introduced each change.

package/instructions/MIGRATION.md

@@ -4,6 +4,7 @@ This file is the versioned migration index for the website SDK instructions.
 
 ## Available Guides
 
+- `versions/2.1.0/MIGRATION.md`: migrate from `@v-office/website-sdk` 2.0.0 to 2.1.0.
 - `versions/2.0.0/MIGRATION.md`: migrate from the legacy 1.x CMS-style website SDK API to `@v-office/website-sdk` 2.0.0.
 
 Keep each future migration in its own version directory so consumers can clearly see the source and target versions for every upgrade path.

package/instructions/README.md

@@ -1,6 +1,6 @@
 # Website SDK Instructions
 
-These instructions describe `@v-office/website-sdk` 2.0.0.
+These instructions describe `@v-office/website-sdk` 2.1.0.
 
 Use this directory as the consumer-facing reference for the package:
 
@@ -12,8 +12,10 @@ Use this directory as the consumer-facing reference for the package:
 - `quote.md`: quote, additional services, cancellation policy, and insurance flows.
 - `booking.md`: booking and payment option submission.
 - `contact.md`: contact submission.
+- `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.1.0/`: 2.1.0 release notes and 2.0.0-to-2.1.0 migration guide.
 - `versions/2.0.0/`: release-specific 2.0.0 changelog and 1.x-to-2.0.0 migration guide.
 
 ## Package
@@ -27,27 +29,27 @@ The package is ESM-only and exports the root SDK facade from `@v-office/website-
 ## Quick Start
 
 ```ts
-import { createWebsiteSDK, defineWebsiteSDKOptions } from '@v-office/website-sdk'
+import { createWebsiteSDK, defineWebsiteSDKOptions } from "@v-office/website-sdk";
 
 const sdk = createWebsiteSDK({
   config: {
-    backend: 'v10',
-    apiEndpoint: 'https://api.example.com/graphql',
-    accessToken: '...',
-    imageBaseUrl: 'https://images.example.com',
+    backend: "v10",
+    apiEndpoint: "https://api.example.com/graphql",
+    accessToken: "...",
+    imageBaseUrl: "https://images.example.com",
   },
   options: defineWebsiteSDKOptions({
     rentalScope: {
-      propertyId: 'property-1',
+      propertyId: "property-1",
     },
   }),
-})
+});
 
 try {
-  const rentals = await sdk.static.rentals.getRentals({ locale: 'de-DE' })
-  console.log(rentals)
+  const rentals = await sdk.static.rentals.getRentals({ locale: "de-DE" });
+  console.log(rentals);
 } finally {
-  await sdk.dispose()
+  await sdk.dispose();
 }
 ```
 
@@ -59,4 +61,4 @@ website-sdk --backend v9 filters --locale en-US
 website-sdk --backend v10 search --locale de-DE --query "adults=2"
 ```
 
-Config file examples in these docs use the 2.0.0 flat `WebsiteSDKConfig` shape.
+Config file examples in these docs use the flat `WebsiteSDKConfig` shape introduced in 2.0.0 and kept in 2.1.0.

package/instructions/availability.md

@@ -5,8 +5,8 @@
 Use the live availability API to build date-picker flows:
 
 ```ts
-const initial = await sdk.live.availability.getInitialAvailability(input)
-const selected = await sdk.live.availability.getStartDateSelectedAvailability(input)
+const initial = await sdk.live.availability.getInitialAvailability(input);
+const selected = await sdk.live.availability.getStartDateSelectedAvailability(input);
 ```
 
 `getInitialAvailability` marks possible start dates. `getStartDateSelectedAvailability` marks possible end dates after a start date was selected.
@@ -17,19 +17,19 @@ Initial availability:
 
 ```ts
 type InitialAvailabilityInput = {
-  locale: 'de-DE' | 'en-US'
-  rentalId: string
-  calculateFromDate: string
-  calculateThroughDate: string
-}
+  locale: "de-DE" | "en-US";
+  rentalId: string;
+  calculateFromDate: string;
+  calculateThroughDate: string;
+};
 ```
 
 Start-date-selected availability:
 
 ```ts
 type StartDateSelectedAvailabilityInput = InitialAvailabilityInput & {
-  selectedStartDate: string
-}
+  selectedStartDate: string;
+};
 ```
 
 Sample:

package/instructions/booking.md

@@ -5,7 +5,7 @@
 Use the live booking API to turn an available `GuestQuote` into a booking:
 
 ```ts
-const booking = await sdk.live.booking.book(input)
+const booking = await sdk.live.booking.book(input);
 ```
 
 The `quote` must be the `GuestQuote` instance returned by `sdk.live.quote.quote(...)`, optionally updated through quote selection helpers.
@@ -14,53 +14,53 @@ The `quote` must be the `GuestQuote` instance returned by `sdk.live.quote.quote(
 
 ```ts
 type BookingInput = {
-  quote: GuestQuote
+  quote: GuestQuote;
   contact: {
-    forename: string
-    surname: string
-    title?: string
-    birthdate?: string
+    forename: string;
+    surname: string;
+    title?: string;
+    birthdate?: string;
     address: {
-      street: string
-      housenumber?: string
-      postalcode: string
-      city: string
-      countryCode: string
-    }
-    contactDetails: { email: string; phone: string } | { email: string } | { phone: string }
-    note?: string
-  }
-  relativeRedirectUrl: string
-}
+      street: string;
+      housenumber?: string;
+      postalcode: string;
+      city: string;
+      countryCode: string;
+    };
+    contactDetails: { email: string; phone: string } | { email: string } | { phone: string };
+    note?: string;
+  };
+  relativeRedirectUrl: string;
+};
 ```
 
 Sample:
 
 ```ts
-const quoteResult = await sdk.live.quote.quote(quoteInput)
-if (quoteResult.status !== 'available') throw new Error(quoteResult.reason)
+const quoteResult = await sdk.live.quote.quote(quoteInput);
+if (quoteResult.status !== "available") throw new Error(quoteResult.reason);
 
 const booking = await sdk.live.booking.book({
   quote: quoteResult.quote,
   contact: {
-    forename: 'Jane',
-    surname: 'Doe',
-    title: 'Ms',
+    forename: "Jane",
+    surname: "Doe",
+    title: "Ms",
     address: {
-      street: 'Main Street',
-      housenumber: '1',
-      postalcode: '12345',
-      city: 'Berlin',
-      countryCode: 'DE',
+      street: "Main Street",
+      housenumber: "1",
+      postalcode: "12345",
+      city: "Berlin",
+      countryCode: "DE",
     },
     contactDetails: {
-      email: 'jane@example.com',
-      phone: '+49123456789',
+      email: "jane@example.com",
+      phone: "+49123456789",
     },
-    note: 'Please prepare a baby bed.',
+    note: "Please prepare a baby bed.",
   },
-  relativeRedirectUrl: '/booking/payment-return',
-})
+  relativeRedirectUrl: "/booking/payment-return",
+});
 ```
 
 `relativeRedirectUrl` is used for online payment redirects after booking creation.
@@ -123,7 +123,7 @@ Booking requests are rate-limited to one backend request per second with a queue
 
 ## CLI Usage
 
-`website-sdk` 2.0.0 includes a booking CLI command. It creates a fresh quote from a quote input file, then books that quote with a booking contact file:
+The CLI includes a booking command. It creates a fresh quote from a quote input file, then books that quote with a booking contact file:
 
 ```sh
 website-sdk --backend v10 booking book --quote-input ./quote-input.json --contact-input ./booking-contact.json --relative-redirect-url /booking/payment-return --yes

package/instructions/contact.md

@@ -5,29 +5,31 @@
 Use the live contact API to submit a contact request:
 
 ```ts
-await sdk.live.contact.submit(input)
+await sdk.live.contact.submit(input);
 ```
 
-`v9` submits the request through the v0 `saveMessage` action. The current `v10` implementation is a placeholder and resolves without sending a backend request.
+`v9` submits the request through the v0 `saveMessage` action. `v10` submits the request through the `messengeremail_newContactRequest` GraphQL operation.
 
 ## Input
 
 ```ts
 type ContactInput = {
-  title: string
-  professionalTitle: string
-  forename: string
-  surname: string
+  locale?: "de-DE" | "en-US";
+  title: string;
+  professionalTitle: string;
+  forename: string;
+  surname: string;
   address: {
-    streetAndHousenumber: string
-    postalCode: string
-    city: string
-    countryCode: string
-  }
-  email: string
-  phone?: string
-  message: string
-}
+    streetAndHousenumber: string;
+    postalCode: string;
+    city: string;
+    countryCode: string;
+  };
+  email: string;
+  phone: string;
+  subject: string;
+  message: string;
+};
 ```
 
 `ContactSubmitInput` is the core SDK type name. `ContactInput` remains exported as a legacy alias.
@@ -36,6 +38,7 @@ Sample:
 
 ```json
 {
+  "locale": "de-DE",
   "title": "Ms",
   "professionalTitle": "",
   "forename": "Jane",
@@ -48,6 +51,7 @@ Sample:
   },
   "email": "jane@example.com",
   "phone": "+49123456789",
+  "subject": "Question about a rental",
   "message": "I have a question about a rental."
 }
 ```
@@ -64,7 +68,21 @@ Successful CLI output:
 }
 ```
 
-Errors are reported as `CoreSDKError`, also exported as the compatibility alias `CMSError`. The 2.0.0 error shape uses `source` instead of the legacy `backend` field.
+Errors are reported as `CoreSDKError`, also exported as the compatibility alias `CMSError`. The current error shape uses `source` instead of the legacy `backend` field.
+
+Contact input is validated before submitting to either backend. Validation failures reject with a `CoreSDKError` using `operation: "contact.submit.validation"`. The error `message` is translated with `input.locale` and defaults to German (`de-DE`) when no locale is provided. Field-level details are available on `error.cause.issues`:
+
+```json
+{
+  "issues": [
+    {
+      "path": "email",
+      "code": "invalid_email",
+      "message": "Bitte geben Sie eine gültige E-Mail-Adresse ein."
+    }
+  ]
+}
+```
 
 ## Configuration