@kosdev-code/kos-ui-sdk 0.1.0-dev.5053

package/core/core/decorators/kos-topic-handler-flow-control.d.ts

@@ -0,0 +1,130 @@
+import { IKosDataModel } from '../kosModel';
+import { IKosTopicHandlerParams } from './kosTopicHandler';
+
+/**
+ * Advanced flow control options for kosTopicHandler
+ */
+export interface FlowControlOptions<T = any, R = T> {
+    /**
+     * Batching configuration
+     */
+    batch?: {
+        /** Maximum number of events in a batch */
+        size?: number;
+        /** Maximum time window to collect events (ms) */
+        window?: number;
+    };
+    /**
+     * Transform function to apply to batched events
+     * @param events - Array of events in the batch
+     * @returns Transformed data to pass to handler
+     */
+    transform?: (events: T[]) => R;
+    /**
+     * Backpressure control to prevent overwhelming slow handlers
+     */
+    backpressure?: {
+        /** Maximum concurrent handler executions */
+        maxConcurrent?: number;
+        /** Queue size limit before dropping events */
+        maxQueue?: number;
+        /** Policy for dropping events when queue is full */
+        dropPolicy?: "oldest" | "newest" | "none";
+        /** Callback when events are dropped due to queue overflow */
+        onQueueFull?: (droppedEvents: T[]) => void;
+    };
+    /**
+     * Advanced filtering with state awareness
+     */
+    filter?: {
+        /** Predicate function for filtering events */
+        predicate: (event: T, context: FilterContext) => boolean;
+        /** Remember last N events for stateful filtering */
+        historySize?: number;
+    };
+    /**
+     * Rate limiting options
+     */
+    rateLimit?: {
+        /** Maximum events to process per time window */
+        maxEvents: number;
+        /** Time window in milliseconds */
+        windowMs: number;
+        /** What to do when rate limit is exceeded */
+        onExceeded?: "drop" | "delay" | "error";
+    };
+    /**
+     * Error handling strategy for the flow
+     */
+    errorHandling?: {
+        /** Retry failed events */
+        retry?: {
+            attempts: number;
+            backoffMs: number;
+        };
+        /** Continue processing other events if one fails */
+        continueOnError?: boolean;
+    };
+}
+export interface FilterContext {
+    /** Previous events in the filter history */
+    history: any[];
+    /** Current batch being processed */
+    currentBatch: any[];
+    /** Timestamp when filtering started */
+    startTime: number;
+}
+/**
+ * Enhanced kosTopicHandler params with flow control
+ */
+export interface IKosTopicHandlerFlowParams<T = any, Model extends IKosDataModel = any, R = T> extends IKosTopicHandlerParams<T, Model, R> {
+    /**
+     * Advanced flow control options using async iterators internally
+     */
+    flow?: FlowControlOptions<T, R>;
+}
+/**
+ * Statistics for monitoring flow control performance
+ */
+export interface FlowControlStats {
+    /** Total events received */
+    eventsReceived: number;
+    /** Total batches processed */
+    batchesProcessed: number;
+    /** Events dropped due to backpressure */
+    eventsDropped: number;
+    /** Current queue size */
+    currentQueueSize: number;
+    /** Average batch size */
+    averageBatchSize: number;
+    /** Processing rate (events/second) */
+    processingRate: number;
+    /** Last processing timestamp */
+    lastProcessedAt: number;
+}
+/**
+ * Internal flow control manager
+ */
+export declare class FlowControlManager<T = any, R = T> {
+    private config;
+    private stats;
+    private filterHistory;
+    private activePromises;
+    private eventQueue;
+    private rateLimitWindow;
+    constructor(config: FlowControlOptions<T, R>);
+    processEvents(eventStream: AsyncIterable<T>): AsyncGenerator<R, void, unknown>;
+    private processSingleEvent;
+    private processBatchedEvents;
+    private shouldProcessEvent;
+    private checkRateLimit;
+    private waitForRateLimit;
+    private waitForCapacity;
+    private handleQueueOverflow;
+    private enqueueEvent;
+    private dequeueEvent;
+    private updateProcessingStats;
+    trackPromise<U>(promise: Promise<U>): Promise<U>;
+    getStats(): FlowControlStats;
+}
+//# sourceMappingURL=kos-topic-handler-flow-control.d.ts.map

