@kosdev-code/kos-ui-sdk 2.0.31 → 2.0.33

package/common/events/eventBus.d.ts

@@ -58,4 +58,20 @@ export declare function publish(eventType: string, msg: unknown, headers?: Recor
  * ```
  */
 export declare function reset(): void;
+/**
+ * Subscribe to an event that will automatically unsubscribe after the first occurrence
+ *
+ * @param eventType - The event type to listen for
+ * @param callback - The callback to execute once
+ * @returns Unsubscribe function
+ */
+export declare function once<T = ApiCallback>(eventType: string, callback: EventCallback<T>): () => void;
+/**
+ * Wait for a specific event to occur, returning a Promise
+ *
+ * @param eventType - The event type to wait for
+ * @param timeout - Optional timeout in milliseconds
+ * @returns Promise that resolves with the event data
+ */
+export declare function waitFor<T = ApiCallback>(eventType: string, timeout?: number): Promise<T>;
 //# sourceMappingURL=eventBus.d.ts.map

package/common/events/eventBus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/common/events/eventBus.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;CACT;AACD,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,WAAW,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,WAAW,EACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;;;;;EAmC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,eAAe,CAuCjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,SAGpB"}
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/common/events/eventBus.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;CACT;AACD,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,WAAW,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,WAAW,EACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;;;;;EAmC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,eAAe,CAuCjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,SAGpB;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,CAAC,GAAG,WAAW,EAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,MAAM,IAAI,CAQZ;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,WAAW,EACrC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC,CAkBZ"}

package/common/events/eventBus.functional.d.ts

@@ -0,0 +1,150 @@
+import { ApiCallback, EventCallback } from './eventBus';
+
+/**
+ * Subscribe to an event that will automatically unsubscribe after the first occurrence
+ *
+ * @param eventType - The event type to listen for
+ * @param callback - The callback to execute once
+ * @returns Unsubscribe function
+ */
+export declare function once<T = ApiCallback>(eventType: string, callback: EventCallback<T>): () => void;
+/**
+ * Wait for a specific event to occur, returning a Promise
+ *
+ * @param eventType - The event type to wait for
+ * @param timeout - Optional timeout in milliseconds
+ * @returns Promise that resolves with the event data
+ */
+export declare function waitFor<T = ApiCallback>(eventType: string, timeout?: number): Promise<T>;
+/**
+ * Wait for multiple events to occur (Promise.all pattern)
+ *
+ * @param eventTypes - Array of event types to wait for
+ * @param timeout - Optional timeout in milliseconds
+ * @returns Promise that resolves when all events have occurred
+ */
+export declare function waitForAll<T = ApiCallback>(eventTypes: string[], timeout?: number): Promise<T[]>;
+/**
+ * Wait for the first event to occur from a list (Promise.race pattern)
+ *
+ * @param eventTypes - Array of event types to race
+ * @param timeout - Optional timeout in milliseconds
+ * @returns Promise that resolves with the first event
+ */
+export declare function race<T = ApiCallback>(eventTypes: string[], timeout?: number): Promise<{
+    eventType: string;
+    data: T;
+}>;
+/**
+ * Filter events based on a predicate function
+ *
+ * @param eventType - The event type to filter
+ * @param predicate - Function to test each event
+ * @param callback - Callback for events that pass the filter
+ * @returns Unsubscribe function
+ */
+export declare function filter<T = ApiCallback>(eventType: string, predicate: (msg: T) => boolean, callback: EventCallback<T>): () => void;
+/**
+ * Transform events using a map function
+ *
+ * @param eventType - The event type to transform
+ * @param transform - Function to transform the event data
+ * @param callback - Callback for transformed events
+ * @returns Unsubscribe function
+ */
+export declare function map<T = ApiCallback, R = any>(eventType: string, transform: (msg: T) => R, callback: (msg: R) => void): () => void;
+/**
+ * Debounce events - only emit after a period of inactivity
+ *
+ * @param eventType - The event type to debounce
+ * @param delay - Delay in milliseconds
+ * @param callback - Callback for debounced events
+ * @returns Unsubscribe function
+ */
+export declare function debounce<T = ApiCallback>(eventType: string, delay: number, callback: EventCallback<T>): () => void;
+/**
+ * Throttle events - limit emissions to once per interval
+ *
+ * @param eventType - The event type to throttle
+ * @param interval - Minimum interval between emissions in milliseconds
+ * @param callback - Callback for throttled events
+ * @returns Unsubscribe function
+ */
+export declare function throttle<T = ApiCallback>(eventType: string, interval: number, callback: EventCallback<T>): () => void;
+/**
+ * Buffer events and emit them as an array
+ *
+ * @param eventType - The event type to buffer
+ * @param bufferTime - Time window to collect events in milliseconds
+ * @param callback - Callback for buffered events
+ * @returns Unsubscribe function
+ */
+export declare function buffer<T = ApiCallback>(eventType: string, bufferTime: number, callback: (events: T[]) => void): () => void;
+/**
+ * Create a replay subject that remembers the last N events
+ *
+ * @param eventType - The event type to replay
+ * @param bufferSize - Number of events to remember
+ * @returns Object with subscribe method that replays buffered events
+ */
+export declare function replay<T = ApiCallback>(eventType: string, bufferSize?: number): {
+    subscribe: (callback: EventCallback<T>) => {
+        count: number;
+        unsubscribe: () => {
+            count: number;
+        };
+    };
+};
+/**
+ * Merge multiple event streams into one
+ *
+ * @param eventTypes - Array of event types to merge
+ * @param callback - Callback for all merged events
+ * @returns Unsubscribe function for all subscriptions
+ */
+export declare function merge<T = ApiCallback>(eventTypes: string[], callback: (eventType: string, msg: T) => void): () => void;
+/**
+ * Create a state machine that transitions based on events
+ *
+ * @param initialState - The initial state
+ * @param transitions - Object mapping states to event handlers
+ * @returns Object with current state and unsubscribe function
+ */
+export declare function stateMachine<TState extends string, T = ApiCallback>(initialState: TState, transitions: Record<TState, Record<string, (msg: T) => TState>>): {
+    readonly state: TState;
+    unsubscribe: () => void;
+};
+/**
+ * Utility to create a promise that can be resolved by publishing an event
+ *
+ * @param requestEvent - Event type to publish the request
+ * @param responseEvent - Event type to wait for the response
+ * @param request - The request data to publish
+ * @param timeout - Optional timeout in milliseconds
+ * @returns Promise that resolves with the response
+ */
+export declare function request<TRequest = any, TResponse = ApiCallback>(requestEvent: string, responseEvent: string, request: TRequest, timeout?: number): Promise<TResponse>;
+/**
+ * Create an async iterator for events
+ *
+ * @param eventType - The event type to iterate
+ * @returns Async iterator for use with for-await-of
+ */
+export declare function eventIterator<T = ApiCallback>(eventType: string): AsyncIterableIterator<T>;
+export declare const EventBusFunctional: {
+    once: typeof once;
+    waitFor: typeof waitFor;
+    waitForAll: typeof waitForAll;
+    race: typeof race;
+    filter: typeof filter;
+    map: typeof map;
+    debounce: typeof debounce;
+    throttle: typeof throttle;
+    buffer: typeof buffer;
+    replay: typeof replay;
+    merge: typeof merge;
+    stateMachine: typeof stateMachine;
+    request: typeof request;
+    eventIterator: typeof eventIterator;
+};
+//# sourceMappingURL=eventBus.functional.d.ts.map

package/common/events/eventBus.functional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.functional.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/common/events/eventBus.functional.ts"],"names":[],"mappings":"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"}

package/common/events/eventBus.state.d.ts

@@ -0,0 +1,118 @@
+import { ApiCallback, EventCallback } from './eventBus';
+
+/**
+ * Options for state-aware event subscriptions
+ */
+export interface StateAwareOptions<T> {
+    /** Function to fetch the current state */
+    getCurrentState: () => Promise<T> | T;
+    /** Optional transform function to normalize API response to event format */
+    transformState?: (state: any) => T;
+    /** Optional function to determine if we should use the fetched state */
+    shouldUseFetchedState?: (state: T) => boolean;
+    /** Timeout for waiting for events (ms) */
+    timeout?: number;
+}
+/**
+ * Wait for an event OR get the current state if the event already happened
+ * This prevents race conditions where events fire before subscription
+ *
+ * @param eventType - The event type to wait for
+ * @param options - Options for state fetching and transformation
+ * @returns Promise that resolves with either the event data or current state
+ */
+export declare function waitForOrGetState<T = ApiCallback>(eventType: string, options: StateAwareOptions<T>): Promise<T>;
+/**
+ * Subscribe to events with initial state, ensuring no events are missed
+ *
+ * @param eventType - The event type to subscribe to
+ * @param callback - Callback for state updates
+ * @param options - Options for initial state fetching
+ * @returns Unsubscribe function
+ */
+export declare function subscribeWithInitialState<T = ApiCallback>(eventType: string, callback: EventCallback<T>, options: StateAwareOptions<T>): () => void;
+/**
+ * Create a state-synchronized event stream that combines initial state with events
+ *
+ * @param eventType - The event type for updates
+ * @param stateApi - API endpoint or function to fetch current state
+ * @returns Object with subscribe method and current state getter
+ */
+export declare function createStatefulEventStream<T = any>(eventType: string, stateApi: string | (() => Promise<T>)): {
+    /** Get current state synchronously (may be undefined if not loaded) */
+    readonly state: T | undefined;
+    /** Get current state asynchronously (waits for initial load) */
+    getState(): Promise<T>;
+    /** Subscribe to state changes (includes initial state) */
+    subscribe(callback: (state: T) => void): () => void;
+    /** Refresh state from API */
+    refresh(): Promise<T>;
+};
+/**
+ * Wait for multiple events with shared state checking
+ * Checks global state once to see if all conditions are already met
+ *
+ * @param eventTypes - Array of event types to wait for
+ * @param options - Shared state checking options
+ * @returns Promise that resolves when all events have occurred or state is ready
+ */
+export declare function waitForAllWithState<T = ApiCallback>(eventTypes: string[], options: StateAwareOptions<T>): Promise<T>;
+/**
+ * Wait for a single event with state checking (convenience overload)
+ *
+ * @param eventType - Single event type to wait for
+ * @param options - State checking options
+ * @returns Promise that resolves when event occurs or state is ready
+ */
+export declare function waitForAllWithState<T = ApiCallback>(eventType: string, options: StateAwareOptions<T>): Promise<T>;
+/**
+ * Create a resilient event handler that can recover from missed events
+ *
+ * @param eventType - Event type to handle
+ * @param handler - Event handler function
+ * @param recoveryStrategy - Strategy for recovering missed events
+ */
+export declare function createResilientEventHandler<T = ApiCallback>(eventType: string, handler: (data: T) => void | Promise<void>, recoveryStrategy: {
+    /** API to fetch missed events or current state */
+    fetchMissedEvents: () => Promise<T[]> | Promise<T>;
+    /** How often to check for missed events (ms) */
+    checkInterval?: number;
+    /** Whether to deduplicate events by ID */
+    deduplicateById?: (event: T) => string;
+}): () => void;
+/**
+ * Pattern for handling connection state with events
+ * Useful for WebSocket connections, plugin loading, etc.
+ */
+export interface ConnectionStateManager<T = any> {
+    /** Current connection state */
+    state: "disconnected" | "connecting" | "connected" | "error";
+    /** Current data (if connected) */
+    data?: T;
+    /** Wait for connection to be established */
+    waitForConnection(timeout?: number): Promise<T>;
+    /** Subscribe to state changes */
+    subscribe(callback: (state: ConnectionStateManager<T>) => void): () => void;
+    /** Manually trigger reconnection */
+    reconnect(): Promise<void>;
+}
+/**
+ * Create a connection state manager that handles online/offline scenarios
+ */
+export declare function createConnectionStateManager<T = any>(config: {
+    connectEvent: string;
+    disconnectEvent: string;
+    errorEvent?: string;
+    dataEvent?: string;
+    fetchInitialState: () => Promise<T>;
+    reconnectDelay?: number;
+}): ConnectionStateManager<T>;
+export declare const EventBusState: {
+    waitForOrGetState: typeof waitForOrGetState;
+    subscribeWithInitialState: typeof subscribeWithInitialState;
+    createStatefulEventStream: typeof createStatefulEventStream;
+    waitForAllWithState: typeof waitForAllWithState;
+    createResilientEventHandler: typeof createResilientEventHandler;
+    createConnectionStateManager: typeof createConnectionStateManager;
+};
+//# sourceMappingURL=eventBus.state.d.ts.map

package/common/events/eventBus.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.state.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/common/events/eventBus.state.ts"],"names":[],"mappings":"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"}

package/common/events/index.d.ts

@@ -1,6 +1,9 @@
 import * as EventBus from "./eventBus";
-export { EventBus };
-export type { EventCallback, ApiCallback } from './eventBus';
+import * as EventBusFunctional from "./eventBus.functional";
+import * as EventBusState from "./eventBus.state";
+export type { ApiCallback, EventCallback } from './eventBus';
+export type { ConnectionStateManager, StateAwareOptions, } from './eventBus.state';
+export { EventBus, EventBusFunctional, EventBusState };
 declare global {
     interface Window {
         kosUtils: {

package/common/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/common/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,EAAE;YACR,QAAQ,EAAE,OAAO,QAAQ,CAAC;SAC3B,CAAC;QACF,sBAAsB,EAAE,MAAM,IAAI,CAAC;QACnC,sBAAsB,EAAE,CACtB,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,GAAG,eAAe,KACpD,IAAI,CAAC;QACV,sBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC9C,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KAC/B;CACF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/common/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,kBAAkB,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EACV,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC;AAEvD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,EAAE;YACR,QAAQ,EAAE,OAAO,QAAQ,CAAC;SAC3B,CAAC;QACF,sBAAsB,EAAE,MAAM,IAAI,CAAC;QACnC,sBAAsB,EAAE,CACtB,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,GAAG,eAAe,KACpD,IAAI,CAAC;QACV,sBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC9C,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KAC/B;CACF"}

package/core/core/decorators/kosTopicHandler.d.ts

@@ -50,6 +50,41 @@ export interface IKosTopicHandlerParams<Response = any, Model extends IKosDataMo
      */
     skipParse?: boolean;
     destinationAddress?: string;
+    /**
+     * Debounce events - only emit after a period of inactivity
+     * @example debounce: 1000 // Wait 1 second after last event
+     */
+    debounce?: number;
+    /**
+     * Throttle events - limit emissions to once per interval
+     * @example throttle: 500 // At most once every 500ms
+     */
+    throttle?: number;
+    /**
+     * Buffer events and emit them as an array after time window or max size
+     */
+    buffer?: {
+        /** Time window to collect events (ms) */
+        time: number;
+        /** Maximum number of events to buffer */
+        maxSize?: number;
+    };
+    /**
+     * Filter events based on a predicate function
+     * Note: This operates on the raw payload before transformation
+     */
+    filter?: (payload: Response) => boolean;
+    /**
+     * Only handle the event once, then automatically unsubscribe
+     */
+    once?: boolean;
+    /**
+     * Replay the last N events to new handlers
+     */
+    replay?: {
+        /** Number of events to remember and replay */
+        bufferSize: number;
+    };
 }
 /**
  * Decorator for defining a Kos topic handler function within a Kos Data Model class.
@@ -57,23 +92,35 @@ export interface IKosTopicHandlerParams<Response = any, Model extends IKosDataMo
  * @param params - An object containing configuration parameters for the topic handler.
  * @returns A decorator function.
  *
- * @example
+ * @example Basic usage:
+ * ```typescript
+ * @kosTopicHandler({
+ *   topic: 'temperature/update',
+ *   websocket: true
+ * })
+ * handleTemperature(payload: TemperatureData) { }
+ * ```
+ *
+ * @example Debounced handling:
  * ```typescript
- * class MyKosDataModel implements IKosDataModel {
- *   // ...
+ * @kosTopicHandler({
+ *   topic: 'rapid/updates',
+ *   websocket: true,
+ *   debounce: 1000 // Wait 1 second after last event
+ * })
+ * handleRapidUpdates(payload: UpdateData) { }
+ * ```
  *
- *   @kosTopicHandler({
- *     topic: 'exampleTopic',
- *     condition: (payload, model) => payload.valid && model.active,
- *     transform: (payload) => ({ modifiedPayload: payload }),
- *     websocket: true,
- *   })
- *   handleExampleTopic(payload: any) {
- *     // Handle the received topic payload here.
- *   }
- * }
+ * @example Buffered batch processing:
+ * ```typescript
+ * @kosTopicHandler({
+ *   topic: 'log/entry',
+ *   websocket: true,
+ *   buffer: { time: 5000, maxSize: 100 }
+ * })
+ * handleLogBatch(entries: LogEntry[]) { }
  * ```
  * @category KOS Model Decorator
  */
-export declare function kosTopicHandler<Response = any, Model extends IKosDataModel = any, TransformedResponse = Response>({ topic, condition, transform, websocket, fos, bridge, skipParse, lifecycle, destinationAddress, }: IKosTopicHandlerParams<Response, Model, TransformedResponse>): (target: any, _propertyKey: string, descriptor: PropertyDescriptor) => void;
+export declare function kosTopicHandler<Response = any, Model extends IKosDataModel = any, TransformedResponse = Response>({ topic, condition, transform, websocket, fos, bridge, skipParse, lifecycle, destinationAddress, debounce, throttle, buffer, filter, once, replay, }: IKosTopicHandlerParams<Response, Model, TransformedResponse>): (target: any, _propertyKey: string, descriptor: PropertyDescriptor) => void;
 //# sourceMappingURL=kosTopicHandler.d.ts.map

package/core/core/decorators/kosTopicHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kosTopicHandler.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kosTopicHandler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB,CACrC,QAAQ,GAAG,GAAG,EACd,KAAK,SAAS,aAAa,GAAG,GAAG,EACjC,mBAAmB,GAAG,QAAQ;IAE9B;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEzB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,QAAQ,KACV,OAAO,CAAC;IAEb;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,mBAAmB,CAAC;IAEvD;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEhC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,GAAG,GAAG,EACd,KAAK,SAAS,aAAa,GAAG,GAAG,EACjC,mBAAmB,GAAG,QAAQ,EAC9B,EACA,KAAK,EACL,SAAsC,EACtC,SAAyC,EACzC,SAAiB,EACjB,GAAW,EACX,MAAc,EACd,SAAiB,EACjB,SAAS,EACT,kBAAkB,GACnB,EAAE,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,mBAAmB,CAAC,YAEnD,GAAG,gBACG,MAAM,cACR,kBAAkB,UAkCjC"}
+{"version":3,"file":"kosTopicHandler.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kosTopicHandler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB,CACrC,QAAQ,GAAG,GAAG,EACd,KAAK,SAAS,aAAa,GAAG,GAAG,EACjC,mBAAmB,GAAG,QAAQ;IAE9B;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEzB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,QAAQ,KACV,OAAO,CAAC;IAEb;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,mBAAmB,CAAC;IAEvD;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEhC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAI5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,yCAAyC;QACzC,IAAI,EAAE,MAAM,CAAC;QACb,yCAAyC;QACzC,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;IAExC;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,8CAA8C;QAC9C,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,GAAG,GAAG,EACd,KAAK,SAAS,aAAa,GAAG,GAAG,EACjC,mBAAmB,GAAG,QAAQ,EAC9B,EACA,KAAK,EACL,SAAsC,EACtC,SAAyC,EACzC,SAAiB,EACjB,GAAW,EACX,MAAc,EACd,SAAiB,EACjB,SAAS,EACT,kBAAkB,EAElB,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACN,IAAI,EACJ,MAAM,GACP,EAAE,sBAAsB,CAAC,QAAQ,EAAE,KAAK,EAAE,mBAAmB,CAAC,YAEnD,GAAG,gBACG,MAAM,cACR,kBAAkB,UAiEjC"}

package/core/core/log/log.d.ts

@@ -26,7 +26,7 @@ export declare const KosLog: {
     warn(...msg: any[]): void;
     error(...msg: any[]): void;
     setLevel(level: log.LogLevelDesc, persist?: boolean | undefined): void;
-    getLevel(): 0 | 1 | 3 | 2 | 4 | 5;
+    getLevel(): 0 | 1 | 2 | 3 | 4 | 5;
     setDefaultLevel(level: log.LogLevelDesc): void;
     resetLevel(): void;
     enableAll(persist?: boolean | undefined): void;

package/core/core/services/app-startup-service.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Service for waiting for KOS applications to start
+ * Provides utilities to wait for specific apps before proceeding with initialization
+ */
+/**
+ * Interface representing a started KOS application
+ */
+export interface KosStartedApp {
+    stopped: boolean;
+    appId: string;
+    started: boolean;
+    sectionName: string;
+    postStarted: boolean;
+    parentAppId: string;
+}
+/**
+ * Options for waiting for app startup
+ */
+export interface WaitForAppsOptions {
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Whether to throw error if apps don't start (default: true) */
+    throwOnTimeout?: boolean;
+    /** Whether apps must be fully post-started (default: false) */
+    requirePostStarted?: boolean;
+}
+/**
+ * Wait for specific KOS applications to be started
+ *
+ * @param appIds - Array of application IDs to wait for
+ * @param options - Configuration options
+ * @returns Promise that resolves when all apps are started
+ *
+ * @example
+ * ```typescript
+ * // Wait for single app
+ * await waitForAppsToStart(['kosdev.ddk']);
+ *
+ * // Wait for multiple apps with custom timeout
+ * await waitForAppsToStart([
+ *   'kosdev.ddk',
+ *   'com.kondra.summer.2025.controlledPourPlugin'
+ * ], { timeout: 60000 });
+ *
+ * // Wait without throwing on timeout
+ * const success = await waitForAppsToStart(['kosdev.ddk'], {
+ *   throwOnTimeout: false
+ * });
+ * ```
+ */
+export declare function waitForAppsToStart(appIds: string[], options?: WaitForAppsOptions): Promise<boolean>;
+/**
+ * Wait for a single KOS application to start (convenience function)
+ *
+ * @param appId - Application ID to wait for
+ * @param options - Configuration options
+ * @returns Promise that resolves when app is started
+ */
+export declare function waitForAppToStart(appId: string, options?: WaitForAppsOptions): Promise<boolean>;
+/**
+ * Check if specific apps are currently started (no waiting)
+ *
+ * @param appIds - Array of application IDs to check
+ * @param requirePostStarted - Whether to require post-started status
+ * @returns Promise resolving to status of each app
+ */
+export declare function checkAppsStarted(appIds: string[], requirePostStarted?: boolean): Promise<Record<string, boolean>>;
+/**
+ * Get all currently started apps
+ *
+ * @returns Promise resolving to array of started apps
+ */
+export declare function getStartedApps(): Promise<KosStartedApp[]>;
+//# sourceMappingURL=app-startup-service.d.ts.map

package/core/core/services/app-startup-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-startup-service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/services/app-startup-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CA6FlB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EAAE,EAChB,kBAAkB,UAAQ,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BlC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAc/D"}

package/core/core/services/index.d.ts

@@ -1,3 +1,4 @@
 export * from './browser-router';
 export * from './intent-service';
+export * from './app-startup-service';
 //# sourceMappingURL=index.d.ts.map

package/core/core/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}

package/core/types/utils/kos-fetch.d.ts

@@ -41,9 +41,9 @@ export interface KosFetchOptions {
      */
     method: FetchMethodStrings;
     /**
-     * The request body as a string.
+     * The request body - can be string, ArrayBuffer, Blob, or FormData.
      */
-    body?: string;
+    body?: string | ArrayBuffer | Blob | FormData | Uint8Array;
     /**
      * Indicates whether the request should be ordered.
      */
@@ -74,6 +74,14 @@ export interface KosFetchOptions {
     bridge?: boolean;
     timeout?: number;
     headers?: Record<string, string>;
+    /**
+     * Enable streaming mode for large responses
+     */
+    stream?: boolean;
+    /**
+     * Response type hint for binary data handling
+     */
+    responseType?: "text" | "json" | "arraybuffer" | "blob";
 }
 export interface KosFetchResponse {
     headers: Headers;

package/core/types/utils/kos-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/types/utils/kos-fetch.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,KAAK,kBAAkB,GAAG,MAAM,OAAO,eAAe,CAAC;AAEvD,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,EACjE,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI,CAAC;CACT;AAED,UAAU,IAAI;IACZ,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACnC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,QAAQ,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAE3B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,CACJ,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,OACzD,OAAO,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,iBACf,SAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AACD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/types/utils/kos-fetch.ts"],"names":[],"mappings":"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"}

package/core/util/binary-utils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Utility functions for handling binary data in KOS WebSocket transport
+ */
+/**
+ * Convert ArrayBuffer to base64 string for WebSocket transport
+ */
+export declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
+/**
+ * Convert base64 string back to ArrayBuffer
+ */
+export declare function base64ToArrayBuffer(base64: string): ArrayBuffer;
+/**
+ * Convert Blob to ArrayBuffer
+ */
+export declare function blobToArrayBuffer(blob: Blob): Promise<ArrayBuffer>;
+/**
+ * Convert ArrayBuffer to Blob
+ */
+export declare function arrayBufferToBlob(buffer: ArrayBuffer, type?: string): Blob;
+/**
+ * Convert FormData to a serializable format
+ */
+export declare function serializeFormData(formData: FormData): Promise<{
+    fields: Record<string, string>;
+    files: Array<{
+        name: string;
+        filename: string;
+        type: string;
+        data: string;
+    }>;
+}>;
+/**
+ * Create a ReadableStream from chunks
+ */
+export declare function createChunkedStream(onPull: (controller: ReadableStreamDefaultController<Uint8Array>) => Promise<void>): ReadableStream<Uint8Array>;
+/**
+ * Process body for WebSocket transport
+ */
+export declare function processRequestBody(body: string | ArrayBuffer | Blob | FormData | Uint8Array | undefined): Promise<{
+    data: string;
+    contentType: string;
+    encoding?: string;
+}>;
+//# sourceMappingURL=binary-utils.d.ts.map

package/core/util/binary-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/binary-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAO/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAO/D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAExE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IACnE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E,CAAC,CA8BD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,CACN,UAAU,EAAE,+BAA+B,CAAC,UAAU,CAAC,KACpD,OAAO,CAAC,IAAI,CAAC,GACjB,cAAc,CAAC,UAAU,CAAC,CAY5B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GACpE,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4CnE"}

package/core/util/kos-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/kos-fetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAarE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB;AA4JD;;GAEG;AACH,QAAA,IAAI,QAAQ,QAAS,CAAC;AACtB,QAAA,IAAI,QAAQ,QAlHL,MAAM,YACD,eAAe,KACxB,QAAQ,QAAQ,CAgHM,CAAC;AAS1B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/kos-fetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAmBrE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB;AAmUD;;GAEG;AACH,QAAA,IAAI,QAAQ,QAAS,CAAC;AACtB,QAAA,IAAI,QAAQ,QAzRL,MAAM,YACD,eAAe,KACxB,QAAQ,QAAQ,CAuRM,CAAC;AAS1B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}