From 0147af6de6a46aece736796aabc7dad8fa11e747 Mon Sep 17 00:00:00 2001
From: Oliver Kucharzewski <oliver.kucharzewski@nosto.com>
Date: Thu, 31 Oct 2024 16:19:50 +1100
Subject: [PATCH] Expose public types for ugc-widgets

---
 package.json                                |   4 +-
 src/widgets/components/index.ts             |   1 +
 src/widgets/components/ugc.component.ts     |   8 ++
 src/widgets/core/index.ts                   |   4 +
 src/widgets/core/placement.ts               |  56 ++++++++
 src/widgets/core/sdk.ts                     |  42 ++++++
 src/widgets/core/template.ts                |   4 +
 src/widgets/core/tile.ts                    | 138 ++++++++++++++++++++
 src/widgets/core/widget-request.ts          |  75 +++++++++++
 src/widgets/index.ts                        |   6 +-
 src/widgets/services/base.service.ts        |   9 ++
 src/widgets/services/event.service.ts       |  11 ++
 src/widgets/services/events/event-consts.ts |  49 +++++++
 src/widgets/services/events/tile-event.ts   |  19 +++
 src/widgets/services/events/widget-event.ts |  11 ++
 src/widgets/services/index.ts               |   7 +
 src/widgets/services/tiles.service.ts       |  37 ++++++
 src/widgets/services/widget.service.ts      |  19 +++
 src/widgets/types.ts                        |  20 +++
 src/widgets/widgets.ts                      |   4 +-
 tsconfig.json                               |   6 +-
 21 files changed, 522 insertions(+), 8 deletions(-)
 create mode 100644 src/widgets/components/index.ts
 create mode 100644 src/widgets/components/ugc.component.ts
 create mode 100644 src/widgets/core/index.ts
 create mode 100644 src/widgets/core/placement.ts
 create mode 100644 src/widgets/core/sdk.ts
 create mode 100644 src/widgets/core/template.ts
 create mode 100644 src/widgets/core/tile.ts
 create mode 100644 src/widgets/core/widget-request.ts
 create mode 100644 src/widgets/services/base.service.ts
 create mode 100644 src/widgets/services/event.service.ts
 create mode 100644 src/widgets/services/events/event-consts.ts
 create mode 100644 src/widgets/services/events/tile-event.ts
 create mode 100644 src/widgets/services/events/widget-event.ts
 create mode 100644 src/widgets/services/index.ts
 create mode 100644 src/widgets/services/tiles.service.ts
 create mode 100644 src/widgets/services/widget.service.ts
 create mode 100644 src/widgets/types.ts