package/core/core/decorators/kos-topic-handler-flow-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kos-topic-handler-flow-control.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-topic-handler-flow-control.ts"],"names":[],"mappings":"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"}

package/core/core/decorators/kos-trouble-aware.d.ts

@@ -0,0 +1,71 @@
+export interface KosTroubleAwareOptions {
+    /** Path property name to use for trouble resolution. Default: 'path' */
+    pathProperty?: string;
+}
+/**
+ * Class decorator that automatically adds TroubleAware capabilities to a KOS model.
+ *
+ * This decorator eliminates the need for manual TroubleAware interface implementation by:
+ * - Adding troubleContainer dependency injection (internal, not exposed)
+ * - Adding troubles getter that filters by model path
+ * - Adding troubleStatus getter (returns empty string by default)
+ * - Adding troublesByType getter that groups troubles by type
+ *
+ * **Important**: Use TypeScript interface merging to get proper type information:
+ *
+ * ```typescript
+ * // Add ESLint disable comment at top of file, then:
+ * interface MyModelImpl extends TroubleAware {}
+ *
+ * @kosTroubleAware()
+ * class MyModelImpl implements IKosDataModel {
+ *   path: string; // Required for trouble resolution
+ *
+ *   constructor(modelId: string, options: MyOptions) {
+ *     this.path = options.path;
+ *     // All TroubleAware properties are now available with full type safety
+ *   }
+ * }
+ * ```
+ *
+ * The decorator requires the model to have a path property (default) or specify
+ * a custom path property via options.
+ *
+ * @param options Configuration options for the decorator
+ * @returns A class decorator
+ *
+ * @example
+ * ```typescript
+ * // Default usage - uses this.path
+ * interface HolderModelImpl extends TroubleAware {}
+ *
+ * @kosTroubleAware()
+ * class HolderModelImpl implements IKosDataModel {
+ *   path: string; // Required for trouble path resolution
+ *
+ *   constructor(modelId: string, options: HolderOptions) {
+ *     this.path = options.path;
+ *   }
+ * }
+ *
+ * // Custom path property
+ * interface CustomModelImpl extends TroubleAware {}
+ *
+ * @kosTroubleAware({ pathProperty: 'devicePath' })
+ * class CustomModelImpl implements IKosDataModel {
+ *   devicePath: string; // Custom path property
+ *
+ *   constructor(modelId: string, options: CustomOptions) {
+ *     this.devicePath = options.devicePath;
+ *   }
+ * }
+ *
+ * // Type-safe external interface
+ * export type HolderModel = PublicModelInterface<HolderModelImpl> & TroubleAware;
+ * ```
+ *
+ * @category KOS Model Decorator
+ * @since 2.0.0
+ */
+export declare function kosTroubleAware(options?: KosTroubleAwareOptions): ClassDecorator;
+//# sourceMappingURL=kos-trouble-aware.d.ts.map

package/core/core/decorators/kos-trouble-aware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kos-trouble-aware.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-trouble-aware.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAsBhB"}

package/core/core/decorators/kosDependency.d.ts

@@ -0,0 +1,16 @@
+import { KosDependencyParams } from '../../types/kos-dependency';
+
+export * as KosDependencyTypes from '../../types/kos-dependency';
+/**
+ * This decorator is used to define a dependency on a Kos model.
+ *
+ * @param params The parameters for the decorator.
+ * @param params.modelType The type of the model to be injected.
+ * @param params.id The id of the model to be injected.
+ * @param params.options The options to be passed to the model constructor.
+ * @param params.lifecycle The lifecycle at which the dependency should be injected.
+ *
+ * @category KOS Model Decorator
+ * */
+export declare const kosDependency: <Options = unknown>({ modelType, id, options, lifecycle, }: KosDependencyParams<Options>) => (target: {} | any, name: PropertyKey) => any;
+//# sourceMappingURL=kosDependency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kosDependency.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kosDependency.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,kBAAkB,MAAM,4BAA4B,CAAC;AAEjE;;;;;;;;;;KAUK;AACL,eAAO,MAAM,aAAa,8DAQrB,oBAAoB,OAAO,CAAC,cACtB,EAAE,GAAG,GAAG,QAAQ,WAAW,KAAG,GAStC,CAAC"}

