tst.stan.xbe.shared2 0.0.1

package/dist/xbe-lib/src/component-props/index.d.ts

@@ -0,0 +1,55 @@
+import { ComponentParams, ComponentRendering, NextjsContentSdkComponent, Page } from '@sitecore-content-sdk/nextjs';
+/**
+ * Props passed to components rendered through Sitecore JSS.
+ *
+ * @property rendering - The component rendering data from Sitecore, including fields and placeholders
+ * @property params - Component parameters configured in Sitecore, extended with rendering-specific properties
+ * @property page - The current page context and data
+ *
+ * @example
+ * ```typescript
+ * const MyComponent: React.FC<ComponentProps> = ({ rendering, params, page }) => {
+ *   return <div style={params.styles}>{rendering.fields.title}</div>;
+ * };
+ * ```
+ */
+export type ComponentProps = {
+    rendering: ComponentRendering;
+    params: ComponentParams & {
+        /**
+         * The identifier for the rendering
+         */
+        RenderingIdentifier?: string;
+        /**
+         * The styles for the rendering
+         * This value is calculated by the Placeholder component
+         */
+        styles?: string;
+        /**
+         * The enabled placeholders for the rendering
+         */
+        EnabledPlaceholders?: string;
+        DynamicPlaceholderId?: string;
+    };
+    page: Page;
+    componentMap: Map<string, NextjsContentSdkComponent>;
+};
+/**
+ * Represents the props for a component that includes page context information.
+ *
+ * @remarks
+ * This type extends the base `ComponentProps` with additional page context,
+ * allowing components to access page-level data and configuration.
+ *
+ * @example
+ * ```typescript
+ * const MyComponent: React.FC<ComponentWithContextProps> = ({ page, ...props }) => {
+ *   // Access page context and component props
+ *   return <div>{page.title}</div>;
+ * };
+ * ```
+ */
+export type ComponentWithContextProps = ComponentProps & {
+    page: Page;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/xbe-lib/src/component-props/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../xbe-lib/src/component-props/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGpH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,eAAe,GAAG;QACxB;;WAEG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B;;;WAGG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;WAEG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,yBAAyB,GAAG,cAAc,GAAG;IACvD,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC"}

package/dist/xbe-lib/src/component-props/index.js

@@ -0,0 +1 @@
+export {};

package/dist/xbe-lib/src/index.d.ts

@@ -0,0 +1,8 @@
+export * from './component-props';
+export * from './middleware';
+export * from './services';
+export * from './sitecore/SitecoreConfigLoader';
+export * from './sitecore/createSitecoreClient';
+export * from './sitecore/fetchComponentData';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/xbe-lib/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../xbe-lib/src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,SAAS,CAAC"}

package/dist/xbe-lib/src/index.js

@@ -0,0 +1,7 @@
+export * from './component-props';
+export * from './middleware';
+export * from './services';
+export * from './sitecore/SitecoreConfigLoader';
+export * from './sitecore/createSitecoreClient';
+export * from './sitecore/fetchComponentData';
+export * from './utils';

package/dist/xbe-lib/src/middleware/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/xbe-lib/src/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../xbe-lib/src/middleware/index.ts"],"names":[],"mappings":""}

package/dist/xbe-lib/src/middleware/index.js

@@ -0,0 +1,3 @@
+export {};
+// Middleware exports - Edge Runtime compatible only
+// XBEHttpHeadersMiddleware has been moved to @repo/xbe-lib-httpheaders

package/dist/xbe-lib/src/services/CacheService/InMemoryCacheProvider.d.ts

@@ -0,0 +1,26 @@
+import type { CacheService } from './index';
+/**
+ * An in-memory cache provider implementation that stores cached items with time-to-live (TTL) expiration.
+ *
+ * @remarks
+ * This cache provider uses a static Map to store cache entries across all instances. Each entry
+ * contains a value and an expiration timestamp. Expired entries are automatically removed when
+ * accessed or during enumeration.
+ *
+ * @typeParam T - The type of values stored in the cache
+ *
+ * @example
+ * ```typescript
+ * const cache = new InMemoryCacheProvider<string>();
+ * await cache.set('myKey', 'myValue', 60000); // Cache for 60 seconds
+ * const value = await cache.get('myKey');
+ * ```
+ */
+export declare class InMemoryCacheProvider<T> implements CacheService<T> {
+    private static cache;
+    get(key: string): Promise<T | undefined>;
+    set(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    getEntries(): Promise<[string, T][]>;
+}
+//# sourceMappingURL=InMemoryCacheProvider.d.ts.map

package/dist/xbe-lib/src/services/CacheService/InMemoryCacheProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCacheProvider.d.ts","sourceRoot":"","sources":["../../../../../../xbe-lib/src/services/CacheService/InMemoryCacheProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAqB,CAAC,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAsD;IAEpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAUxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,SAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,UAAU,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;CAa7C"}

package/dist/xbe-lib/src/services/CacheService/InMemoryCacheProvider.js

@@ -0,0 +1,50 @@
+// Example in-memory fallback (not Edge-compatible, but useful for local/dev)
+/**
+ * An in-memory cache provider implementation that stores cached items with time-to-live (TTL) expiration.
+ *
+ * @remarks
+ * This cache provider uses a static Map to store cache entries across all instances. Each entry
+ * contains a value and an expiration timestamp. Expired entries are automatically removed when
+ * accessed or during enumeration.
+ *
+ * @typeParam T - The type of values stored in the cache
+ *
+ * @example
+ * ```typescript
+ * const cache = new InMemoryCacheProvider<string>();
+ * await cache.set('myKey', 'myValue', 60000); // Cache for 60 seconds
+ * const value = await cache.get('myKey');
+ * ```
+ */
+export class InMemoryCacheProvider {
+    static cache = new Map();
+    async get(key) {
+        const entry = InMemoryCacheProvider.cache.get(key);
+        if (!entry)
+            return undefined;
+        if (entry.expires < Date.now()) {
+            InMemoryCacheProvider.cache.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    async set(key, value, ttlMs = 5 * 60 * 1000) {
+        InMemoryCacheProvider.cache.set(key, { value, expires: Date.now() + ttlMs });
+    }
+    async delete(key) {
+        InMemoryCacheProvider.cache.delete(key);
+    }
+    async getEntries() {
+        const entries = [];
+        const now = Date.now();
+        for (const [key, entry] of InMemoryCacheProvider.cache.entries()) {
+            if (entry.expires >= now) {
+                entries.push([key, entry.value]);
+            }
+            else {
+                InMemoryCacheProvider.cache.delete(key);
+            }
+        }
+        return entries;
+    }
+}

package/dist/xbe-lib/src/services/CacheService/VercelEdgeCacheService.d.ts

@@ -0,0 +1,26 @@
+import type { CacheService } from './index';
+/**
+ * Cache provider implementation using Vercel Edge Config for storage.
+ *
+ * @remarks
+ * This provider is designed to work with Vercel's Edge Config API for distributed caching
+ * at the edge. Note that write operations (set/delete) typically require backend/admin API access.
+ *
+ * @typeParam T - The type of values stored in the cache
+ *
+ * @example
+ * ```typescript
+ * const cache = new VercelEdgeCacheProvider<string>();
+ * const value = await cache.get('myKey');
+ * await cache.set('myKey', 'myValue', 3600000);
+ * ```
+ *
+ * @see {@link CacheService} for the interface implementation details
+ */
+export declare class VercelEdgeCacheProvider<T> implements CacheService<T> {
+    get(key: string): Promise<T | undefined>;
+    set(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    getEntries(): Promise<[string, T][]>;
+}
+//# sourceMappingURL=VercelEdgeCacheService.d.ts.map

package/dist/xbe-lib/src/services/CacheService/VercelEdgeCacheService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VercelEdgeCacheService.d.ts","sourceRoot":"","sources":["../../../../../../xbe-lib/src/services/CacheService/VercelEdgeCacheService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAuB,CAAC,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAKxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,UAAU,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;CAI7C"}

package/dist/xbe-lib/src/services/CacheService/VercelEdgeCacheService.js

@@ -0,0 +1,37 @@
+// Skeleton voor Vercel Edge Config cache service
+// Zie: https://vercel.com/docs/storage/edge-config/sdk
+/**
+ * Cache provider implementation using Vercel Edge Config for storage.
+ *
+ * @remarks
+ * This provider is designed to work with Vercel's Edge Config API for distributed caching
+ * at the edge. Note that write operations (set/delete) typically require backend/admin API access.
+ *
+ * @typeParam T - The type of values stored in the cache
+ *
+ * @example
+ * ```typescript
+ * const cache = new VercelEdgeCacheProvider<string>();
+ * const value = await cache.get('myKey');
+ * await cache.set('myKey', 'myValue', 3600000);
+ * ```
+ *
+ * @see {@link CacheService} for the interface implementation details
+ */
+export class VercelEdgeCacheProvider {
+    async get(key) {
+        // TODO: Implementeer ophalen uit Vercel Edge Config
+        throw new Error('VercelEdgeCacheService.get not implemented');
+    }
+    async set(key, value, ttlMs) {
+        // TODO: Implementeer schrijven naar Vercel Edge Config (let op: meestal alleen via backend/admin API mogelijk)
+        throw new Error('VercelEdgeCacheService.set not implemented');
+    }
+    async delete(key) {
+        // TODO: Implementeer verwijderen uit Vercel Edge Config (optioneel, afhankelijk van API)
+        throw new Error('VercelEdgeCacheService.delete not implemented');
+    }
+    async getEntries() {
+        throw new Error('Method not implemented.');
+    }
+}

package/dist/xbe-lib/src/services/CacheService/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A generic cache service interface for storing and retrieving values with optional time-to-live (TTL).
+ *
+ * @template T - The type of values stored in the cache
+ *
+ * @example
+ * ```typescript
+ * const cache: CacheService<User> = new MyCacheImplementation();
+ * await cache.set('user:123', userData, 60000); // Cache for 60 seconds
+ * const user = await cache.get('user:123');
+ * ```
+ */
+export interface CacheService<T> {
+    get(key: string): Promise<T | undefined>;
+    set(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete?(key: string): Promise<void>;
+    getEntries(): Promise<[string, T][]>;
+}
+/**
+ * Enumeration of available cache provider types.
+ *
+ * @remarks
+ * This enum defines the supported cache storage mechanisms that can be used
+ * by the CacheService to store and retrieve cached data.
+ *
+ * @enum {string}
+ *
+ * @property {string} Memory - In-memory cache storage (non-persistent)
+ * @property {string} Vercel - Vercel KV storage for distributed caching
+ */
+export declare enum CacheProviderType {
+    Memory = "memory",
+    Vercel = "vercel"
+}
+/**
+ * Creates and returns a cache service instance of the specified provider type.
+ *
+ * @template T - The type of data that will be cached by the service
+ * @param {CacheProviderType} [type=CacheProviderType.Memory] - The type of cache provider to instantiate. Defaults to Memory provider.
+ * @returns {CacheService<T>} A new instance of the specified cache service provider
+ * @throws {Error} Throws an error if the specified provider type is not registered in the provider registry
+ *
+ * @example
+ * ```typescript
+ * // Create a memory cache provider
+ * const memoryCache = getCacheProvider<string>();
+ *
+ * // Create a specific cache provider
+ * const redisCache = getCacheProvider<User>(CacheProviderType.Redis);
+ * ```
+ */
+export declare function getCacheProvider<T>(type?: CacheProviderType): CacheService<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/xbe-lib/src/services/CacheService/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../xbe-lib/src/services/CacheService/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,UAAU,IAAK,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;GAWG;AACH,oBAAY,iBAAiB;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;CACpB;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,GAAE,iBAA4C,GAAG,YAAY,CAAC,CAAC,CAAC,CAIvG"}

package/dist/xbe-lib/src/services/CacheService/index.js

@@ -0,0 +1,55 @@
+import { InMemoryCacheProvider } from './InMemoryCacheProvider';
+import { VercelEdgeCacheProvider } from './VercelEdgeCacheService';
+/**
+ * Enumeration of available cache provider types.
+ *
+ * @remarks
+ * This enum defines the supported cache storage mechanisms that can be used
+ * by the CacheService to store and retrieve cached data.
+ *
+ * @enum {string}
+ *
+ * @property {string} Memory - In-memory cache storage (non-persistent)
+ * @property {string} Vercel - Vercel KV storage for distributed caching
+ */
+export var CacheProviderType;
+(function (CacheProviderType) {
+    CacheProviderType["Memory"] = "memory";
+    CacheProviderType["Vercel"] = "vercel";
+})(CacheProviderType || (CacheProviderType = {}));
+/**
+ * Registry mapping cache provider types to their corresponding implementation classes.
+ *
+ * @remarks
+ * This registry is used to dynamically instantiate the appropriate cache provider
+ * based on the specified {@link CacheProviderType}.
+ *
+ * @internal
+ */
+const providerRegistry = {
+    [CacheProviderType.Memory]: InMemoryCacheProvider,
+    [CacheProviderType.Vercel]: VercelEdgeCacheProvider,
+};
+/**
+ * Creates and returns a cache service instance of the specified provider type.
+ *
+ * @template T - The type of data that will be cached by the service
+ * @param {CacheProviderType} [type=CacheProviderType.Memory] - The type of cache provider to instantiate. Defaults to Memory provider.
+ * @returns {CacheService<T>} A new instance of the specified cache service provider
+ * @throws {Error} Throws an error if the specified provider type is not registered in the provider registry
+ *
+ * @example
+ * ```typescript
+ * // Create a memory cache provider
+ * const memoryCache = getCacheProvider<string>();
+ *
+ * // Create a specific cache provider
+ * const redisCache = getCacheProvider<User>(CacheProviderType.Redis);
+ * ```
+ */
+export function getCacheProvider(type = CacheProviderType.Memory) {
+    const ProviderClass = providerRegistry[type];
+    if (!ProviderClass)
+        throw new Error(`Unknown cache provider: ${type}`);
+    return new ProviderClass();
+}

package/dist/xbe-lib/src/services/NavigationService/NavigationService.d.ts

@@ -0,0 +1,61 @@
+import { SitecoreClient } from '@sitecore-content-sdk/core/client';
+import { NavigationGroup } from './models';
+export type { NavigationDataSourceResponse, NavigationGroup, NavigationDropdown, NavigationFolder, NavigationItem, NavigationCTA, TextField, LinkField, ItemSearchResults, } from './models';
+/**
+ * Configuration options for the NavigationService.
+ *
+ * @remarks
+ * This configuration type is used to initialize the NavigationService with the necessary
+ * dependencies required for navigation operations.
+ *
+ * @property client - The Sitecore client instance used to communicate with the Sitecore GraphQL API.
+ * @property language - The default language to use for navigation queries. Defaults to 'en'.
+ */
+export type NavigationServiceConfig = {
+    client: SitecoreClient;
+    language?: string;
+};
+/**
+ * Service for fetching navigation data from Sitecore through GraphQL.
+ *
+ * This service provides methods to query and retrieve navigation structures from Sitecore,
+ * including multi-level navigation hierarchies with dropdowns, folders, and navigation items.
+ *
+ * @example
+ * ```typescript
+ * const navService = new NavigationService({ client: sitecoreClient, language: 'en' });
+ * const navigation = await navService.fetchNavigation('/sitecore/content/site/navigation/main');
+ * ```
+ */
+export declare class NavigationService {
+    private client;
+    private language;
+    constructor(config: NavigationServiceConfig);
+    /**
+     * Fetches navigation data from Sitecore for a given datasource path.
+     *
+     * @param datasource - The Sitecore item path or ID of the navigation datasource
+     * @param language - Optional language override. If not provided, uses the language from the service config
+     * @returns A promise that resolves to the NavigationGroup data structure. Returns an empty NavigationGroup if no datasource provided or no data returned
+     *
+     * @remarks
+     * This method queries the Sitecore GraphQL endpoint to retrieve a hierarchical navigation structure.
+     * The structure includes navigation groups, dropdowns, folders, and individual navigation items.
+     * The query is optimized to limit complexity by restricting the number of items at each level.
+     * If no datasource is provided or no data is returned, this method logs an error and returns an empty NavigationGroup.
+     */
+    fetchNavigation(datasource: string, language?: string): Promise<NavigationGroup>;
+    /**
+     * Updates the default language used for navigation queries.
+     *
+     * @param language - The new default language code (e.g., 'en', 'nl', 'de')
+     */
+    setLanguage(language: string): void;
+    /**
+     * Gets the current default language setting.
+     *
+     * @returns The current language code
+     */
+    getLanguage(): string;
+}
+//# sourceMappingURL=NavigationService.d.ts.map

package/dist/xbe-lib/src/services/NavigationService/NavigationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationService.d.ts","sourceRoot":"","sources":["../../../../../../xbe-lib/src/services/NavigationService/NavigationService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAgC,eAAe,EAAE,MAAM,UAAU,CAAC;AAKzE,YAAY,EACR,4BAA4B,EAC5B,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,SAAS,EACT,SAAS,EACT,iBAAiB,GACpB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;GASG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,uBAAuB;IAK3C;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA2CtF;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC;;;;OAIG;IACH,WAAW,IAAI,MAAM;CAGxB"}

package/dist/xbe-lib/src/services/NavigationService/NavigationService.js

@@ -0,0 +1,82 @@
+import { QueryNavigationDataSource } from './queries/navigation-datasource.graphql';
+/**
+ * Service for fetching navigation data from Sitecore through GraphQL.
+ *
+ * This service provides methods to query and retrieve navigation structures from Sitecore,
+ * including multi-level navigation hierarchies with dropdowns, folders, and navigation items.
+ *
+ * @example
+ * ```typescript
+ * const navService = new NavigationService({ client: sitecoreClient, language: 'en' });
+ * const navigation = await navService.fetchNavigation('/sitecore/content/site/navigation/main');
+ * ```
+ */
+export class NavigationService {
+    client;
+    language;
+    constructor(config) {
+        this.client = config.client;
+        this.language = config.language || 'en';
+    }
+    /**
+     * Fetches navigation data from Sitecore for a given datasource path.
+     *
+     * @param datasource - The Sitecore item path or ID of the navigation datasource
+     * @param language - Optional language override. If not provided, uses the language from the service config
+     * @returns A promise that resolves to the NavigationGroup data structure. Returns an empty NavigationGroup if no datasource provided or no data returned
+     *
+     * @remarks
+     * This method queries the Sitecore GraphQL endpoint to retrieve a hierarchical navigation structure.
+     * The structure includes navigation groups, dropdowns, folders, and individual navigation items.
+     * The query is optimized to limit complexity by restricting the number of items at each level.
+     * If no datasource is provided or no data is returned, this method logs an error and returns an empty NavigationGroup.
+     */
+    async fetchNavigation(datasource, language) {
+        const emptyNavigationGroup = {
+            closeIconName: { value: '', __typename: 'TextField' },
+            openIconName: { value: '', __typename: 'TextField' },
+            level1: { results: [], __typename: 'ItemSearchResults' },
+            __typename: 'XBE_Navigation_Group'
+        };
+        if (!datasource) {
+            console.error('[NavigationService.fetchNavigation] No datasource provided.');
+            return emptyNavigationGroup;
+        }
+        const queryLanguage = language || this.language;
+        try {
+            console.log(`[NavigationService.fetchNavigation] Fetching with datasource: ${datasource}, language: ${queryLanguage}`);
+            const result = await this.client.getData(QueryNavigationDataSource, {
+                datasource,
+                language: queryLanguage,
+            });
+            //console.log('[NavigationService.fetchNavigation] Raw result:', JSON.stringify(result, null, 2));
+            if (!result?.navigation) {
+                console.error('[NavigationService.fetchNavigation] No navigation data returned from GraphQL.');
+                return emptyNavigationGroup;
+            }
+            //console.log('[NavigationService.fetchNavigation] closeIconName:', result.navigation.closeIconName.value);
+            //console.log('[NavigationService.fetchNavigation] openIconName:', result.navigation.openIconName.value);
+            return result.navigation;
+        }
+        catch (error) {
+            console.error('[NavigationService.fetchNavigation] Error fetching navigation data:', error);
+            return emptyNavigationGroup;
+        }
+    }
+    /**
+     * Updates the default language used for navigation queries.
+     *
+     * @param language - The new default language code (e.g., 'en', 'nl', 'de')
+     */
+    setLanguage(language) {
+        this.language = language;
+    }
+    /**
+     * Gets the current default language setting.
+     *
+     * @returns The current language code
+     */
+    getLanguage() {
+        return this.language;
+    }
+}

package/dist/xbe-lib/src/services/NavigationService/index.d.ts

@@ -0,0 +1,4 @@
+export { NavigationService } from './NavigationService';
+export type { NavigationServiceConfig } from './NavigationService';
+export type { NavigationDataSourceResponse, NavigationGroup, NavigationDropdown, NavigationFolder, NavigationItem, NavigationCTA, TextField, LinkField, ItemSearchResults, Level2Item, } from './models';
+//# sourceMappingURL=index.d.ts.map

package/dist/xbe-lib/src/services/NavigationService/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../xbe-lib/src/services/NavigationService/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EACV,4BAA4B,EAC5B,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,UAAU,GACX,MAAM,UAAU,CAAC"}

package/dist/xbe-lib/src/services/NavigationService/index.js

@@ -0,0 +1 @@
+export { NavigationService } from './NavigationService';

package/dist/xbe-lib/src/services/NavigationService/models/ItemSearchResults.d.ts

@@ -0,0 +1,5 @@
+export interface ItemSearchResults<T = unknown> {
+    results: T[];
+    __typename: 'ItemSearchResults';
+}
+//# sourceMappingURL=ItemSearchResults.d.ts.map

package/dist/xbe-lib/src/services/NavigationService/models/ItemSearchResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemSearchResults.d.ts","sourceRoot":"","sources":["../../../../../../../xbe-lib/src/services/NavigationService/models/ItemSearchResults.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,UAAU,EAAE,mBAAmB,CAAC;CACjC"}

package/dist/xbe-lib/src/services/NavigationService/models/ItemSearchResults.js

@@ -0,0 +1 @@
+export {};

package/dist/xbe-lib/src/services/NavigationService/models/LinkField.d.ts

@@ -0,0 +1,19 @@
+export interface LinkFieldValue {
+    href?: string;
+    linktype?: string;
+    url?: string;
+    anchor?: string;
+    target?: string;
+    text?: string;
+    class?: string;
+    title?: string;
+    querystring?: string;
+    id?: string;
+}
+export interface LinkField {
+    jsonValue: {
+        value: LinkFieldValue;
+    };
+    __typename: 'LinkField';
+}
+//# sourceMappingURL=LinkField.d.ts.map

package/dist/xbe-lib/src/services/NavigationService/models/LinkField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkField.d.ts","sourceRoot":"","sources":["../../../../../../../xbe-lib/src/services/NavigationService/models/LinkField.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE;QACT,KAAK,EAAE,cAAc,CAAC;KACvB,CAAC;IACF,UAAU,EAAE,WAAW,CAAC;CACzB"}

package/dist/xbe-lib/src/services/NavigationService/models/LinkField.js

@@ -0,0 +1 @@
+export {};

package/dist/xbe-lib/src/services/NavigationService/models/NavigationCTA.d.ts

@@ -0,0 +1,11 @@
+import { LinkField } from './LinkField';
+export interface NavigationCTA {
+    id?: string;
+    link?: LinkField;
+    navigationTitle?: {
+        jsonValue: unknown;
+        __typename: 'RichTextField';
+    };
+    __typename: 'XBE_CTA';
+}
+//# sourceMappingURL=NavigationCTA.d.ts.map

package/dist/xbe-lib/src/services/NavigationService/models/NavigationCTA.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationCTA.d.ts","sourceRoot":"","sources":["../../../../../../../xbe-lib/src/services/NavigationService/models/NavigationCTA.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,eAAe,CAAC,EAAE;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,eAAe,CAAC;KAC7B,CAAC;IACF,UAAU,EAAE,SAAS,CAAC;CACvB"}

package/dist/xbe-lib/src/services/NavigationService/models/NavigationCTA.js

@@ -0,0 +1 @@
+export {};

package/dist/xbe-lib/src/services/NavigationService/models/NavigationDataSourceResponse.d.ts

@@ -0,0 +1,5 @@
+import { NavigationGroup } from './NavigationGroup';
+export interface NavigationDataSourceResponse {
+    navigation: NavigationGroup;
+}
+//# sourceMappingURL=NavigationDataSourceResponse.d.ts.map

package/dist/xbe-lib/src/services/NavigationService/models/NavigationDataSourceResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationDataSourceResponse.d.ts","sourceRoot":"","sources":["../../../../../../../xbe-lib/src/services/NavigationService/models/NavigationDataSourceResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,eAAe,CAAC;CAC7B"}

package/dist/xbe-lib/src/services/NavigationService/models/NavigationDataSourceResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/xbe-lib/src/services/NavigationService/models/NavigationDropdown.d.ts

@@ -0,0 +1,14 @@
+import { ItemSearchResults } from './ItemSearchResults';
+import { LinkField } from './LinkField';
+import { NavigationCTA } from './NavigationCTA';
+import { NavigationFolder } from './NavigationFolder';
+import { TextField } from './TextField';
+export type Level2Item = NavigationFolder | NavigationCTA;
+export interface NavigationDropdown {
+    id: string;
+    link: LinkField;
+    navigationTitle: TextField;
+    level2: ItemSearchResults<Level2Item>;
+    __typename: 'XBE_Navigation_Dropdown';
+}
+//# sourceMappingURL=NavigationDropdown.d.ts.map

package/dist/xbe-lib/src/services/NavigationService/models/NavigationDropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationDropdown.d.ts","sourceRoot":"","sources":["../../../../../../../xbe-lib/src/services/NavigationService/models/NavigationDropdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,eAAe,EAAE,SAAS,CAAC;IAC3B,MAAM,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACtC,UAAU,EAAE,yBAAyB,CAAC;CACvC"}

package/dist/xbe-lib/src/services/NavigationService/models/NavigationDropdown.js

@@ -0,0 +1 @@
+export {};

package/dist/xbe-lib/src/services/NavigationService/models/NavigationFolder.d.ts

@@ -0,0 +1,12 @@
+import { ItemSearchResults } from './ItemSearchResults';
+import { LinkField } from './LinkField';
+import { NavigationItem } from './NavigationItem';
+import { TextField } from './TextField';
+export interface NavigationFolder {
+    id: string;
+    navigationTitle: TextField;
+    link: LinkField;
+    level3: ItemSearchResults<NavigationItem>;
+    __typename: 'XBE_Navigation_Folder';
+}
+//# sourceMappingURL=NavigationFolder.d.ts.map

package/dist/xbe-lib/src/services/NavigationService/models/NavigationFolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationFolder.d.ts","sourceRoot":"","sources":["../../../../../../../xbe-lib/src/services/NavigationService/models/NavigationFolder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,SAAS,CAAC;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAC1C,UAAU,EAAE,uBAAuB,CAAC;CACrC"}