@v-office/website-sdk 3.2.0 → 3.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.mjs +3 -3
- package/dist/{client-DXqHhnpA.mjs → client-BlQ5phsZ.mjs} +4 -4
- package/dist/index.d.mts +5 -0
- package/dist/index.mjs +1 -1
- package/dist/instructions/CHANGELOG.md +2 -0
- package/dist/instructions/MIGRATION.md +2 -0
- package/dist/instructions/quote.md +5 -0
- package/dist/instructions/rentals.md +41 -1
- package/dist/instructions/versions/3.2.1/CHANGELOG.md +13 -0
- package/dist/instructions/versions/3.2.1/MIGRATION.md +10 -0
- package/dist/instructions/versions/3.3.0/CHANGELOG.md +22 -0
- package/dist/instructions/versions/3.3.0/MIGRATION.md +22 -0
- package/dist/{operations-Bc3WxjV8.mjs → operations-Db2hRCLQ.mjs} +0 -8
- package/dist/{quote-cjFdLn0m.mjs → quote-Co8iWjF6.mjs} +1 -0
- package/dist/{rentals-C6PIx1RJ.mjs → rentals-z97dUqwO.mjs} +23 -3
- package/dist/{search-Dljn4VGV.mjs → search-C4j2QSpv.mjs} +3 -3
- package/dist/{to-rental-highlights-9AbqVIso.mjs → to-rental-highlights-BFLLKF6M.mjs} +1 -1
- package/dist/translations/shared/de-DE/quote.json +1 -0
- package/dist/translations/shared/en-US/quote.json +1 -0
- package/instructions/CHANGELOG.md +2 -0
- package/instructions/MIGRATION.md +2 -0
- package/instructions/quote.md +5 -0
- package/instructions/rentals.md +41 -1
- package/instructions/versions/3.2.1/CHANGELOG.md +13 -0
- package/instructions/versions/3.2.1/MIGRATION.md +10 -0
- package/instructions/versions/3.2.1/release.json +3 -0
- package/instructions/versions/3.3.0/CHANGELOG.md +22 -0
- package/instructions/versions/3.3.0/MIGRATION.md +22 -0
- package/instructions/versions/3.3.0/release.json +3 -0
- package/package.json +3 -3
package/dist/cli.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import { $t as V9_HUB_FACILITY_SCOPE_FILTER_KEY, Yt as defineWebsiteSDKOptions, Zt as defineV9PropertyHighlightSourcesFromUnknown, _ as rental_attributes_default$1, an as V9_HUB_REGION_FILTER_KEY, cn as V9_SDK_OWNED_HUB_FILTER_KEYS, en as V9_HUB_FACILITY_SEARCH_FILTER_KEY, f as makeV9GraphQLClient, h as makeV0OpenApiClientFetchLive, i as toV9SdkOwnedHubFilterKeys, in as V9_HUB_OFFER_FILTER_KEY, ln as stable_filters_default, n as checkV9HubFilters, nn as V9_HUB_OBJECT_GROUP_SCOPE_FILTER_KEY, on as V9_HUB_RENTAL_IDS_FILTER_KEY, p as V0OpenApiClient, r as toV9RequiredHubFilterKeys, rn as V9_HUB_OFFERS_FILTER_KEY, sn as V9_HUB_UNIT_TYPE_FILTER_KEY, t as createWebsiteSDK, tn as V9_HUB_OBJECT_GROUP_FILTER_KEY, v as rental_attributes_default } from "./client-
|
|
3
|
-
import { C as parseVofficeRatingData, a as hubFiltersQuery, b as parseJsonData, o as hubRentalDataQuery, p as rentalsAllWithoutFeedbacksQuery, v as VofficeUnitDataPropertyMetadata } from "./operations-
|
|
2
|
+
import { $t as V9_HUB_FACILITY_SCOPE_FILTER_KEY, Yt as defineWebsiteSDKOptions, Zt as defineV9PropertyHighlightSourcesFromUnknown, _ as rental_attributes_default$1, an as V9_HUB_REGION_FILTER_KEY, cn as V9_SDK_OWNED_HUB_FILTER_KEYS, en as V9_HUB_FACILITY_SEARCH_FILTER_KEY, f as makeV9GraphQLClient, h as makeV0OpenApiClientFetchLive, i as toV9SdkOwnedHubFilterKeys, in as V9_HUB_OFFER_FILTER_KEY, ln as stable_filters_default, n as checkV9HubFilters, nn as V9_HUB_OBJECT_GROUP_SCOPE_FILTER_KEY, on as V9_HUB_RENTAL_IDS_FILTER_KEY, p as V0OpenApiClient, r as toV9RequiredHubFilterKeys, rn as V9_HUB_OFFERS_FILTER_KEY, sn as V9_HUB_UNIT_TYPE_FILTER_KEY, t as createWebsiteSDK, tn as V9_HUB_OBJECT_GROUP_FILTER_KEY, v as rental_attributes_default } from "./client-BlQ5phsZ.mjs";
|
|
3
|
+
import { C as parseVofficeRatingData, a as hubFiltersQuery, b as parseJsonData, o as hubRentalDataQuery, p as rentalsAllWithoutFeedbacksQuery, v as VofficeUnitDataPropertyMetadata } from "./operations-Db2hRCLQ.mjs";
|
|
4
4
|
import { STABLE_SEARCH_INPUTS, SearchSearchSortSchema, defineCustomAttributesFromUnknown, toStableSearchInputQueryKeys } from "@v-office/sdk-core";
|
|
5
5
|
import { ByteSize, Console, Effect, FileSystem, Layer, Option, Path, Schema, Stdio, Terminal } from "effect";
|
|
6
6
|
import { Command, Flag } from "effect/unstable/cli";
|
|
@@ -17,7 +17,7 @@ var CLICheckFailed = class extends Error {
|
|
|
17
17
|
const toCLIError = (message, cause) => cause instanceof Error ? new CLICheckFailed(`${message}: ${cause.message}`, { cause }) : new CLICheckFailed(message, { cause });
|
|
18
18
|
//#endregion
|
|
19
19
|
//#region package.json
|
|
20
|
-
var version = "3.
|
|
20
|
+
var version = "3.3.0";
|
|
21
21
|
//#endregion
|
|
22
22
|
//#region src/cli/output.ts
|
|
23
23
|
const toJson = (value) => Effect.try({
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { b as parseJsonData, l as rentalRegionsQuery, m as RegionSchema$1, t as voucherValidityQuery, w as parseVofficeUnitData, y as customDataAttribute } from "./operations-
|
|
1
|
+
import { b as parseJsonData, l as rentalRegionsQuery, m as RegionSchema$1, t as voucherValidityQuery, w as parseVofficeUnitData, y as customDataAttribute } from "./operations-Db2hRCLQ.mjs";
|
|
2
2
|
import { AvailabilityService, BookingBookOutput, BookingService, ContactService, CoreSDKError, DEFAULT_RENTAL_HIGHLIGHT_PRIORITIZATION, DEFAULT_RENTAL_PROPERTY_HIGHLIGHT_PRIORITIZATION, DocumentsService, EMPTY_CUSTOM_ATTRIBUTE_REGISTRY, FilterService, QuoteService, RegionsService, RentalService, SEARCH_ALL_RENTALS_AT_ONCE_MAX_RESULTS, SearchService, TranslationService, addGuestQuoteAdditionalServiceSelection, asArray, asRecord, assertNoNestedCustomAttributeFilterCompositions, assertNoReservedQueryKeys, assertUniqueCustomFilterQueryKeys, assertUniqueFilterQueryKeys, buildWebsiteRegions, clearGuestQuoteAdditionalServiceSelections, collectQueryParameters, createCoreRuntime, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, firstNumber, firstString, formatCurrency, formatLocalDate, getBookingBookGuestToken, getGuestQuoteBackendContext, getGuestQuoteInput, isDisplayableCustomAttribute, localeToLanguage, makeMinIntervalLimiter, makeTranslationLive, normalizeV10RateBudget, parseQueryParameters, refreshGuestQuoteInsurancePassthrough, removeGuestQuoteAdditionalServiceSelection, selectGuestQuoteCancellationPolicySelection, toCountLabelKey, toCustomAttributeFilterLabel, toCustomAttributeFilterOutputItem, toCustomAttributeList, toInitialAvailabilityCalendarDays, toIsoDateFromPeriodQueryDate, toNoInsuranceOption, toNotOfferedInsurance, toQueryString, toResolvedCustomAttributeCategoryTranslationKey, toStartDateSelectedCalendarDays, validateContactSubmitInput, withGuestQuoteInsurance, withGuestQuoteInsuranceRefresh } from "@v-office/sdk-core";
|
|
3
3
|
import { Clock, Context, Data, DateTime, Duration, Effect, Layer, Schema, SchemaGetter } from "effect";
|
|
4
4
|
import { FetchHttpClient, HttpClient, HttpClientRequest } from "effect/unstable/http";
|
|
@@ -6236,7 +6236,7 @@ const revokeV9InsurancePolicy = ({ policyNumber, booking, v1Client }) => Effect.
|
|
|
6236
6236
|
//#region src/legacy-v9/live/quote.ts
|
|
6237
6237
|
const loadQuoteRuntime = Effect.tryPromise({
|
|
6238
6238
|
try: async () => {
|
|
6239
|
-
return { toGuestQuote: (await import("./quote-
|
|
6239
|
+
return { toGuestQuote: (await import("./quote-Co8iWjF6.mjs")).toGuestQuote };
|
|
6240
6240
|
},
|
|
6241
6241
|
catch: (cause) => new CoreSDKError({
|
|
6242
6242
|
source: "v9",
|
|
@@ -6590,7 +6590,7 @@ const parseV9SearchCursor = (cursor) => Effect.gen(function* () {
|
|
|
6590
6590
|
return page;
|
|
6591
6591
|
});
|
|
6592
6592
|
const loadV9SearchRuntime = Effect.tryPromise({
|
|
6593
|
-
try: () => import("./search-
|
|
6593
|
+
try: () => import("./search-C4j2QSpv.mjs"),
|
|
6594
6594
|
catch: (cause) => new CoreSDKError({
|
|
6595
6595
|
source: "v9",
|
|
6596
6596
|
operation: "v9.search.runtime",
|
|
@@ -7501,7 +7501,7 @@ const orderRentalsById = ({ rentalIds, rentals, missing }) => {
|
|
|
7501
7501
|
});
|
|
7502
7502
|
};
|
|
7503
7503
|
const loadV9RentalsRuntime = Effect.tryPromise({
|
|
7504
|
-
try: () => import("./rentals-
|
|
7504
|
+
try: () => import("./rentals-z97dUqwO.mjs"),
|
|
7505
7505
|
catch: (cause) => new CoreSDKError({
|
|
7506
7506
|
source: "v9",
|
|
7507
7507
|
operation: "v9.rentals.runtime",
|
package/dist/index.d.mts
CHANGED
|
@@ -610,6 +610,11 @@ export declare const getRentalsEffect: (input: RentalGetRentalsInput$1) => Effec
|
|
|
610
610
|
}[];
|
|
611
611
|
};
|
|
612
612
|
};
|
|
613
|
+
readonly links?: readonly {
|
|
614
|
+
readonly type: "EXPOSE" | "HP" | "OTHER" | "THREE_D" | "VIDEO";
|
|
615
|
+
readonly url: string;
|
|
616
|
+
readonly language?: string;
|
|
617
|
+
}[];
|
|
613
618
|
}[], CoreSDKError$1, RentalService>;
|
|
614
619
|
export declare const getFiltersEffect: (input: FilterGetFiltersInput$1) => Effect.Effect<readonly ({
|
|
615
620
|
readonly searchParameterQueryKey: string;
|
package/dist/index.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { $ as QuoteSchema, A as DocumentResourceSchema, At as bookInsuranceEffect, B as ErgoPersonSchema, Bt as quoteEffect, C as ApiEnvelopeBaseSchema, Ct as V1_BASE_URL, D as CustomerUnitSummarySchema, Dt as decodeV1OperationResponse, E as CurrentMemberResponseSchema, Et as VideoResponseSchema, F as ErgoAddressSchema, Ft as getInitialAvailabilityEffect, G as FacilityListResponseSchema, Gt as selectInsurancePaymentEffect, H as ErgoPolicyNumberRequestSchema, Ht as searchEffect, I as ErgoBankSchema, It as getRentalsEffect, J as PaymentScheduleItemSchema, Jt as submitPaymentOptionEffect, K as OnOfficeUnitCollectionResponseSchema, Kt as submitContactEffect, L as ErgoBookRequestSchema, Lt as getStartDateSelectedAvailabilityEffect, M as DocumentStatusUpdateRequestSchema, Mt as createInsurancePreContractEffect, N as DocumentSummarySchema, Nt as getBankTransferDetailsEffect, O as DocumentCollectionResponseSchema, Ot as addAdditionalServiceEffect, P as DocumentTypeSchema, Pt as getFiltersEffect, Q as QuotePricesResponseSchema, R as ErgoCommonFieldsSchema, Rt as getTermsAndPrivacyPolicyEffect, S as makeV1OpenApiClientLive, St as UnitServicePriceSchema, T as CalendarResponseSchema, Tt as VideoListResponseSchema, U as ErgoReadPreContractRequestSchema, Ut as selectCancellationPolicyEffect, V as ErgoPlanSearchRequestSchema, Vt as removeAdditionalServiceEffect, W as ErgoTripAndCustomerRequestSchema, Wt as selectInsuranceEffect, X as QuoteLineSchema, Xt as defineV9PropertyHighlightSources, Y as PaymentScheduleSchema, Yt as defineWebsiteSDKOptions, Z as QuotePricesPayloadSchema, Zt as defineV9PropertyHighlightSourcesFromUnknown, _t as UnitIdsResponseSchema, at as SearchPropertiesResponseSchema, b as V1OpenApiClientError, bt as UnitOfferSchema, ct as ServiceLimitSchema, dt as SetupResponseSchema, et as QuoteServiceSchema, ft as TileCollectionResponseSchema, g as makeV0OpenApiClientLive, gt as TravelInsuranceBookingStoreRequestSchema, h as makeV0OpenApiClientFetchLive, ht as TravelInsuranceBookingSchema, it as RoomImageSchema, j as DocumentStatusSchema, jt as clearAdditionalServicesEffect, k as DocumentResourceResponseSchema, kt as bookEffect, lt as ServiceListResponseSchema, m as V0OpenApiClientError, mt as TileTagSchema, nt as RawVofficeObjectSchema, ot as ServiceBeonDataSchema, p as V0OpenApiClient, pt as TileSchema, q as OnOfficeUnitSchema, qt as submitPaymentOption, rt as RegionListResponseSchema, st as ServiceImageSchema, t as createWebsiteSDK, tt as RawObjectResponseSchema, ut as SetupDataSchema, vt as UnitListItemSchema, w as CalendarDaySchema, wt as V1_OPERATIONS, x as makeV1OpenApiClientFetchLive, xt as UnitResponseSchema, y as V1OpenApiClient, yt as UnitListResponseSchema, z as ErgoCreatePreContractRequestSchema, zt as mapSearchEffect } from "./client-
|
|
1
|
+
import { $ as QuoteSchema, A as DocumentResourceSchema, At as bookInsuranceEffect, B as ErgoPersonSchema, Bt as quoteEffect, C as ApiEnvelopeBaseSchema, Ct as V1_BASE_URL, D as CustomerUnitSummarySchema, Dt as decodeV1OperationResponse, E as CurrentMemberResponseSchema, Et as VideoResponseSchema, F as ErgoAddressSchema, Ft as getInitialAvailabilityEffect, G as FacilityListResponseSchema, Gt as selectInsurancePaymentEffect, H as ErgoPolicyNumberRequestSchema, Ht as searchEffect, I as ErgoBankSchema, It as getRentalsEffect, J as PaymentScheduleItemSchema, Jt as submitPaymentOptionEffect, K as OnOfficeUnitCollectionResponseSchema, Kt as submitContactEffect, L as ErgoBookRequestSchema, Lt as getStartDateSelectedAvailabilityEffect, M as DocumentStatusUpdateRequestSchema, Mt as createInsurancePreContractEffect, N as DocumentSummarySchema, Nt as getBankTransferDetailsEffect, O as DocumentCollectionResponseSchema, Ot as addAdditionalServiceEffect, P as DocumentTypeSchema, Pt as getFiltersEffect, Q as QuotePricesResponseSchema, R as ErgoCommonFieldsSchema, Rt as getTermsAndPrivacyPolicyEffect, S as makeV1OpenApiClientLive, St as UnitServicePriceSchema, T as CalendarResponseSchema, Tt as VideoListResponseSchema, U as ErgoReadPreContractRequestSchema, Ut as selectCancellationPolicyEffect, V as ErgoPlanSearchRequestSchema, Vt as removeAdditionalServiceEffect, W as ErgoTripAndCustomerRequestSchema, Wt as selectInsuranceEffect, X as QuoteLineSchema, Xt as defineV9PropertyHighlightSources, Y as PaymentScheduleSchema, Yt as defineWebsiteSDKOptions, Z as QuotePricesPayloadSchema, Zt as defineV9PropertyHighlightSourcesFromUnknown, _t as UnitIdsResponseSchema, at as SearchPropertiesResponseSchema, b as V1OpenApiClientError, bt as UnitOfferSchema, ct as ServiceLimitSchema, dt as SetupResponseSchema, et as QuoteServiceSchema, ft as TileCollectionResponseSchema, g as makeV0OpenApiClientLive, gt as TravelInsuranceBookingStoreRequestSchema, h as makeV0OpenApiClientFetchLive, ht as TravelInsuranceBookingSchema, it as RoomImageSchema, j as DocumentStatusSchema, jt as clearAdditionalServicesEffect, k as DocumentResourceResponseSchema, kt as bookEffect, lt as ServiceListResponseSchema, m as V0OpenApiClientError, mt as TileTagSchema, nt as RawVofficeObjectSchema, ot as ServiceBeonDataSchema, p as V0OpenApiClient, pt as TileSchema, q as OnOfficeUnitSchema, qt as submitPaymentOption, rt as RegionListResponseSchema, st as ServiceImageSchema, t as createWebsiteSDK, tt as RawObjectResponseSchema, ut as SetupDataSchema, vt as UnitListItemSchema, w as CalendarDaySchema, wt as V1_OPERATIONS, x as makeV1OpenApiClientFetchLive, xt as UnitResponseSchema, y as V1OpenApiClient, yt as UnitListResponseSchema, z as ErgoCreatePreContractRequestSchema, zt as mapSearchEffect } from "./client-BlQ5phsZ.mjs";
|
|
2
2
|
import { AdditionalServiceLimitExceeded, CoreSDKError, CoreSDKError as CMSError, CustomAttributeCatalogSchema, GuestQuoteSchema, InvalidAdditionalServiceQuantity, LocaleSchema, SEARCH_ALL_RENTALS_AT_ONCE_MAX_RESULTS, SearchMapSearchInputSchema, SearchMapSearchOutputSchema, SearchSearchFieldOrderBySchema, SearchSearchFieldSortSchema, SearchSearchInputSchema, SearchSearchOutputSchema, SearchSearchPriceSortSchema, SearchSearchRandomSortSchema, SearchSearchRatingSortSchema, SearchSearchSortSchema, SearchSortDirectionSchema, UnknownAdditionalService, defineCustomAttributes, defineCustomAttributesFromUnknown, fetchCustomAttributeCatalog, parseCustomAttributeCatalog, validateContactSubmitInput } from "@v-office/sdk-core";
|
|
3
3
|
//#region codegen/v9/heuristic-generation/public-api.ts
|
|
4
4
|
const customDataAttribute = (name) => name;
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
|
|
5
5
|
Release notes of `@v-office/website-sdk`, newest first. Each version has its own directory.
|
|
6
6
|
|
|
7
|
+
- `versions/3.3.0/CHANGELOG.md`: release notes for 3.3.0
|
|
8
|
+
- `versions/3.2.1/CHANGELOG.md`: release notes for 3.2.1
|
|
7
9
|
- `versions/3.2.0/CHANGELOG.md`: release notes for 3.2.0
|
|
8
10
|
- `versions/3.1.1/CHANGELOG.md`: release notes for 3.1.1
|
|
9
11
|
- `versions/3.1.0/CHANGELOG.md`: release notes for 3.1.0
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
|
|
5
5
|
Migration guides of `@v-office/website-sdk`, newest first. Apply them in order when skipping versions.
|
|
6
6
|
|
|
7
|
+
- `versions/3.3.0/MIGRATION.md`: Migration: 3.2.1 to 3.3.0
|
|
8
|
+
- `versions/3.2.1/MIGRATION.md`: Migration: 3.2.0 to 3.2.1
|
|
7
9
|
- `versions/3.2.0/MIGRATION.md`: Migration: 3.1.1 to 3.2.0
|
|
8
10
|
- `versions/3.1.1/MIGRATION.md`: Migration: 3.1.0 to 3.1.1
|
|
9
11
|
- `versions/3.1.0/MIGRATION.md`: Migration: 3.0.0 to 3.1.0
|
|
@@ -315,6 +315,11 @@ them, and never replace them with descriptions or pictures written into the site
|
|
|
315
315
|
in the production hub at launch, or the live site shows the extras without them.
|
|
316
316
|
- `v10`: the PMS sends neither; additional services have a label and a price only.
|
|
317
317
|
|
|
318
|
+
A service priced at 0 (a free baby cot or high chair) is offered like any other. Its `charge` is
|
|
319
|
+
"kostenlos" ("free", translation key `quote.additionalService.free`) without a per-night or
|
|
320
|
+
per-day unit; selecting it leaves the total unchanged and books it with the stay. Show `charge` as
|
|
321
|
+
it is. A service whose price cannot be determined is not offered.
|
|
322
|
+
|
|
318
323
|
When the backend provides a line amount for an optional service, it is exposed as `proposedQuantity` (including `0`). By default this is informational only and is not added to the quote. Set `shouldAddProposedAdditionalServiceAmount: true` in `WebsiteSDKOptions` to automatically select proposed quantities greater than zero when the quote is created.
|
|
319
324
|
|
|
320
325
|
Use the service `id` to add or remove a service selection:
|
|
@@ -96,7 +96,7 @@ Sample item:
|
|
|
96
96
|
}
|
|
97
97
|
```
|
|
98
98
|
|
|
99
|
-
Optional fields include `scope`, `address`, `property`, `rooms`, `roomSummary`, `vicinity`, and `
|
|
99
|
+
Optional fields include `scope`, `address`, `property`, `rooms`, `roomSummary`, `vicinity`, `reviews`, and `links`.
|
|
100
100
|
|
|
101
101
|
### Texts in another language
|
|
102
102
|
|
|
@@ -182,6 +182,46 @@ count the backend does not state, or states as 0, is omitted, never 0.
|
|
|
182
182
|
|
|
183
183
|
Search items carry the same `capacity`.
|
|
184
184
|
|
|
185
|
+
### Links and 3D tours
|
|
186
|
+
|
|
187
|
+
`links` lists the links the agency keeps on the rental, each `{ type, url, language? }`.
|
|
188
|
+
`type` is `THREE_D` (a 3D tour, usually Matterport), `VIDEO`, `EXPOSE`, `HP` (the rental's
|
|
189
|
+
own website) or `OTHER`. `language` is the language the PMS states for the link, omitted when
|
|
190
|
+
it states none. The field is omitted when the rental has no link. Search items do not
|
|
191
|
+
carry `links`; read them from `getRentals` or the rental details.
|
|
192
|
+
|
|
193
|
+
```json
|
|
194
|
+
"links": [{ "type": "THREE_D", "url": "https://my.matterport.com/show/?m=ukGhLPgstJm" }]
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
Where the agency maintains a 3D tour:
|
|
198
|
+
|
|
199
|
+
| Backend | Where in the PMS |
|
|
200
|
+
| ------- | --------------------------------------------------------------------------------- |
|
|
201
|
+
| v10 | the rental's links, type "3D-Tour" |
|
|
202
|
+
| v9 | the unit's feature "Matterport ID" (general): the model ID or the Matterport link |
|
|
203
|
+
|
|
204
|
+
On v9 the SDK turns the Matterport ID into a `THREE_D` link and drops a value that is neither
|
|
205
|
+
a model ID nor an `https` Matterport link. v9 has no other link types. When a rental has no
|
|
206
|
+
tour, tell the agency where to maintain it instead of building a placeholder.
|
|
207
|
+
|
|
208
|
+
To show a tour on the rental page, add a button labelled "3D-Rundgang" / "3D tour" that opens
|
|
209
|
+
a modal with the tour. Render the iframe only once the modal opens, so the page does not load
|
|
210
|
+
Matterport for every visitor:
|
|
211
|
+
|
|
212
|
+
```html
|
|
213
|
+
<iframe
|
|
214
|
+
src="https://my.matterport.com/show/?m=ukGhLPgstJm"
|
|
215
|
+
title="3D-Rundgang"
|
|
216
|
+
allow="fullscreen; xr-spatial-tracking"
|
|
217
|
+
allowfullscreen
|
|
218
|
+
style="width: 100%; aspect-ratio: 16 / 9; border: 0"
|
|
219
|
+
></iframe>
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
Embed only URLs on `matterport.com`. Other providers often refuse to be framed: open their
|
|
223
|
+
`url` in a new tab (`target="_blank" rel="noopener"`).
|
|
224
|
+
|
|
185
225
|
### Legacy v9 Images
|
|
186
226
|
|
|
187
227
|
v9 rental `images` and facility `property.images` come from vOffice's image service
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Changelog: 3.2.1
|
|
2
|
+
|
|
3
|
+
Optional services priced at 0, such as a free baby cot or high chair, are offered as additional
|
|
4
|
+
services and read "kostenlos" ("free") instead of a price.
|
|
5
|
+
|
|
6
|
+
## Fixed
|
|
7
|
+
|
|
8
|
+
- v10: an optional service priced at 0 is in `quote.additionalServices`. Until now the quote
|
|
9
|
+
dropped it, and `addAdditionalService` rejected its id as unknown. Selecting it leaves the
|
|
10
|
+
total unchanged, and the booking sends it to the PMS like a paid one.
|
|
11
|
+
- v9 and v10: the `charge` of a free service is the translated `quote.additionalService.free`
|
|
12
|
+
("kostenlos", "free") instead of "0,00 €", without a per-night or per-day unit. v9 already
|
|
13
|
+
offered these services, with "0,00 €".
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# Migration: 3.2.0 to 3.2.1
|
|
2
|
+
|
|
3
|
+
No changes required. A site that renders `quote.additionalServices` shows the free services
|
|
4
|
+
without a change; one that hid "0,00 €" or wrote "free" itself can read `charge` as it is.
|
|
5
|
+
|
|
6
|
+
## 1. Upgrade
|
|
7
|
+
|
|
8
|
+
```sh
|
|
9
|
+
pnpm add @v-office/website-sdk@3.2.1
|
|
10
|
+
```
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Changelog: 3.3.0
|
|
2
|
+
|
|
3
|
+
A site can show a rental's 3D tour (Matterport) from one field on v9 and v10, and v9 no longer
|
|
4
|
+
lists the Matterport ID as an amenity.
|
|
5
|
+
|
|
6
|
+
## Added
|
|
7
|
+
|
|
8
|
+
- `links` on rentals and rental details: `{ type, url, language? }` per link, where `type` is
|
|
9
|
+
`THREE_D` (3D tour), `VIDEO`, `EXPOSE`, `HP` (the rental's own website) or `OTHER`. The field
|
|
10
|
+
is omitted when the rental has no link. Search items do not carry it.
|
|
11
|
+
- v10: the links of the rental in the PMS, as the PMS states them.
|
|
12
|
+
- v9: one `THREE_D` link from the unit's feature "Matterport ID". A model ID becomes
|
|
13
|
+
`https://my.matterport.com/show/?m=<id>`, a pasted `https` Matterport link is kept in
|
|
14
|
+
its normalized URL form (lowercase host, characters such as `"` percent-encoded),
|
|
15
|
+
any other value gives no link. v9 has no other link types.
|
|
16
|
+
- `rentals.md` ("Links and 3D tours"): where the agency maintains the tour on each backend and
|
|
17
|
+
how to show it as a "3D-Rundgang" button with a modal.
|
|
18
|
+
|
|
19
|
+
## Changed
|
|
20
|
+
|
|
21
|
+
- v9: the Matterport ID is no longer an attribute. `attributes` no longer has the item
|
|
22
|
+
"Matterport ID: …" and its fact with the key `matterport`; read the tour from `links`.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Migration: 3.2.1 to 3.3.0
|
|
2
|
+
|
|
3
|
+
No changes required.
|
|
4
|
+
|
|
5
|
+
## 1. Upgrade
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
pnpm add @v-office/website-sdk@3.3.0
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## 2. Optional: drop the Matterport filter on v9
|
|
12
|
+
|
|
13
|
+
A v9 site that removes the item "Matterport ID: …" or the fact with the key `matterport` from
|
|
14
|
+
its amenity list can drop that filter: `attributes` no longer contains either. Nothing else in
|
|
15
|
+
`attributes` changes.
|
|
16
|
+
|
|
17
|
+
## 3. Optional: show the 3D tour
|
|
18
|
+
|
|
19
|
+
Read the tour from `links` (`type === "THREE_D"`) and show it as described in `rentals.md`,
|
|
20
|
+
"Links and 3D tours": a "3D-Rundgang" button on the rental page that opens a modal with the
|
|
21
|
+
Matterport iframe. When a rental has no tour, the agency maintains it in the PMS: on v10 as a
|
|
22
|
+
link of type "3D-Tour", on v9 as the unit's feature "Matterport ID".
|
|
@@ -3139,14 +3139,6 @@ const VofficeUnitDataPropertyMetadata = {
|
|
|
3139
3139
|
labelKey: "RentalAttributesCategory.ACTIVITY.label"
|
|
3140
3140
|
}
|
|
3141
3141
|
},
|
|
3142
|
-
matterport: {
|
|
3143
|
-
sourceType: "CODE",
|
|
3144
|
-
labelKey: "RentalAttributes.matterport.label",
|
|
3145
|
-
category: {
|
|
3146
|
-
key: "GENERAL",
|
|
3147
|
-
labelKey: "RentalAttributesCategory.GENERAL.label"
|
|
3148
|
-
}
|
|
3149
|
-
},
|
|
3150
3142
|
metaDescription: {
|
|
3151
3143
|
sourceType: "TEXT",
|
|
3152
3144
|
labelKey: "RentalAttributes.metaDescription.label",
|
|
@@ -13,6 +13,7 @@ const toAdditionalServiceCalculation = (line) => {
|
|
|
13
13
|
//#endregion
|
|
14
14
|
//#region src/legacy-v9/parser/quote/to-charge.ts
|
|
15
15
|
const toCharge = ({ serviceLine, chargeAmount, currency, locale, translations }) => Effect.gen(function* () {
|
|
16
|
+
if (chargeAmount === 0) return yield* translations.translate(locale, "quote.additionalService.free");
|
|
16
17
|
switch (serviceLine.calculation) {
|
|
17
18
|
case "NIGHT": return `${formatCurrency(chargeAmount, locale, currency)}${yield* translations.translate(locale, "quote.additionalService.night")}`;
|
|
18
19
|
case "DAY": return `${formatCurrency(chargeAmount, locale, currency)}${yield* translations.translate(locale, "quote.additionalService.day")}`;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { Qt as V9_FACILITY_ATTRIBUTE_KEYS } from "./client-
|
|
2
|
-
import { S as parseVofficeFeedbackData, _ as VofficeUnitDataPropertyCategoryValues, a as hubFiltersQuery, c as rentalIdsQuery, d as rentalsAllByFacilityObjectGroupsWithoutFeedbacksQuery, f as rentalsAllFeedbacksQuery, g as VofficeUnitDataPropertyCategoryLabelKeys, h as VofficeUnitDataFieldSchemas, i as facilityTextsQuery, p as rentalsAllWithoutFeedbacksQuery, s as rentalFacilitiesForObjectGroupRelationQuery, u as rentalTextsQuery, v as VofficeUnitDataPropertyMetadata, w as parseVofficeUnitData, x as parseVofficeFacilityData } from "./operations-
|
|
3
|
-
import { a as toLocation, d as toLocalizedString, l as toCapacity, n as renderVofficePropertyAttribute, o as toFacilityImages, r as toV9Fact, s as toImages, t as toRentalHighlights, u as toAddress } from "./to-rental-highlights-
|
|
1
|
+
import { Qt as V9_FACILITY_ATTRIBUTE_KEYS } from "./client-BlQ5phsZ.mjs";
|
|
2
|
+
import { S as parseVofficeFeedbackData, _ as VofficeUnitDataPropertyCategoryValues, a as hubFiltersQuery, c as rentalIdsQuery, d as rentalsAllByFacilityObjectGroupsWithoutFeedbacksQuery, f as rentalsAllFeedbacksQuery, g as VofficeUnitDataPropertyCategoryLabelKeys, h as VofficeUnitDataFieldSchemas, i as facilityTextsQuery, p as rentalsAllWithoutFeedbacksQuery, s as rentalFacilitiesForObjectGroupRelationQuery, u as rentalTextsQuery, v as VofficeUnitDataPropertyMetadata, w as parseVofficeUnitData, x as parseVofficeFacilityData } from "./operations-Db2hRCLQ.mjs";
|
|
3
|
+
import { a as toLocation, d as toLocalizedString, l as toCapacity, n as renderVofficePropertyAttribute, o as toFacilityImages, r as toV9Fact, s as toImages, t as toRentalHighlights, u as toAddress } from "./to-rental-highlights-BFLLKF6M.mjs";
|
|
4
4
|
import { CoreSDKError, makeTranslate, pushFact, renderResolvedCustomAttribute, toCustomAttributeFact, toCustomAttributeList, toFact, toResolvedCustomAttributeCategoryTranslationKey, toReviewClassification } from "@v-office/sdk-core";
|
|
5
5
|
import { Effect } from "effect";
|
|
6
6
|
//#region src/legacy-v9/parser/rentals/to-description.ts
|
|
@@ -25,6 +25,24 @@ const toDescription = (data, locale) => {
|
|
|
25
25
|
return description;
|
|
26
26
|
};
|
|
27
27
|
//#endregion
|
|
28
|
+
//#region src/legacy-v9/parser/rentals/to-links.ts
|
|
29
|
+
const MATTERPORT_MODEL_ID = /^[A-Za-z0-9]{11}$/;
|
|
30
|
+
const toMatterportUrl = (value) => {
|
|
31
|
+
if (MATTERPORT_MODEL_ID.test(value)) return `https://my.matterport.com/show/?m=${value}`;
|
|
32
|
+
if (!URL.canParse(value)) return void 0;
|
|
33
|
+
const url = new URL(value);
|
|
34
|
+
const isMatterport = url.hostname === "matterport.com" || url.hostname.endsWith(".matterport.com");
|
|
35
|
+
return url.protocol === "https:" && isMatterport ? url.href : void 0;
|
|
36
|
+
};
|
|
37
|
+
const toLinks = (data) => {
|
|
38
|
+
const matterport = data.known.matterport?.trim();
|
|
39
|
+
const url = matterport != null ? toMatterportUrl(matterport) : void 0;
|
|
40
|
+
return url != null ? [{
|
|
41
|
+
type: "THREE_D",
|
|
42
|
+
url
|
|
43
|
+
}] : [];
|
|
44
|
+
};
|
|
45
|
+
//#endregion
|
|
28
46
|
//#region src/legacy-v9/parser/rentals/to-property-attributes.ts
|
|
29
47
|
const toPropertyAttributes = ({ attributes, locale, translations }) => Effect.gen(function* () {
|
|
30
48
|
const group = {
|
|
@@ -563,6 +581,8 @@ const toRentalRentalsOutput = ({ rental, locale, translations, imageProxyBaseUrl
|
|
|
563
581
|
translations
|
|
564
582
|
});
|
|
565
583
|
if (reviews != null) item.reviews = reviews;
|
|
584
|
+
const links = toLinks(data);
|
|
585
|
+
if (links.length > 0) item.links = links;
|
|
566
586
|
return item;
|
|
567
587
|
});
|
|
568
588
|
//#endregion
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { a as makeV9CustomAttributeFilterCapabilities, c as parseQueryParameters, d as toVoucherCode, l as toQueryString, o as toBasicQueryInputs, s as collectQueryParameters, u as applyVofficeFilterDerivedBasicQueryInputs } from "./client-
|
|
2
|
-
import { n as mapSearchQuery, r as searchQuery, w as parseVofficeUnitData } from "./operations-
|
|
3
|
-
import { a as toLocation, c as CAPACITY_DATA_ATTRIBUTES, i as toV9RentalHighlightKey, l as toCapacity, s as toImages, t as toRentalHighlights, u as toAddress } from "./to-rental-highlights-
|
|
1
|
+
import { a as makeV9CustomAttributeFilterCapabilities, c as parseQueryParameters, d as toVoucherCode, l as toQueryString, o as toBasicQueryInputs, s as collectQueryParameters, u as applyVofficeFilterDerivedBasicQueryInputs } from "./client-BlQ5phsZ.mjs";
|
|
2
|
+
import { n as mapSearchQuery, r as searchQuery, w as parseVofficeUnitData } from "./operations-Db2hRCLQ.mjs";
|
|
3
|
+
import { a as toLocation, c as CAPACITY_DATA_ATTRIBUTES, i as toV9RentalHighlightKey, l as toCapacity, s as toImages, t as toRentalHighlights, u as toAddress } from "./to-rental-highlights-BFLLKF6M.mjs";
|
|
4
4
|
import { CoreSDKError, STABLE_SEARCH_INPUTS, daysBetweenLocalDates, expandCustomAttributeFilterCompositions, parseChildrenAges, parseOccupancyCount, resolveExpandedCompositions, toFormattedSearchPrice, toIsoDateFromPeriodQueryDate, toStableSearchInputBackendQueryKeys, toStableSearchInputParameterValues, toStableSearchInputQueryKeys, toUnusedFilterKeys } from "@v-office/sdk-core";
|
|
5
5
|
import { Effect } from "effect";
|
|
6
6
|
//#region src/legacy-v9/parser/search/input/search-input-error.ts
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { v as VofficeUnitDataPropertyMetadata } from "./operations-
|
|
1
|
+
import { v as VofficeUnitDataPropertyMetadata } from "./operations-Db2hRCLQ.mjs";
|
|
2
2
|
import { localeToLanguage, makeTranslate, renderLabeledAttributeValue, renderResolvedCustomAttribute, toCountLabelKey, toCountry, toCustomAttributeFact, toFact, toLocalizedText, toRentalCapacity } from "@v-office/sdk-core";
|
|
3
3
|
import { Effect } from "effect";
|
|
4
4
|
//#region src/legacy-v9/parser/rentals/to-localized-string.ts
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
"quote.sections.tax": "Steuern & Abgaben",
|
|
5
5
|
"quote.additionalService.day": " / Tag",
|
|
6
6
|
"quote.additionalService.night": " / Nacht",
|
|
7
|
+
"quote.additionalService.free": "kostenlos",
|
|
7
8
|
"quote.status.unavailable.notBookable": "Nicht verfügbar",
|
|
8
9
|
"quote.optionCombination.unavailable": "Diese Optionskombination ist nicht verfügbar.",
|
|
9
10
|
"quote.voucher.applied": "Der Rabattcode wurde angewendet.",
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
"quote.sections.tax": "Taxes & Fees",
|
|
5
5
|
"quote.additionalService.day": " / day",
|
|
6
6
|
"quote.additionalService.night": " / night",
|
|
7
|
+
"quote.additionalService.free": "free",
|
|
7
8
|
"quote.status.unavailable.notBookable": "Not available",
|
|
8
9
|
"quote.optionCombination.unavailable": "This option combination is unavailable.",
|
|
9
10
|
"quote.voucher.applied": "The voucher code was applied.",
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
|
|
5
5
|
Release notes of `@v-office/website-sdk`, newest first. Each version has its own directory.
|
|
6
6
|
|
|
7
|
+
- `versions/3.3.0/CHANGELOG.md`: release notes for 3.3.0
|
|
8
|
+
- `versions/3.2.1/CHANGELOG.md`: release notes for 3.2.1
|
|
7
9
|
- `versions/3.2.0/CHANGELOG.md`: release notes for 3.2.0
|
|
8
10
|
- `versions/3.1.1/CHANGELOG.md`: release notes for 3.1.1
|
|
9
11
|
- `versions/3.1.0/CHANGELOG.md`: release notes for 3.1.0
|
|
@@ -4,6 +4,8 @@
|
|
|
4
4
|
|
|
5
5
|
Migration guides of `@v-office/website-sdk`, newest first. Apply them in order when skipping versions.
|
|
6
6
|
|
|
7
|
+
- `versions/3.3.0/MIGRATION.md`: Migration: 3.2.1 to 3.3.0
|
|
8
|
+
- `versions/3.2.1/MIGRATION.md`: Migration: 3.2.0 to 3.2.1
|
|
7
9
|
- `versions/3.2.0/MIGRATION.md`: Migration: 3.1.1 to 3.2.0
|
|
8
10
|
- `versions/3.1.1/MIGRATION.md`: Migration: 3.1.0 to 3.1.1
|
|
9
11
|
- `versions/3.1.0/MIGRATION.md`: Migration: 3.0.0 to 3.1.0
|
package/instructions/quote.md
CHANGED
|
@@ -315,6 +315,11 @@ them, and never replace them with descriptions or pictures written into the site
|
|
|
315
315
|
in the production hub at launch, or the live site shows the extras without them.
|
|
316
316
|
- `v10`: the PMS sends neither; additional services have a label and a price only.
|
|
317
317
|
|
|
318
|
+
A service priced at 0 (a free baby cot or high chair) is offered like any other. Its `charge` is
|
|
319
|
+
"kostenlos" ("free", translation key `quote.additionalService.free`) without a per-night or
|
|
320
|
+
per-day unit; selecting it leaves the total unchanged and books it with the stay. Show `charge` as
|
|
321
|
+
it is. A service whose price cannot be determined is not offered.
|
|
322
|
+
|
|
318
323
|
When the backend provides a line amount for an optional service, it is exposed as `proposedQuantity` (including `0`). By default this is informational only and is not added to the quote. Set `shouldAddProposedAdditionalServiceAmount: true` in `WebsiteSDKOptions` to automatically select proposed quantities greater than zero when the quote is created.
|
|
319
324
|
|
|
320
325
|
Use the service `id` to add or remove a service selection:
|
package/instructions/rentals.md
CHANGED
|
@@ -96,7 +96,7 @@ Sample item:
|
|
|
96
96
|
}
|
|
97
97
|
```
|
|
98
98
|
|
|
99
|
-
Optional fields include `scope`, `address`, `property`, `rooms`, `roomSummary`, `vicinity`, and `
|
|
99
|
+
Optional fields include `scope`, `address`, `property`, `rooms`, `roomSummary`, `vicinity`, `reviews`, and `links`.
|
|
100
100
|
|
|
101
101
|
### Texts in another language
|
|
102
102
|
|
|
@@ -182,6 +182,46 @@ count the backend does not state, or states as 0, is omitted, never 0.
|
|
|
182
182
|
|
|
183
183
|
Search items carry the same `capacity`.
|
|
184
184
|
|
|
185
|
+
### Links and 3D tours
|
|
186
|
+
|
|
187
|
+
`links` lists the links the agency keeps on the rental, each `{ type, url, language? }`.
|
|
188
|
+
`type` is `THREE_D` (a 3D tour, usually Matterport), `VIDEO`, `EXPOSE`, `HP` (the rental's
|
|
189
|
+
own website) or `OTHER`. `language` is the language the PMS states for the link, omitted when
|
|
190
|
+
it states none. The field is omitted when the rental has no link. Search items do not
|
|
191
|
+
carry `links`; read them from `getRentals` or the rental details.
|
|
192
|
+
|
|
193
|
+
```json
|
|
194
|
+
"links": [{ "type": "THREE_D", "url": "https://my.matterport.com/show/?m=ukGhLPgstJm" }]
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
Where the agency maintains a 3D tour:
|
|
198
|
+
|
|
199
|
+
| Backend | Where in the PMS |
|
|
200
|
+
| ------- | --------------------------------------------------------------------------------- |
|
|
201
|
+
| v10 | the rental's links, type "3D-Tour" |
|
|
202
|
+
| v9 | the unit's feature "Matterport ID" (general): the model ID or the Matterport link |
|
|
203
|
+
|
|
204
|
+
On v9 the SDK turns the Matterport ID into a `THREE_D` link and drops a value that is neither
|
|
205
|
+
a model ID nor an `https` Matterport link. v9 has no other link types. When a rental has no
|
|
206
|
+
tour, tell the agency where to maintain it instead of building a placeholder.
|
|
207
|
+
|
|
208
|
+
To show a tour on the rental page, add a button labelled "3D-Rundgang" / "3D tour" that opens
|
|
209
|
+
a modal with the tour. Render the iframe only once the modal opens, so the page does not load
|
|
210
|
+
Matterport for every visitor:
|
|
211
|
+
|
|
212
|
+
```html
|
|
213
|
+
<iframe
|
|
214
|
+
src="https://my.matterport.com/show/?m=ukGhLPgstJm"
|
|
215
|
+
title="3D-Rundgang"
|
|
216
|
+
allow="fullscreen; xr-spatial-tracking"
|
|
217
|
+
allowfullscreen
|
|
218
|
+
style="width: 100%; aspect-ratio: 16 / 9; border: 0"
|
|
219
|
+
></iframe>
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
Embed only URLs on `matterport.com`. Other providers often refuse to be framed: open their
|
|
223
|
+
`url` in a new tab (`target="_blank" rel="noopener"`).
|
|
224
|
+
|
|
185
225
|
### Legacy v9 Images
|
|
186
226
|
|
|
187
227
|
v9 rental `images` and facility `property.images` come from vOffice's image service
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Changelog: 3.2.1
|
|
2
|
+
|
|
3
|
+
Optional services priced at 0, such as a free baby cot or high chair, are offered as additional
|
|
4
|
+
services and read "kostenlos" ("free") instead of a price.
|
|
5
|
+
|
|
6
|
+
## Fixed
|
|
7
|
+
|
|
8
|
+
- v10: an optional service priced at 0 is in `quote.additionalServices`. Until now the quote
|
|
9
|
+
dropped it, and `addAdditionalService` rejected its id as unknown. Selecting it leaves the
|
|
10
|
+
total unchanged, and the booking sends it to the PMS like a paid one.
|
|
11
|
+
- v9 and v10: the `charge` of a free service is the translated `quote.additionalService.free`
|
|
12
|
+
("kostenlos", "free") instead of "0,00 €", without a per-night or per-day unit. v9 already
|
|
13
|
+
offered these services, with "0,00 €".
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# Migration: 3.2.0 to 3.2.1
|
|
2
|
+
|
|
3
|
+
No changes required. A site that renders `quote.additionalServices` shows the free services
|
|
4
|
+
without a change; one that hid "0,00 €" or wrote "free" itself can read `charge` as it is.
|
|
5
|
+
|
|
6
|
+
## 1. Upgrade
|
|
7
|
+
|
|
8
|
+
```sh
|
|
9
|
+
pnpm add @v-office/website-sdk@3.2.1
|
|
10
|
+
```
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Changelog: 3.3.0
|
|
2
|
+
|
|
3
|
+
A site can show a rental's 3D tour (Matterport) from one field on v9 and v10, and v9 no longer
|
|
4
|
+
lists the Matterport ID as an amenity.
|
|
5
|
+
|
|
6
|
+
## Added
|
|
7
|
+
|
|
8
|
+
- `links` on rentals and rental details: `{ type, url, language? }` per link, where `type` is
|
|
9
|
+
`THREE_D` (3D tour), `VIDEO`, `EXPOSE`, `HP` (the rental's own website) or `OTHER`. The field
|
|
10
|
+
is omitted when the rental has no link. Search items do not carry it.
|
|
11
|
+
- v10: the links of the rental in the PMS, as the PMS states them.
|
|
12
|
+
- v9: one `THREE_D` link from the unit's feature "Matterport ID". A model ID becomes
|
|
13
|
+
`https://my.matterport.com/show/?m=<id>`, a pasted `https` Matterport link is kept in
|
|
14
|
+
its normalized URL form (lowercase host, characters such as `"` percent-encoded),
|
|
15
|
+
any other value gives no link. v9 has no other link types.
|
|
16
|
+
- `rentals.md` ("Links and 3D tours"): where the agency maintains the tour on each backend and
|
|
17
|
+
how to show it as a "3D-Rundgang" button with a modal.
|
|
18
|
+
|
|
19
|
+
## Changed
|
|
20
|
+
|
|
21
|
+
- v9: the Matterport ID is no longer an attribute. `attributes` no longer has the item
|
|
22
|
+
"Matterport ID: …" and its fact with the key `matterport`; read the tour from `links`.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Migration: 3.2.1 to 3.3.0
|
|
2
|
+
|
|
3
|
+
No changes required.
|
|
4
|
+
|
|
5
|
+
## 1. Upgrade
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
pnpm add @v-office/website-sdk@3.3.0
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## 2. Optional: drop the Matterport filter on v9
|
|
12
|
+
|
|
13
|
+
A v9 site that removes the item "Matterport ID: …" or the fact with the key `matterport` from
|
|
14
|
+
its amenity list can drop that filter: `attributes` no longer contains either. Nothing else in
|
|
15
|
+
`attributes` changes.
|
|
16
|
+
|
|
17
|
+
## 3. Optional: show the 3D tour
|
|
18
|
+
|
|
19
|
+
Read the tour from `links` (`type === "THREE_D"`) and show it as described in `rentals.md`,
|
|
20
|
+
"Links and 3D tours": a "3D-Rundgang" button on the rental page that opens a modal with the
|
|
21
|
+
Matterport iframe. When a rental has no tour, the agency maintains it in the PMS: on v10 as a
|
|
22
|
+
link of type "3D-Tour", on v9 as the unit's feature "Matterport ID".
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@v-office/website-sdk",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.3.0",
|
|
4
4
|
"description": "Website-facing SDK facade backed by @v-office/sdk-core",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"repository": {
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
},
|
|
49
49
|
"dependencies": {
|
|
50
50
|
"@graphql-typed-document-node/core": "3.2.0",
|
|
51
|
-
"@v-office/sdk-core": "1.
|
|
51
|
+
"@v-office/sdk-core": "1.32.0",
|
|
52
52
|
"effect": "4.0.0-rc.115",
|
|
53
53
|
"graphql": "17.0.2",
|
|
54
54
|
"yaml": "^2.9.0"
|
|
@@ -91,7 +91,7 @@
|
|
|
91
91
|
"test:cli": "node --test src/cli/v9-hub-filters.test.ts",
|
|
92
92
|
"test:v9:openapi": "node --test codegen/v9/php-record.test.ts src/legacy-v9/openapi/setup-response.test.ts src/legacy-v9/openapi/quote-response.test.ts",
|
|
93
93
|
"test:v9:properties": "node --test codegen/v9/heuristic-generation/generate/property.test.ts src/legacy-v9/property-highlight-sources.test.ts src/legacy-v9/parser/rentals/render-property-attribute.test.ts src/legacy-v9/parser/rentals/to-property.test.ts src/legacy-v9/parser/rentals/to-rooms.test.ts src/legacy-v9/parser/rentals/to-capacity.test.ts",
|
|
94
|
-
"test:v9:rentals": "node --test src/legacy-v9/static/description-fallbacks.test.ts src/legacy-v9/static/associate-rentals-with-facilities-by-object-groups.test.ts src/legacy-v9/parser/rentals/to-reviews.test.ts src/legacy-v9/parser/rentals/to-image.test.ts",
|
|
94
|
+
"test:v9:rentals": "node --test src/legacy-v9/static/description-fallbacks.test.ts src/legacy-v9/static/associate-rentals-with-facilities-by-object-groups.test.ts src/legacy-v9/parser/rentals/to-reviews.test.ts src/legacy-v9/parser/rentals/to-image.test.ts src/legacy-v9/parser/rentals/to-links.test.ts",
|
|
95
95
|
"test:v9:graphql": "node --test src/legacy-v9/graphql/client.test.ts",
|
|
96
96
|
"test:v9:availability": "node --test src/legacy-v9/parser/availability/to-availability-restrictions-by-date.test.ts src/legacy-v9/parser/availability/to-initial-availability-calendar-days.test.ts src/legacy-v9/parser/availability/to-occupancy-limits.test.ts src/legacy-v9/parser/availability/to-rent-night-prices.test.ts src/legacy-v9/parser/availability/to-start-date-selected-calendar-days.test.ts src/legacy-v9/parser/blocked-ranges/collect-v9-blocked-ranges.test.ts src/legacy-v9/parser/blocked-ranges/to-rental-blocked-ranges.test.ts",
|
|
97
97
|
"test:v9:search": "node --test src/legacy-v9/parser/search/resolve-exact-match.test.ts src/legacy-v9/rental-scope.test.ts",
|