package/core/core/decorators/kosModel.d.ts

@@ -0,0 +1,16 @@
+import { IKosDataModel } from '../kosModel';
+
+interface KosModelConfig {
+    modelTypeId: string;
+    singleton?: boolean;
+    autoRegister?: boolean;
+}
+/**
+ * Decorator for defining a Kos Data Model class.
+ *
+ * @param config - The model configuration. Can be a string (backward compatibility) or configuration object.
+ * @returns A decorator function that transforms the class into a KOS-compatible model.
+ */
+export declare function kosModel<T extends IKosDataModel, O extends object = Record<string, any>>(config: string | KosModelConfig): ClassDecorator;
+export {};
+//# sourceMappingURL=kosModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kosModel.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kosModel.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAykB5C,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,CAqDjD"}

package/core/core/decorators/kosSubscribe.d.ts

@@ -0,0 +1,9 @@
+export interface IKosSubscriptionHandlerParams<T, M> {
+    topic: string;
+    condition?: (payload: T, model: M) => boolean;
+    handler: Function;
+    websocket?: boolean;
+    skipParse?: boolean;
+}
+export declare const kosSubscribe: <T = unknown, M = unknown>({ topic, handler, websocket, condition, }: IKosSubscriptionHandlerParams<T, M>) => (target: T) => void;
+//# sourceMappingURL=kosSubscribe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kosSubscribe.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kosSubscribe.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,6BAA6B,CAAC,CAAC,EAAE,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IAC9C,OAAO,EAAE,QAAQ,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,wEAMpB,8BAA8B,CAAC,EAAE,CAAC,CAAC,cAC7B,CAAC,SAiBT,CAAC"}

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

