@roomle/embedding-lib 4.43.0-debug.1 → 4.44.0

package/.releaserc.json

@@ -3,7 +3,7 @@
   "repositoryUrl": "git@github.com:roomle-dev/roomle-ui.git",
   "branches": [
     {
-      "name": "ci/semantic-release-gh",
+      "name": "fix/semantic-release-build",
       "channel": "debug",
       "prerelease": "debug"
     },

package/docs/api/.nojekyll

@@ -0,0 +1 @@
+TypeDoc added this file to prevent GitHub Pages from using Jekyll. You can turn off this behavior by setting the `githubPages` option to false.

package/docs/api/README.md

@@ -0,0 +1,9 @@
+Embedding API Reference / [Modules](modules.md)
+
+# Overview
+
+The Embedding API reference does not contain every file/class used, but the interfaces used to communicate with the modules.
+
+## Init Data / Settings
+
+You can find all possible settings (init data) for the Embedding API in the [UiInitData](interfaces/types.UiInitData.md)

package/docs/api/classes/exposed_analytics_callbacks.ExposedAnalyticsCallbacks.md

@@ -0,0 +1,47 @@
+[Embedding API Reference](../README.md) / [Modules](../modules.md) / [exposed-analytics-callbacks](../modules/exposed_analytics_callbacks.md) / ExposedAnalyticsCallbacks
+
+# Class: ExposedAnalyticsCallbacks
+
+[exposed-analytics-callbacks](../modules/exposed_analytics_callbacks.md).ExposedAnalyticsCallbacks
+
+## Table of contents
+
+### Constructors
+
+- [constructor](exposed_analytics_callbacks.ExposedAnalyticsCallbacks.md#constructor)
+
+### Methods
+
+- [onGATracking](exposed_analytics_callbacks.ExposedAnalyticsCallbacks.md#ongatracking)
+
+## Constructors
+
+### constructor
+
+• **new ExposedAnalyticsCallbacks**()
+
+## Methods
+
+### onGATracking
+
+▸ **onGATracking**(...`_args`): `void`
+
+Is called whenever something is sent to google analytics
+Possible parameters are everything which is possible in gtag.js
+If you need further details about gtag.js: https://developers.google.com/gtagjs
+Currently we use Google Analytics in combination with gtag.js so
+you can intercept events and send them to your own analytics tool
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `..._args` | `any`[] |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-analytics-callbacks.ts:9](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-analytics-callbacks.ts#L9)

package/docs/api/classes/exposed_api.ExposedApi.md

@@ -0,0 +1,255 @@
+[Embedding API Reference](../README.md) / [Modules](../modules.md) / [exposed-api](../modules/exposed_api.md) / ExposedApi
+
+# Class: ExposedApi
+
+[exposed-api](../modules/exposed_api.md).ExposedApi
+
+## Table of contents
+
+### Constructors
+
+- [constructor](exposed_api.ExposedApi.md#constructor)
+
+### Accessors
+
+- [callbacks](exposed_api.ExposedApi.md#callbacks)
+
+### Methods
+
+- [giveGaConsent](exposed_api.ExposedApi.md#givegaconsent)
+- [insertObject](exposed_api.ExposedApi.md#insertobject)
+- [loadConfigurationString](exposed_api.ExposedApi.md#loadconfigurationstring)
+- [loadObject](exposed_api.ExposedApi.md#loadobject)
+- [pauseConfiguring](exposed_api.ExposedApi.md#pauseconfiguring)
+- [setPrice](exposed_api.ExposedApi.md#setprice)
+- [startConfiguring](exposed_api.ExposedApi.md#startconfiguring)
+- [triggerRequestPlan](exposed_api.ExposedApi.md#triggerrequestplan)
+- [triggerRequestProduct](exposed_api.ExposedApi.md#triggerrequestproduct)
+
+## Constructors
+
+### constructor
+
+• **new ExposedApi**(`sdkConnector`, `messageHandler`, `sdk`, `exposedCallbacks`, `store`, `analytics`, `globalCallback`)
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `sdkConnector` | `SdkConnector` |
+| `messageHandler` | null \| `MessageHandler` |
+| `sdk` | `default` \| `default` \| `default` |
+| `exposedCallbacks` | [`ExposedCallbacks`](exposed_callbacks.ExposedCallbacks.md) |
+| `store` | `Store`<`StoreState`\> |
+| `analytics` | `Analytics` |
+| `globalCallback` | `GlobalCallback` |
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:30](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L30)
+
+## Accessors
+
+### callbacks
+
+• `get` **callbacks**(): [`ExposedCallbacks`](exposed_callbacks.ExposedCallbacks.md)
+
+#### Returns
+
+[`ExposedCallbacks`](exposed_callbacks.ExposedCallbacks.md)
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:127](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L127)
+
+## Methods
+
+### giveGaConsent
+
+▸ **giveGaConsent**(): `void`
+
+call this method if consent of Google Analytics is given later and not already in init-data on boot
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:216](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L216)
+
+___
+
+### insertObject
+
+▸ **insertObject**(`id`, `position?`, `rotation?`): `Promise`<`void`\>
+
+Insert an object into the current MOC/planner scene
+If no position or rotation is set then it will be placed automatically (without overlapping other objects) with rotation 0
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `id` | `string` |  |
+| `position?` | `Position3` | as x (left/right), y (up/down) and z (front/back) |
+| `rotation?` | `number` | in radians |
+
+#### Returns
+
+`Promise`<`void`\>
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:231](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L231)
+
+___
+
+### loadConfigurationString
+
+▸ **loadConfigurationString**(`configurationString`): `Promise`<`Nullable`<`LoadResponse`\>\>
+
+call this method to load the configuration string you want into the 3d Scene
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `configurationString` | `string` | string of the configuration, starts with `{` and ends with `}` |
+
+#### Returns
+
+`Promise`<`Nullable`<`LoadResponse`\>\>
+
+null if configuration can not be loaded
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:147](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L147)
+
+___
+
+### loadObject
+
+▸ **loadObject**(`id`): `Promise`<`Nullable`<`LoadResponse`\>\>
+
+call this method to load the object you want into the 3d Scene
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `id` | `string` | database ID of the object you want to load |
+
+#### Returns
+
+`Promise`<`Nullable`<`LoadResponse`\>\>
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:135](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L135)
+
+___
+
+### pauseConfiguring
+
+▸ **pauseConfiguring**(): `void`
+
+This method can be used to pause configuration
+If the configurator was called in view-only mode
+this method triggers the onBackToWebsite callback.
+To know when the view-only mode is activated see the
+description of the startConfiguring method
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:184](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L184)
+
+___
+
+### setPrice
+
+▸ **setPrice**(`currencySymbol`, `price`): `void`
+
+set the price for the UI to show
+most likely needed when implementing your own price service
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `currencySymbol` | `string` |
+| `price` | `number` |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:161](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L161)
+
+___
+
+### startConfiguring
+
+▸ **startConfiguring**(): `void`
+
+This method can be used to start configuration when
+3d scene is only initialized as viewer first, the
+configurator is automatically instantiated as viewer
+if the container where the configurator is placed is
+smaller than 1024px (this breakpoint could change in future)
+so do not rely on this exact pixel setting
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:173](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L173)
+
+___
+
+### triggerRequestPlan
+
+▸ **triggerRequestPlan**(): `Promise`<`void`\>
+
+call this method to trigger the onRequestPlan event from
+outside of the iframe. When this method is called the same
+process is kicked off as if the user would have clicked on
+request plan. Therefore you can just use the same callback
+to react on the response
+
+#### Returns
+
+`Promise`<`void`\>
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:209](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L209)
+
+___
+
+### triggerRequestProduct
+
+▸ **triggerRequestProduct**(): `Promise`<`void`\>
+
+call this method to trigger the onRequestProduct event from
+outside of the iframe. When this method is called the same
+process is kicked off as if the user would have clicked on
+request product. Therefore you can just use the same callback
+to react on the response
+
+#### Returns
+
+`Promise`<`void`\>
+
+#### Defined in
+
+[src/configurator/embedding/exposed-api.ts:198](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-api.ts#L198)

package/docs/api/classes/exposed_callbacks.ExposedCallbacks.md

@@ -0,0 +1,195 @@
+[Embedding API Reference](../README.md) / [Modules](../modules.md) / [exposed-callbacks](../modules/exposed_callbacks.md) / ExposedCallbacks
+
+# Class: ExposedCallbacks
+
+[exposed-callbacks](../modules/exposed_callbacks.md).ExposedCallbacks
+
+## Table of contents
+
+### Constructors
+
+- [constructor](exposed_callbacks.ExposedCallbacks.md#constructor)
+
+### Methods
+
+- [onBackToWebsite](exposed_callbacks.ExposedCallbacks.md#onbacktowebsite)
+- [onButtonClicked](exposed_callbacks.ExposedCallbacks.md#onbuttonclicked)
+- [onPartListUpdate](exposed_callbacks.ExposedCallbacks.md#onpartlistupdate)
+- [onPlanUpdate](exposed_callbacks.ExposedCallbacks.md#onplanupdate)
+- [onRequestPlan](exposed_callbacks.ExposedCallbacks.md#onrequestplan)
+- [onRequestProduct](exposed_callbacks.ExposedCallbacks.md#onrequestproduct)
+- [onResize](exposed_callbacks.ExposedCallbacks.md#onresize)
+- [onUseFullPage](exposed_callbacks.ExposedCallbacks.md#onusefullpage)
+
+## Constructors
+
+### constructor
+
+• **new ExposedCallbacks**()
+
+## Methods
+
+### onBackToWebsite
+
+▸ **onBackToWebsite**(): `void`
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-callbacks.ts:40](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-callbacks.ts#L40)
+
+___
+
+### onButtonClicked
+
+▸ **onButtonClicked**(`name`): false \| true \| `void` \| `Promise`<`boolean`\>
+
+Gets called when a button in the UI is clicked
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `name` | [`UI_BUTTON`](../enums/types.UI_BUTTON.md) |
+
+#### Returns
+
+false \| true \| `void` \| `Promise`<`boolean`\>
+
+overrideEventBehaviour true if the event has been consumed and it should not trigger default behaviour, undefined or false otherwise
+
+#### Defined in
+
+[src/configurator/embedding/exposed-callbacks.ts:47](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-callbacks.ts#L47)
+
+___
+
+### onPartListUpdate
+
+▸ **onPartListUpdate**(`partList`, `hash`): `void`
+
+fullList fullList (needed for price calculation) of the current configuration
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `partList` | `KernelPartList` | the part list with all details, grouped, etc |
+| `hash` | `string` | - |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-callbacks.ts:34](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-callbacks.ts#L34)
+
+___
+
+### onPlanUpdate
+
+▸ **onPlanUpdate**(`objects`): `void`
+
+Gets called if a plan object gets added, changed or removed
+Only the move of plan object does NOT trigger this function
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `objects` | `UiPlanObject`[] |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-callbacks.ts:56](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-callbacks.ts#L56)
+
+___
+
+### onRequestPlan
+
+▸ **onRequestPlan**(`planId`, `image`, `items`): `void`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `planId` | `string` |
+| `image` | `Base64Image` |
+| `items` | `any`[] |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-callbacks.ts:49](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-callbacks.ts#L49)
+
+___
+
+### onRequestProduct
+
+▸ **onRequestProduct**(`configurationId`, `image`, `partList`, `price`, `labels`, `configuration`): `void`
+
+Returns all necessary params when 'Request Product'/'Checkout' button has pressed
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `configurationId` | `string` | id of the current configuration |
+| `image` | `Base64Image` | image of the current configuration |
+| `partList` | `KernelPartList` | the part list with all details, grouped, etc |
+| `price` | [`Price`](../interfaces/exposed_callbacks.Price.md) | price of the current configuration, either set via setPrice or from Roomle price service |
+| `labels` | [`Labels`](../interfaces/exposed_callbacks.Labels.md) | the label of the catalog and the furniture system |
+| `configuration` | `RapiConfigurationEnhanced` | the data returned from the Roomle backend |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-callbacks.ts:28](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-callbacks.ts#L28)
+
+___
+
+### onResize
+
+▸ **onResize**(`isDesktop`): `void`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `isDesktop` | `boolean` |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-callbacks.ts:36](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-callbacks.ts#L36)
+
+___
+
+### onUseFullPage
+
+▸ **onUseFullPage**(): `void`
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[src/configurator/embedding/exposed-callbacks.ts:38](https://github.com/roomle-dev/roomle-ui/blob/8222e2cc/src/configurator/embedding/exposed-callbacks.ts#L38)