diff --git a/package.json b/package.json
index 5e297c2..f84dea0 100644
--- a/package.json
+++ b/package.json
@@ -1,8 +1,8 @@
 {
   "name": "@stackla/public-types",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Public types for UGC Widgets",
-  "types": "dist/src/widgets/index.d.ts",
+  "types": "dist/widgets/index.d.ts",
   "repository": "https://github.com/Stackla/public-types",
   "publishConfig": {
     "registry": "https://npm.pkg.github.com/@stackla"
diff --git a/src/widgets/components/index.ts b/src/widgets/components/index.ts
new file mode 100644
index 0000000..5775e96
--- /dev/null
+++ b/src/widgets/components/index.ts
@@ -0,0 +1 @@
+export * from './ugc.component';
\ No newline at end of file
diff --git a/src/widgets/components/ugc.component.ts b/src/widgets/components/ugc.component.ts
new file mode 100644
index 0000000..1c73551
--- /dev/null
+++ b/src/widgets/components/ugc.component.ts
@@ -0,0 +1,8 @@
+import { IPlacement } from "../core/placement";
+
+export interface IUgcComponent extends HTMLElement {
+    placement?: IPlacement;
+    getShadowRoot(): ShadowRoot;
+    getPlacement(): IPlacement;
+    getWidgetService(): any;
+}
diff --git a/src/widgets/core/index.ts b/src/widgets/core/index.ts
new file mode 100644
index 0000000..820fe1f
--- /dev/null
+++ b/src/widgets/core/index.ts
@@ -0,0 +1,4 @@
+export * from './placement';
+export * from './sdk';
+export * from './tile';
+export * from './widget-request';
\ No newline at end of file
diff --git a/src/widgets/core/placement.ts b/src/widgets/core/placement.ts
new file mode 100644
index 0000000..7df3a63
--- /dev/null
+++ b/src/widgets/core/placement.ts
@@ -0,0 +1,56 @@
+import { ITransformedWidgetRequest } from "./widget-request";
+import { IUgcComponent } from "../components/ugc.component";
+import { ITilesService } from "../services/tiles.service";
+import { IEventService } from "../services/event.service";
+import { Template } from "../types";
+import { Config, ExpandedTileOptions, Style, WidgetOptions, WidgetResponse } from "../widgets";
+
+export interface IPlacement {
+    readonly selector: string;
+    readonly widgetContainer: WidgetResponse;
+    readonly widgetRequest: ITransformedWidgetRequest;
+    ugcComponent?: IUgcComponent;
+    tiles?: ITilesService;
+    sharedCssStyles: any; // Define a more specific type if possible
+    custom: any; // Define a more specific type if possible
+    events?: IEventService;
+    loadedComponents: string[];
+
+    attachServices(): void;
+    getStateFromGlobal(): any;
+    getEvents(): IEventService;
+    getLoadedComponents(): string[];
+    addLoadedComponent(component: string): void;
+    addLoadedComponents(components: string[]): void;
+    getSelector(): string;
+    getWidgetId(): string;
+    getNodeName(): string;
+    getWidgetContainer(): WidgetResponse;
+    updateWidgetOptionsProperties(mutatedWidgetOptions: Partial<WidgetOptions>): void;
+    updateWidgetStyle(mutatedStyle: Partial<Style>): void;
+    updateExpandedTileOptions(mutatedExpandedTileOptions: Partial<ExpandedTileOptions>): void;
+    updateWidgetConfig(mutatedConfig: Partial<Config>): void;
+    updateInlineTileOptions(mutatedInlineTileOptions: Partial<ExpandedTileOptions>): void;
+    updateFilterId(filterId: string): void;
+    getPluginsSettings(): Record<string, { config: Record<string, never> }>;
+    getElement(): Element;
+    attachUGC(): void;
+    loadComponents(): Promise<void>;
+    getTilesService(): ITilesService;
+    getAllTilesInDom(): any[] | NodeListOf<HTMLElement>;
+    getShadowRoot(): ShadowRoot;
+    querySelector<T extends Element = HTMLElement>(className: string): T;
+    querySelectorAll<T extends Element = HTMLElement>(className: string): NodeListOf<T>;
+    appendModuleScript(src: string): Promise<unknown>;
+    getRootCSSImports(): string[];
+    setRootCSSImports(content: string[]): void;
+    getCustomStyles(component: string): string[];
+    setCustomStyles(component: string, content: string): void;
+    getWidgetCustomStyles(): string[];
+    setWidgetCustomStyles(content: string): void;
+    hasSharedStyles(componentName: string): boolean;
+    setSharedCssCustomStyles(key: string, content: string, componentNames: string[]): void;
+    getSharedCssStyleSheets(componentName: string): CSSStyleSheet[];
+    getCustomTemplate(component: string): Template;
+    setCustomTemplate(component: string, template: Template): void;
+}
diff --git a/src/widgets/core/sdk.ts b/src/widgets/core/sdk.ts
new file mode 100644
index 0000000..3574d23
--- /dev/null
+++ b/src/widgets/core/sdk.ts
@@ -0,0 +1,42 @@
+import { IWidgetService } from "../services/widget.service";
+import { IPlacement } from "./placement";
+import { ITilesService } from "../services/tiles.service";
+import { IEventService } from "../services/event.service";
+import { EventMapping, EventName } from "../services/events/event-consts";
+import { ClaimConfig, ExpandedTileOptions, InlineTileOptions, Style, WidgetOptions, WidgetResponse } from "../widgets";
+
+type Template = (sdk: ISdk) => string | HTMLElement;
+
+export interface ISdk {
+    widget: IWidgetService;
+    placement: IPlacement;
+    events: IEventService;
+    tiles: ITilesService;
+
+    querySelector<T extends Element = HTMLElement>(selector: string): T;
+    querySelectorAll<T extends Element = HTMLElement>(selector: string): NodeListOf<T>;
+    getEmittedEvents(): EventName[];
+    getRegisteredEvents(): EventName[];
+    addEventListener<T extends EventName>(event: T, callback: (event: EventMapping[T]) => void, htmlSelector?: NodeListOf<Element> | Element): void;
+    triggerEvent<T extends EventName>(event: T, data?: object): void;
+    getWidgetContainer(): WidgetResponse;
+    getWidgetOptions(): WidgetOptions & {
+        plugins?: Record<string, { config: Record<string, never> }>;
+    };
+    addLoadedComponents(components: string[]): void;
+    getLoadedComponents(): string[];
+    isComponentLoaded(component: string): boolean;
+    addWidgetCustomStyles(content: string): void;
+    addSharedCssCustomStyles(key: string, content: string, componentNames: string[]): void;
+    addCSSImportUrl(url: string): Promise<void>;
+    addCSSToComponent(css: string, componentName: string): void;
+    addTemplateToComponent(template: Template, componentName: string): void;
+    setState(key: string, value: any): void;
+    getState(key: string): any;
+    getNodeId(): string;
+    loadTemplate(templateType: string): Promise<void>;
+    getExpandedTileConfig(): ExpandedTileOptions;
+    getInlineTileConfig(): InlineTileOptions;
+    getClaimTileConfig(): ClaimConfig;
+    getStyleConfig(): Style;
+}
diff --git a/src/widgets/core/template.ts b/src/widgets/core/template.ts
new file mode 100644
index 0000000..b7ecee5
--- /dev/null
+++ b/src/widgets/core/template.ts
@@ -0,0 +1,4 @@
+export interface ITemplateService {
+    loadTemplate(node: string | undefined, root: ShadowRoot | HTMLElement, templateType: string): Promise<unknown>;
+    getGlobalCSSTemplate(node: string | undefined, templateType: string): string;
+}
diff --git a/src/widgets/core/tile.ts b/src/widgets/core/tile.ts
new file mode 100644
index 0000000..3cfefa9
--- /dev/null
+++ b/src/widgets/core/tile.ts
@@ -0,0 +1,138 @@
+interface Variant {
+  id: string
+  availability: string
+  brand: string
+  condition: string
+  description: string
+  google_product_category: string
+  group: string
+  image_link: string
+  item_group_id: string
+  link: string
+  price: string
+  title: string
+  via_feed: number | null
+}
+
+export interface Video {
+  standard_resolution: {
+    url: string
+  }
+}
+
+export interface VideoFile {
+  url: string
+  mime: string
+  size: number
+  width: number
+  height: number
+  duration: number
+}
+
+export interface TagExtended {
+  active?: boolean
+  auto_apply?: boolean
+  availability: number
+  availability_status?: string
+  brand?: string
+  categories?: string
+  created_at?: string
+  cta_text?: string
+  currency?: string
+  custom_fields?: string
+  custom_slug?: string
+  custom_url: string
+  description?: string
+  ext_product_id?: string
+  id: string
+  image?: string
+  image_medium_height?: string
+  image_medium_url?: string
+  image_medium_width?: string
+  image_small_height?: string
+  image_small_url?: string
+  image_small_width?: string
+  ingested_at?: string
+  is_from_nosto?: number
+  lock_cta_text?: number
+  merchant_id?: string
+  migrated_from_variant?: number
+  original_price?: string
+  price: string
+  priority?: string
+  processed?: number
+  publicly_visible?: number
+  rm_id?: string
+  slug?: string
+  stack_id?: number
+  system_tag?: number
+  is_cross_seller: boolean
+  tag: string
+  tag_sanitized?: string
+  target?: string
+  tracking_tile_clicks?: string
+  tracking_tile_impressions?: string
+  type: string
+  ugc_update_required?: string
+  ugc_update_required_created_at?: string
+  updated_at?: string
+  variant?: Variant[]
+}
+
+export type Tile = {
+  id: string
+  preloaded?: boolean
+  _id?: { $id: string }
+  carousel: number
+  created_at: number
+  disabled: boolean
+  hotspots?: Hotspot[]
+  image: string
+  avatar: string
+  image_expire_at: number
+  lang_detection_type?: string
+  media: string
+  message: string
+  name: null | string
+  original_url: string
+  original_link: string
+  page_post: boolean
+  parent_url: string
+  queued: boolean
+  reviewed: boolean
+  scheduled: boolean
+  score: number
+  source: string
+  source_id: string
+  source_created_at: number
+  source_unique_id: string
+  stackla_sentiment_score: number
+  status: string
+  tags: string[]
+  tags_extended?: TagExtended[]
+  terms: string[]
+  updated_at: number
+  user: string
+  video: Video
+  video_files: VideoFile[]
+  original_image_url: string
+  embed_url: string
+  youtube_id: string
+  title: string
+  full_embed_html: string
+  attrs: string[]
+  [key: string]: undefined | object | null | string | string[] | number | number[] | boolean | TagExtended[]
+}
+
+export type Hotspot = {
+  id: number
+  x: number
+  y: number
+  width: number
+  height: number
+  type: string
+  custom_url: string
+  product_link_attribute: string
+  tag: TagExtended
+  coords: number[]
+} & TagExtended
diff --git a/src/widgets/core/widget-request.ts b/src/widgets/core/widget-request.ts
new file mode 100644
index 0000000..1faf3a7
--- /dev/null
+++ b/src/widgets/core/widget-request.ts
@@ -0,0 +1,75 @@
+type Template = {
+  display_name: string
+  html_id: string
+  mandatory: number
+  use_default_template: number
+  template: string
+  created: string
+  modified: string
+}
+
+type Templates = {
+  layout: Template
+  tile: Template
+}
+
+export type Draft = {
+  style?: string
+  config?: string | null
+  css?: string
+  filter_id?: number
+  custom_css?: string
+  lightbox_custom_css?: string
+  source_css?: string
+  lightbox_source_css?: string
+  use_default_css?: number
+  custom_js?: string
+  lightbox_custom_js?: string
+  use_default_js?: number
+  custom_tile?: string
+  external_js?: string
+  draft_id?: string
+  short_name?: string
+  custom_templates?: Templates
+  [key: string]: string | number | undefined | null | Templates | Record<string, never>
+}
+
+export default interface IWidgetRequest {
+  // TODO - Document new properties (draft,visible_tiles_count, uid);
+  // Allow uid if the user wants to differ 2 widgets with the same filter_id (i.e. preview mode)
+  uid?: string
+  visible_tiles_count?: number
+  draft?: Draft
+  hash?: string
+  wid?: string
+  filter_id: number
+  tags?: string
+  tag_group?: string
+  available_products_only?: boolean
+  limit?: number
+  page?: number
+  ttl?: number
+  visible_on?: string
+  domain?: string
+  tags_grouped_as?: string
+  data_tags?: string
+  brand?: string
+  categories?: string
+  fallbacks?: string
+  fallback_filter_id?: number
+  product_link_attribute?: string
+  search?: string
+  geohash?: string
+  tile_id?: string
+  style?: string
+  media?: string
+  exclude?: boolean
+  status?: string
+  filter?: string
+  [key: string]: string | boolean | number | Draft | undefined | null | Templates | Record<string, never>
+}
+
+export interface ITransformedWidgetRequest extends IWidgetRequest {
+  wid: string
+  hash?: string
+}
diff --git a/src/widgets/index.ts b/src/widgets/index.ts
index d1e8a27..b80105d 100644
--- a/src/widgets/index.ts
+++ b/src/widgets/index.ts
@@ -1 +1,5 @@
-export * from './widgets';
\ No newline at end of file
+export * from './widgets';
+export * from './types';
+export * from './components';
+export * from './core';
+export * from './services';
\ No newline at end of file
diff --git a/src/widgets/services/base.service.ts b/src/widgets/services/base.service.ts
new file mode 100644
index 0000000..ff905d7
--- /dev/null
+++ b/src/widgets/services/base.service.ts
@@ -0,0 +1,9 @@
+import { IPlacement } from "../core/placement";
+import { IEventService } from "./event.service";
+export declare abstract class IBaseService {
+    protected placement: IPlacement;
+    setState(key: string, value: any): void;
+    getState(key: string): any;
+    getPlacement(): IPlacement;
+    getEvents(): IEventService;
+}
diff --git a/src/widgets/services/event.service.ts b/src/widgets/services/event.service.ts
new file mode 100644
index 0000000..b3a9b06
--- /dev/null
+++ b/src/widgets/services/event.service.ts
@@ -0,0 +1,11 @@
+import { IBaseService } from "./base.service";
+import { EventMapping, EventName } from "./events/event-consts";
+
+export interface IEventService extends IBaseService {
+    listenOrFindEvent<T extends EventName>(eventType: T, callback: (event: EventMapping[T]) => void): void;
+    removeListeners(listenersForRemoval: EventName[], scope?: string): void;
+    addUgcEventListener<T extends EventName>(eventType: T, callback: (event: EventMapping[T]) => void, scope?: string): void;
+    getUniqueSelector(): string;
+    dispatchUgcEvent(event: CustomEvent, scope?: string): void;
+    getEmittedEvents(): EventName[];
+}
diff --git a/src/widgets/services/events/event-consts.ts b/src/widgets/services/events/event-consts.ts
new file mode 100644
index 0000000..8cee0d3
--- /dev/null
+++ b/src/widgets/services/events/event-consts.ts
@@ -0,0 +1,49 @@
+export declare const PRODUCT_ACTION_CLICK = "productActionClick";
+export declare const EXPANDED_TILE_IMAGE_LOAD = "expandedTileImageLoad";
+export declare const EXPANDED_TILE_OPEN = "expandedTileOpen";
+export declare const EXPANDED_TILE_CLOSE = "expandedTileClose";
+export declare const BEFORE_EXPANDED_TILE_IMAGE_RESIZE = "beforeExpandedTileImageResize";
+export declare const EXPANDED_TILE_IMAGE_RESIZE = "expandedTileImageResize";
+export declare const BEFORE_EXPANDED_TILE_CLOSE = "beforeExpandedTileClose";
+export declare const BEFORE_EXPANDED_TILE_OPEN = "beforeExpandedTileOpen";
+export declare const SHOPSPOT_FLYOUT_EXPAND = "shopspotFlyoutExpand";
+export declare const SHOPSPOT_TOGGLE = "shopspotToggle";
+export declare const SHOPSPOT_OPEN = "shopspotOpen";
+export declare const SHOPSPOT_ACTION_CLICK = "shopspotActionClick";
+export declare const USER_CLICK = "userClick";
+export declare const SHARE_CLICK = "shareClick";
+export declare const EVENT_IMPRESSION = "impression";
+export declare const EVENT_LOAD = "load";
+export declare const EVENT_LOAD_MORE = "moreLoad";
+export declare const EVENT_LIKE = "like";
+export declare const EVENT_DISLIKE = "dislike";
+export declare const EVENT_HOVER = "tileHover";
+export declare const EVENT_PRODUCT_CLICK = "productClick";
+export declare const EVENT_PRODUCT_PINCLICK = "pinClick";
+export declare const EVENT_TILE_EXPAND = "tileExpand";
+export declare const EVENT_PRODUCT_USER_CLICK = "userClick";
+export declare const EVENT_SHARE_CLICK = "shareClick";
+export declare const EVENT_SHOPSPOT_FLYOUT = "shopspotFlyout";
+export declare const EVENT_TILE_METADATA_LOADED = "tileMetadataLoaded";
+export declare const EVENT_TILE_DATA_SET = "tileDataSet";
+export declare const EVENT_HTML_RENDERED = "htmlRendered";
+export declare const EVENT_JS_RENDERED = "jsRendered";
+export declare const EVENT_GLOBALS_LOADED = "globalsLoaded";
+export declare const CROSS_SELLERS_LOADED = "crossSellersLoaded";
+export declare const EVENT_PRODUCT_PAGE_LOADED = "productPageLoaded";
+export declare const EVENT_PRODUCTS_UPDATED = "productsUpdated";
+export declare const EVENT_ADD_TO_CART_FAILED = "addToCartFailed";
+export declare const EVENT_TILES_UPDATED = "tilesUpdated";
+export declare const WIDGET_INIT_COMPLETE = "widgetInitComplete";
+export declare const EMAIL_TILE_LOAD = "emailTileLoad";
+export declare const EMAIL_TILE_CLICK = "emailTileClick";
+export declare const LIKE_CLICK = "likeClick";
+export declare const DISLIKE_CLICK = "dislikeClick";
+export declare const EVENT_TILE_EXPAND_RENDERED = "tileExpandRendered";
+export declare const EVENT_TILE_EXPAND_PROD_RECS_RENDERED = "tileExpandProductRecsRendered";
+export declare const EVENT_TILE_EXPAND_CROSS_SELLERS_RENDERED = "tileExpandCrossSellersRendered";
+export declare const EVENT_TILE_BG_IMG_RENDER_COMPLETE = "tileBgImgRenderComplete";
+export declare const EVENT_TILE_BG_IMG_RENDERED = "tileBgImgRendered";
+export declare const allEvents: string[];
+export type EventName = (typeof allEvents)[number];
+export type EventMapping = Record<EventName, Event>;
diff --git a/src/widgets/services/events/tile-event.ts b/src/widgets/services/events/tile-event.ts
new file mode 100644
index 0000000..548b138
--- /dev/null
+++ b/src/widgets/services/events/tile-event.ts
@@ -0,0 +1,19 @@
+import { Tile } from "../../core/tile";
+
+export interface ProductTag {
+  id: string
+  ext_product_id: string
+}
+
+export interface ITileEventData {
+  tileData: Tile
+  widgetId: string
+  filterId?: string
+  shareNetwork?: string
+  locationId?: string
+  locationName?: string
+  nostoUgcLocationId?: string
+  nostoUgcLocationName?: string
+  productTag?: ProductTag
+  [key: string]: unknown
+}
diff --git a/src/widgets/services/events/widget-event.ts b/src/widgets/services/events/widget-event.ts
new file mode 100644
index 0000000..0eb4afe
--- /dev/null
+++ b/src/widgets/services/events/widget-event.ts
@@ -0,0 +1,11 @@
+import { ITileEventData } from "./tile-event"
+
+export interface WidgetData {
+  widgetId: string
+}
+
+export interface IWidgetEvent extends CustomEvent {
+  detail: {
+    data: ITileEventData
+  }
+}
diff --git a/src/widgets/services/index.ts b/src/widgets/services/index.ts
new file mode 100644
index 0000000..77c655d
--- /dev/null
+++ b/src/widgets/services/index.ts
@@ -0,0 +1,7 @@
+export * from './base.service';
+export * from './event.service';
+export * from './tiles.service';
+export * from './widget.service';
+export * from './events/event-consts';
+export * from './events/tile-event';
+export * from './events/widget-event';
\ No newline at end of file
diff --git a/src/widgets/services/tiles.service.ts b/src/widgets/services/tiles.service.ts
new file mode 100644
index 0000000..deddd4a
--- /dev/null
+++ b/src/widgets/services/tiles.service.ts
@@ -0,0 +1,37 @@
+import { TagExtended, Tile } from "../core/tile";
+import { IBaseService } from "./base.service";
+
+export interface ITilesService extends IBaseService {
+    page: number;
+    visibleTilesCount: number;
+    tiles: Record<string, Tile>;
+    trashedTiles: Record<string, boolean>;
+    selectedProductId?: string;
+    hideBrokenTiles: boolean;
+    preloadImages: boolean;
+
+    loadTilesUntilVisibleTilesCount(): Promise<void>;
+    getTotalTilesCount(): number;
+    enableAutoAddNewTiles(): void;
+    disableAutoAddNewTiles(): void;
+    setVisibleTilesCount(visibleTilesCount: number): void;
+    postRender(): Promise<void>;
+    loadMore(limit?: number): Promise<void>;
+    hasMorePages(): boolean;
+    hasMoreTiles(): boolean;
+    getLoadedTilesCount(): number;
+    getVisibleTilesInDomCount(): number;
+    searchTiles(query: string): Promise<any>;
+    fetchAllTiles(): Promise<any>;
+    fetchTile(tileId: string): Promise<any>;
+    fetchTiles(page?: number, limit?: number): Promise<void>;
+    getPage(): number;
+    setTile(tile: Tile): void;
+    clearTile(): void;
+    getTile(tileId?: string): Tile | undefined;
+    getProductById(productId: string): TagExtended;
+    getSelectedProduct(): TagExtended;
+    setSelectedProductId(productId: string): void;
+    addProducts(products: TagExtended[]): void;
+    getShopspotsFromTile(tileId?: string): Promise<TagExtended[]>;
+}
diff --git a/src/widgets/services/widget.service.ts b/src/widgets/services/widget.service.ts
new file mode 100644
index 0000000..2f25991
--- /dev/null
+++ b/src/widgets/services/widget.service.ts
@@ -0,0 +1,19 @@
+// widget-service.interface.ts
+
+import { WidgetResponse } from "../widgets";
+import { ISdk, ITransformedWidgetRequest } from "../core";
+import { ITilesService } from "./tiles.service";
+import { IBaseService } from "./base.service";
+
+export interface IWidgetService extends IBaseService {
+    state: Record<string, any>;
+    tiles: ITilesService | undefined;
+    setSdk(sdk: ISdk): void;
+    getSdk(): ISdk;
+    getWidgetBySelector(selector?: string): any;
+    init(): Promise<IWidgetService>;
+    executeOnLoad(callback: () => void): Promise<void>;
+    getTilesService(): ITilesService;
+    fetchWidgetFromApi(widgetRequest: ITransformedWidgetRequest): Promise<WidgetResponse>;
+    fetchDraftFromApi(widgetRequest: ITransformedWidgetRequest): Promise<WidgetResponse>;
+}
diff --git a/src/widgets/types.ts b/src/widgets/types.ts
new file mode 100644
index 0000000..4d794bb
--- /dev/null
+++ b/src/widgets/types.ts
@@ -0,0 +1,20 @@
+import { ISdk } from "./core/sdk"
+export type MaybePromise<T> = Promise<T> | T
+export type Maybe<T> = NonNullable<T> | undefined
+export type MaybeArray<T> = T | T[]
+
+type HTMLResult = string | HTMLElement
+export type Template = (sdk: ISdk) => HTMLResult
+
+// TODO fix any type usage
+export type RenderHTML = (sdk: ISdk, component?: any) => MaybePromise<HTMLResult>
+
+export type AnalyticsOptions = {
+  domains: string[]
+  trackingIds: string | string[]
+  selectedTrackingId: string | string[]
+}
+
+export type Analytics = AnalyticsOptions & {
+  track?: (event: string, data: Record<string, unknown>) => void
+}
diff --git a/src/widgets/widgets.ts b/src/widgets/widgets.ts
index 9106395..3de61fc 100644
--- a/src/widgets/widgets.ts
+++ b/src/widgets/widgets.ts
@@ -172,7 +172,7 @@ export interface Assets {}
 
 export interface CustomTemplates {
   layout: Layout;
-  tile: Tile;
+  tile: TileInfo;
 }
 
 export interface Layout {
@@ -185,7 +185,7 @@ export interface Layout {
   modified: string;
 }
 
-export interface Tile {
+export interface TileInfo {
   display_name: string;
   html_id: string;
   mandatory: number;
diff --git a/tsconfig.json b/tsconfig.json
index 338ab88..c7b75ca 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -4,7 +4,7 @@
     "target": "es2020",
     "module": "commonjs",
     "lib": ["es2019", "es2021", "DOM", "DOM.Iterable", "dom"],
-    "rootDir": ".",
+    "rootDir": "./src",
     "outDir": "./dist",
     "declaration": true,
     "declarationMap": true,
@@ -23,8 +23,8 @@
     "forceConsistentCasingInFileNames": true,
     "noImplicitOverride": true,
     "esModuleInterop": true,
-    "skipLibCheck": true,
     "resolveJsonModule": true
   },
-  "exclude": ["node_modules"]
+  "exclude": ["node_modules"],
+  "include": ["src/**/*.ts", "src/**/*.d.ts"]
 }
\ No newline at end of file