@@ -0,0 +1,220 @@
+import { FlowControlOptions } from './kos-topic-handler-flow-control';
+import { IKosDataModel } from '../kosModel';
+import { DependencyLifecycle } from '../../types';
+import { ApiCallback } from '../../../common/events';
+
+/**
+ * Extended ApiCallback that includes wildcard capture data for handlers with trailing wildcards
+ */
+export interface ApiCallbackWithWildcard<T = string> extends ApiCallback<T> {
+    wildcardCapture?: Record<string, string>;
+}
+/**
+ * Utility function to extract trailing wildcard from a topic pattern and actual topic
+ * @internal - exported for testing
+ */
+export declare function extractTrailingWildcard(pattern: string, actualTopic: string, wildcardName?: string): Record<string, string>;
+/**
+ * Check if a topic pattern has a trailing wildcard
+ * @internal - exported for testing
+ */
+export declare function hasTrailingWildcard(pattern: string): boolean;
+/**
+ * Configuration parameters for defining a Kos topic handler function within a Kos Data Model class.
+ *
+ * @typeparam Response - The type of the raw response payload received from the topic.
+ * @typeparam Model - The type of the Kos Data Model to which the topic handler belongs.
+ * @typeparam TransformedResponse - The type of the transformed response payload after applying the transformation function.
+ */
+export interface IKosTopicHandlerParams<Response = any, Model extends IKosDataModel = any, TransformedResponse = Response> {
+    /**
+     * The topic or array of topics to which the handler should respond.
+     */
+    topic: string | string[];
+    /**
+     * A conditional function that determines whether the handler should be invoked based on the received payload and the Kos Data Model instance.
+     * If not provided, the handler will always be invoked when a matching topic is received.
+     *
+     * @param payload - The transformed payload received from the topic.
+     * @param model - The Kos Data Model instance to which the topic handler belongs.
+     * @returns `true` if the handler should be invoked, `false` otherwise.
+     */
+    condition?: (payload: TransformedResponse, model: Model, raw: Response) => boolean;
+    /**
+     * A transformation function that converts the raw response payload into a desired format.
+     * If not provided, the payload will be used as is.
+     *
+     * @param payload - The raw response payload received from the topic.
+     * @returns The transformed payload in the desired format.
+     */
+    transform?: (payload: Response) => TransformedResponse;
+    /**
+     * Indicates whether the topic handler should listen for WebSocket messages.
+     * If set to `true`, the handler will be invoked when WebSocket messages with matching topics are received.
+     * Default is `false`.
+     */
+    websocket?: boolean;
+    /**
+     * @internal
+     */
+    fos?: boolean;
+    /**
+     * @internal
+     */
+    bridge?: boolean;
+    lifecycle?: DependencyLifecycle;
+    /**
+     * @internal
+     */
+    skipParse?: boolean;
+    destinationAddress?: string;
+    /**
+     * Debounce events - only emit after a period of inactivity
+     * @example debounce: 1000 // Wait 1 second after last event
+     * @example debounce: { delay: 1000, discardIntermediate: true } // Only keep last value
+     */
+    debounce?: number | {
+        delay: number;
+        /** If true, only keeps the last value. If false (default), accumulates all values */
+        discardIntermediate?: boolean;
+    };
+    /**
+     * Throttle events - limit emissions to once per interval
+     * @example throttle: 500 // At most once every 500ms
+     * @example throttle: { interval: 500, discardIntermediate: true } // Only keep first value in window
+     */
+    throttle?: number | {
+        interval: number;
+        /** If true, only keeps the first value in window. If false (default), accumulates all values */
+        discardIntermediate?: boolean;
+    };
+    /**
+     * 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;
+    };
+    /**
+     * Named wildcard capture for trailing /* patterns.
+     * When enabled, the portion after the /* is parsed and passed to the handler.
+     * You can optionally specify a name for the captured segment.
+     *
+     * @example
+     * ```typescript
+     * @kosTopicHandler({
+     *   topic: "/config/system/*",
+     *   websocket: true,
+     *   wildcardName: "configPath"
+     * })
+     * handleConfigUpdate(payload: ConfigData, raw: ApiCallbackWithWildcard<any>) {
+     *   // raw.wildcardCapture.configPath contains everything after "/config/system/"
+     * }
+     * ```
+     */
+    wildcardName?: string;
+    /**
+     * Advanced flow control options using async iterators internally.
+     * Enables sophisticated event processing patterns like batching, backpressure,
+     * on-the-fly transforms, and rate limiting.
+     *
+     * @example
+     * ```typescript
+     * @kosTopicHandler({
+     *   topic: 'sensor.data',
+     *   websocket: true,
+     *   flow: {
+     *     batch: { size: 50, window: 1000 },
+     *     transform: (events) => aggregateEvents(events),
+     *     backpressure: { maxConcurrent: 3 }
+     *   }
+     * })
+     * handleProcessedEvents(aggregatedData) {
+     *   // Receives transformed, batched data with backpressure control
+     * }
+     * ```
+     */
+    flow?: FlowControlOptions<Response, TransformedResponse>;
+}
+/**
+ * Decorator for defining a Kos topic handler function within a Kos Data Model class.
+ *
+ * @param params - An object containing configuration parameters for the topic handler.
+ * @returns A decorator function.
+ *
+ * @example Basic usage:
+ * ```typescript
+ * @kosTopicHandler({
+ *   topic: 'temperature/update',
+ *   websocket: true
+ * })
+ * handleTemperature(payload: TemperatureData) { }
+ * ```
+ *
+ * @example Debounced handling:
+ * ```typescript
+ * @kosTopicHandler({
+ *   topic: 'rapid/updates',
+ *   websocket: true,
+ *   debounce: 1000 // Wait 1 second after last event
+ * })
+ * handleRapidUpdates(payload: UpdateData) { }
+ * ```
+ *
+ * @example Buffered batch processing:
+ * ```typescript
+ * @kosTopicHandler({
+ *   topic: 'log/entry',
+ *   websocket: true,
+ *   buffer: { time: 5000, maxSize: 100 }
+ * })
+ * handleLogBatch(entries: LogEntry[]) { }
+ * ```
+ *
+ * @example Trailing wildcard with custom name:
+ * ```typescript
+ * @kosTopicHandler({
+ *   topic: '/config/system/*',
+ *   websocket: true,
+ *   wildcardName: 'configPath'
+ * })
+ * handleConfigUpdate(payload: ConfigData, raw: ApiCallbackWithWildcard<any>) {
+ *   // raw.wildcardCapture.configPath = "network/timeout" (everything after "/config/system/")
+ * }
+ * ```
+ *
+ * @example Trailing wildcard with PropKeys:
+ * ```typescript
+ * const DEVICE_ID = createPropKey<DeviceModel>('deviceId');
+ *
+ * @kosTopicHandler({
+ *   topic: `/devices/${DEVICE_ID}/sensors/*`,
+ *   websocket: true,
+ *   wildcardName: 'sensorPath'
+ * })
+ * handleSensorEvent(payload: SensorData, raw: ApiCallbackWithWildcard<any>) {
+ *   // raw.wildcardCapture.sensorPath = "temperature/reading" (everything after device-specific prefix)
+ * }
+ * ```
+ * @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, debounce, throttle, buffer, filter, once, replay, wildcardName, flow, }: IKosTopicHandlerParams<Response, Model, TransformedResponse>): (target: any, _propertyKey: string, descriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=kosTopicHandler.d.ts.map

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

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

package/core/core/decorators/propKeys.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @internal
+ */
+export declare const SubscriptionHandlers: unique symbol;
+export declare const DependencyModels: unique symbol;
+export declare const FutureService: unique symbol;
+export declare const ChildModels: unique symbol;
+export declare const ParentModel: unique symbol;
+export declare const LogConfig: unique symbol;
+export declare const ReferenceConfig: unique symbol;
+export declare const KosModelSymbol: unique symbol;
+export declare const ModelEffects: unique symbol;
+export declare const CompanionParentModel: unique symbol;
+export declare const FutureContainerSetup: unique symbol;
+export declare const MultipleFutureContainerSetup: unique symbol;
+export declare const FutureAliases: unique symbol;
+export declare const TroubleAwareSetup: unique symbol;
+export declare const LoggerSetup: unique symbol;
+export declare const ContainerAwareSetup: unique symbol;
+//# sourceMappingURL=propKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"propKeys.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/propKeys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AACnE,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAC3D,eAAO,MAAM,aAAa,eAA0B,CAAC;AACrD,eAAO,MAAM,WAAW,eAAwB,CAAC;AACjD,eAAO,MAAM,WAAW,eAAwB,CAAC;AACjD,eAAO,MAAM,SAAS,eAAsB,CAAC;AAC7C,eAAO,MAAM,eAAe,eAA4B,CAAC;AACzD,eAAO,MAAM,cAAc,eAA2B,CAAC;AACvD,eAAO,MAAM,YAAY,eAAyB,CAAC;AACnD,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AACnE,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AACnE,eAAO,MAAM,4BAA4B,eAExC,CAAC;AACF,eAAO,MAAM,aAAa,eAA0B,CAAC;AACrD,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAC7D,eAAO,MAAM,WAAW,eAAwB,CAAC;AACjD,eAAO,MAAM,mBAAmB,eAAgC,CAAC"}

package/core/core/decorators/resolve-parameters.d.ts

@@ -0,0 +1,8 @@
+interface ResolveParameterOptions {
+    value: string | object;
+    modelId: string;
+    modelData: any;
+}
+export declare const resolveParameters: ({ value, modelId, modelData, }: ResolveParameterOptions) => string | object | undefined;
+export {};
+//# sourceMappingURL=resolve-parameters.d.ts.map

package/core/core/decorators/resolve-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-parameters.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/resolve-parameters.ts"],"names":[],"mappings":"AAIA,UAAU,uBAAuB;IAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,GAAG,CAAC;CAChB;AACD,eAAO,MAAM,iBAAiB,mCAI3B,uBAAuB,gCAoEzB,CAAC"}

package/core/core/dependency-manager.d.ts

@@ -0,0 +1,9 @@
+export declare class KosDependencyManager {
+    private _usedByCache;
+    private _usesCache;
+    add(modelId: string, dependencyId: string): void;
+    remove(modelId: string, dependencyId: string): void;
+    canDestroy(modelId: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=dependency-manager.d.ts.map

package/core/core/dependency-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/dependency-manager.ts"],"names":[],"mappings":"AAOA,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,UAAU,CAA+B;IAEjD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAYzC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAc5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASpC,KAAK;CAIN"}

package/core/core/extension/extension-manager.d.ts

@@ -0,0 +1,45 @@
+import { IKosDataModel } from '../kosModel';
+import { IndexMapper } from '../kos-container-index';
+import { RendererConstructor } from '../../../models/models/canvas-dispatcher';
+
+export type ExtensionType = number | string | boolean;
+export type DataMapper<I extends object = any, O extends object = any, C extends object = any> = (input: I, context?: C) => Promise<O>;
+export type PropertyMapper<I extends object = any, O extends ExtensionType = any, C extends object = any> = (input: I, context?: C) => O;
+export type DataLoader<I extends object = any, O extends object = any> = (input: I) => Promise<O>;
+export type IndexExtension<T extends IKosDataModel = any> = Record<string, keyof T | IndexMapper<any>>;
+export declare const EXTENSION_CANVAS_RENDERER = "canvas-renderer";
+export interface ExtensionPoint<Data extends object = any, Output extends object = any, Context extends object = any> {
+    register: (id: string, extension: any) => void;
+    execute: (id: string, data: Data, context?: Context) => Output;
+}
+export declare const registerExtensionPoint: (id: string, extensionPoint: ExtensionPoint) => void;
+declare const _ExtensionManager: {
+    indexExtension: {
+        registerIndexExtension: (id: string, extension: IndexExtension) => void;
+        loadIndexExtensions: (id: string) => IndexExtension<any>;
+    };
+    loader: {
+        registerLoader: (id: string, loader: DataLoader) => void;
+        executeLoader: <T extends object = any>(id: string, data: T) => Promise<any>;
+    };
+    propertyMapper: {
+        registerPropertyMapper: (id: string, mapper: PropertyMapper) => void;
+        hasMapper: (id: string) => boolean;
+        executeMapper: <T_1 extends object = any, O extends ExtensionType = any, C extends object = any>(id: string, data: T_1, context?: C) => O;
+    };
+    dataMapper: {
+        registerDataMapper: (id: string, mapper: DataMapper) => void;
+        executeMapper: <T_2 extends object = any, O_1 extends object = any, C_1 extends object = any>(id: string, data: T_2, context?: C_1 | undefined) => Promise<O_1>;
+    };
+    canvas: {
+        registerRenderer: (id: string, renderer: RendererConstructor) => void;
+    };
+};
+export interface IExtensionManager {
+}
+type ExtensionManagerType = typeof _ExtensionManager & IExtensionManager & {
+    [key: string]: ExtensionPoint;
+};
+export declare const ExtensionManager: ExtensionManagerType;
+export {};
+//# sourceMappingURL=extension-manager.d.ts.map

package/core/core/extension/extension-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-manager.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/extension/extension-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACtD,MAAM,MAAM,UAAU,CACpB,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,CAAC,SAAS,MAAM,GAAG,GAAG,IACpB,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE1C,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,CAAC,SAAS,aAAa,GAAG,GAAG,EAC7B,CAAC,SAAS,MAAM,GAAG,GAAG,IACpB,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAEjC,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,MAAM,GAAG,GAAG,IAAI,CACvE,KAAK,EAAE,CAAC,KACL,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,aAAa,GAAG,GAAG,IAAI,MAAM,CAChE,MAAM,EACN,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAC3B,CAAC;AAEF,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAM3D,MAAM,WAAW,cAAc,CAC7B,IAAI,SAAS,MAAM,GAAG,GAAG,EACzB,MAAM,SAAS,MAAM,GAAG,GAAG,EAC3B,OAAO,SAAS,MAAM,GAAG,GAAG;IAE5B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/C,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;CAChE;AACD,eAAO,MAAM,sBAAsB,OAC7B,MAAM,kBACM,cAAc,SAG/B,CAAC;AAEF,QAAA,MAAM,iBAAiB;;qCAEU,MAAM,aAAa,cAAc;kCAMpC,MAAM;;;6BAGX,MAAM,UAAU,UAAU;oDAGG,MAAM,QAAQ,CAAC;;;qCASpC,MAAM,UAAU,cAAc;wBAG3C,MAAM;6GAMhB,MAAM,uBAEA,CAAC;;;iCAWY,MAAM,UAAU,UAAU;0GAW7C,MAAM;;;+BAmBW,MAAM,YAAY,mBAAmB;;CAU/D,CAAC;AAEF,MAAM,WAAW,iBAAiB;CAAG;AACrC,KAAK,oBAAoB,GAAG,OAAO,iBAAiB,GAClD,iBAAiB,GAAG;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAC/B,CAAC;AAEJ,eAAO,MAAM,gBAAgB,sBAA4C,CAAC"}

package/core/core/extension/index.d.ts

@@ -0,0 +1,4 @@
+export * from './extension-manager';
+export * as KosExtensionUtils from './initialize-extension';
+export * from './plugin-extension-manager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/extension/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAC;AAC5D,cAAc,4BAA4B,CAAC"}

package/core/core/extension/initialize-extension.d.ts

@@ -0,0 +1,45 @@
+import { KosContext } from '../context';
+
+export interface ExtensionPointOptions {
+    extension: string;
+}
+export interface InitializeContextExtensionPointOptions extends ExtensionPointOptions {
+    context?: KosContext;
+}
+export interface ContextDataExtensionPoint<D extends object, T extends object> extends ExtensionPointOptions {
+    data: D;
+    contextData: T;
+}
+/**
+ * Executes an extension point and adds the value to the specified context
+ * @param options The options for the extension point
+ * @param options.context The KOS model context to add the value to. If not specified, the value will not be added to any context.
+ * @param options.extension The extension point to execute
+ *
+ * @returns The value returned from the extension point
+ * */
+export declare const executeLoaderExtension: ({ context, extension, }: InitializeContextExtensionPointOptions) => Promise<any>;
+/**
+ * Executes a registered data transformation extension point.  This extension point is used to transform data from the backend into a format that is
+ * usable by the application.
+ *
+ * @param options The options for the extension point
+ * @param options.contextData The context data to pass to the extension point
+ * @param options.data The data to transform
+ * @param options.extension The extension point to execute
+ * @returns The transformed data
+ * */
+export declare const executeDataMapperExtension: <D extends object = any, R extends object = any, T extends object = any>({ extension, contextData, data, }: ContextDataExtensionPoint<D, T>) => Promise<R>;
+/**
+ * Executes a registered data transformation extension point. This extension point is used to map a single property value and
+ * is typically used to map a property value from the backend into a format that is usable by the application.
+ *
+ *
+ * @param options The options for the extension point
+ * @param options.contextData The context data to pass to the extension point
+ * @param options.data The data to transform
+ * @param options.extension The extension point to execute
+ * @returns The transformed data
+ * */
+export declare const executePropertyMapperExtension: <D extends object = any, T extends object = any>({ extension, contextData, data, }: ContextDataExtensionPoint<D, T>) => Promise<any>;
+//# sourceMappingURL=initialize-extension.d.ts.map