@kosdev-code/kos-ui-sdk 2.1.16 → 2.1.18

package/core/core/decorators/kos-state-machine.d.ts

@@ -0,0 +1,466 @@
+import { DependencyLifecycle } from '../../types';
+
+/**
+ * Configuration for a KOS state machine.
+ *
+ * @template TState Union type of valid state strings
+ * @template TEvent Union type of valid event strings
+ *
+ * @example
+ * ```typescript
+ * const config: KosStateMachineConfig<'idle' | 'active', 'START' | 'STOP'> = {
+ *   initial: 'idle',
+ *   initializeAt: DependencyLifecycle.READY,
+ *   states: {
+ *     idle: { on: { START: 'active' } },
+ *     active: { on: { STOP: 'idle' } }
+ *   }
+ * };
+ * ```
+ */
+export interface KosStateMachineConfig<TState extends string, TEvent extends string> {
+    /**
+     * The initial state when the state machine is initialized.
+     * This state will be set when the FSM reaches its configured lifecycle phase.
+     */
+    initial: TState;
+    /**
+     * The lifecycle phase at which the state machine should be initialized.
+     * Before this phase, currentState will be undefined and isFsmInitialized will be false.
+     *
+     * @default DependencyLifecycle.READY
+     *
+     * @example
+     * ```typescript
+     * // FSM initializes when model is ready (most common)
+     * initializeAt: DependencyLifecycle.READY
+     *
+     * // FSM initializes only when UI activates the model
+     * initializeAt: DependencyLifecycle.ACTIVATE
+     *
+     * // FSM initializes during model initialization (rare)
+     * initializeAt: DependencyLifecycle.INIT
+     * ```
+     */
+    initializeAt?: DependencyLifecycle;
+    /**
+     * State machine definition mapping states to their allowed transitions.
+     *
+     * @example
+     * ```typescript
+     * states: {
+     *   idle: { on: { PREPARE: 'preparing' } },
+     *   preparing: { on: { READY: 'ready', ERROR: 'error' } },
+     *   ready: { on: { POUR: 'pouring' } },
+     *   pouring: { on: { COMPLETE: 'idle', ERROR: 'error' } },
+     *   error: { on: { RESET: 'idle' } }
+     * }
+     * ```
+     */
+    states: Record<TState, {
+        /**
+         * Mapping of events to target states.
+         * When an event occurs in this state, transition to the target state.
+         */
+        on?: Partial<Record<TEvent, TState>>;
+    }>;
+}
+/**
+ * Options for configuring state machine behavior.
+ */
+export interface KosStateMachineOptions {
+    /**
+     * Property name for storing the current state.
+     *
+     * @default "currentState"
+     */
+    stateProperty?: string;
+    /**
+     * Whether to track state history.
+     * When enabled, a stateHistory array is maintained with timestamps and events.
+     *
+     * @default false
+     */
+    trackHistory?: boolean;
+    /**
+     * Whether to throw errors on invalid transitions.
+     * When false, invalid transitions are logged as warnings instead.
+     *
+     * @default true
+     */
+    throwOnInvalid?: boolean;
+}
+/**
+ * Interface for models using the @kosStateMachine decorator.
+ *
+ * **IMPORTANT**: Use TypeScript interface merging to add FSM properties to your model class.
+ * This provides full type safety and IntelliSense support for all injected FSM functionality.
+ *
+ * ## Interface Merging Pattern
+ *
+ * ```typescript
+ * // 1. Define state and event types
+ * type PourState = 'idle' | 'preparing' | 'ready' | 'pouring' | 'error';
+ * type PourEvent = 'PREPARE' | 'READY' | 'POUR' | 'COMPLETE' | 'ERROR';
+ *
+ * // 2. Declare interface merging BEFORE the class
+ * interface DispenserModelImpl extends KosStateMachineAware<PourState, PourEvent> {}
+ *
+ * // 3. Apply decorators and implement the class
+ * @kosModel({ modelTypeId: "dispenser-model" })
+ * @kosStateMachine<PourState, PourEvent>({
+ *   initial: 'idle',
+ *   initializeAt: DependencyLifecycle.READY,
+ *   states: {
+ *     idle: { on: { PREPARE: 'preparing' } },
+ *     preparing: { on: { READY: 'ready', ERROR: 'error' } },
+ *     ready: { on: { POUR: 'pouring' } },
+ *     pouring: { on: { COMPLETE: 'idle', ERROR: 'error' } },
+ *     error: {}
+ *   }
+ * })
+ * export class DispenserModelImpl implements IKosDataModel {
+ *   // All FSM properties are now available with full type safety
+ * }
+ * ```
+ *
+ * ## Lifecycle-Aware Initialization
+ *
+ * The FSM is uninitialized until the configured lifecycle phase:
+ * - Before initialization: `currentState === undefined`, `isFsmInitialized === false`
+ * - After initialization: `currentState === initial`, `isFsmInitialized === true`
+ *
+ * ```typescript
+ * @kosStateMachine({
+ *   initial: 'idle',
+ *   initializeAt: DependencyLifecycle.READY, // FSM starts when model is ready
+ *   states: { ... }
+ * })
+ * class MyModel {
+ *   async ready(): Promise<void> {
+ *     // Before this completes: this.currentState === undefined
+ *     // After this completes: this.currentState === 'idle'
+ *   }
+ * }
+ * ```
+ *
+ * ## Injected Properties and Methods
+ *
+ * The decorator automatically injects the following members:
+ *
+ * - **`currentState`**: Current state (undefined until FSM initialized, observable)
+ * - **`isFsmInitialized`**: Boolean indicating if FSM has been initialized
+ * - **`isTransitioning`**: Boolean indicating if a transition is in progress
+ * - **`allowedTransitions`**: Computed array of valid events for current state
+ * - **`transition(event)`**: Method to trigger state transitions
+ * - **`canTransition(event)`**: Check if a transition is valid from current state
+ * - **`isInState(state)`**: Check if currently in a specific state
+ * - **`stateHistory`**: Array of historical states (if trackHistory enabled)
+ *
+ * All properties are reactive and will automatically update UI components when state changes.
+ *
+ * @template TState Union type of valid state strings
+ * @template TEvent Union type of valid event strings
+ *
+ * @see {@link kosStateMachine} - The decorator function
+ * @see {@link KosStateMachineConfig} - Configuration interface
+ * @see {@link KosStateMachineOptions} - Options interface
+ */
+export interface KosStateMachineAware<TState extends string, TEvent extends string> {
+    /**
+     * Current state of the state machine.
+     * Observable property that updates automatically via @kosModel.
+     * Always initialized to the initial state immediately.
+     */
+    currentState: TState;
+    /**
+     * Indicates whether the state machine has been initialized.
+     * FSM initializes at the configured lifecycle phase (READY, ACTIVATE, etc.).
+     *
+     * - Before initialization: `false`, `currentState === undefined`
+     * - After initialization: `true`, `currentState === initial`
+     */
+    readonly isFsmInitialized: boolean;
+    /**
+     * Indicates whether a state transition is currently in progress.
+     * Observable property that updates during transitions.
+     */
+    isTransitioning: boolean;
+    /**
+     * Computed array of valid events that can be triggered from the current state.
+     * Updates automatically when state changes.
+     * Returns empty array if FSM is not initialized.
+     */
+    readonly allowedTransitions: TEvent[];
+    /**
+     * Trigger a state transition by event.
+     *
+     * @param event The event to trigger
+     * @throws Error if FSM not initialized (unless `throwOnInvalid` is false)
+     * @throws Error if transition is invalid (unless `throwOnInvalid` is false)
+     *
+     * @example
+     * ```typescript
+     * this.transition('START'); // idle -> active
+     * this.transition('STOP');  // active -> idle
+     * ```
+     */
+    transition(event: TEvent): void;
+    /**
+     * Check if a transition is valid from the current state.
+     * Returns false if FSM is not initialized.
+     *
+     * @param event The event to check
+     * @returns true if the transition is valid, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (this.canTransition('START')) {
+     *   this.transition('START');
+     * }
+     * ```
+     */
+    canTransition(event: TEvent): boolean;
+    /**
+     * Check if the state machine is currently in a specific state.
+     * Returns false if FSM is not initialized.
+     *
+     * @param state The state to check
+     * @returns true if currently in the specified state, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (this.isInState('idle')) {
+     *   console.log('System is idle');
+     * }
+     * ```
+     */
+    isInState(state: TState): boolean;
+    /**
+     * History of state transitions (if trackHistory is enabled).
+     * Each entry contains the state, timestamp, and optional event that caused the transition.
+     *
+     * Only available when `trackHistory: true` is set in options.
+     */
+    stateHistory?: Array<{
+        state: TState;
+        timestamp: Date;
+        event?: TEvent;
+    }>;
+}
+/**
+ * Class decorator that adds finite state machine capabilities to a KOS model.
+ *
+ * This decorator eliminates manual state management boilerplate by:
+ * - **Adding lifecycle-aware FSM initialization** at configured phase (READY, ACTIVATE, etc.)
+ * - **Managing state transitions** automatically with validation
+ * - **Providing observable state** that integrates with @kosModel reactive system
+ * - **Supporting entry/exit handlers** via @kosStateEntry and @kosStateExit decorators
+ * - **Enabling state guards** via @kosStateGuard decorator
+ *
+ * ## Two-Level State System
+ *
+ * **Framework Lifecycle (Universal, Not Customizable):**
+ * - CREATED → INIT → LOAD → READY → ACTIVATE → UNLOAD → DESTROY
+ * - Managed by KOS framework
+ * - Same for all models
+ *
+ * **Application FSM (This Decorator):**
+ * - Runs WITHIN an active model
+ * - Application-specific business logic
+ * - Different for each model type
+ * - Examples: Pour states, connection states, workflow states
+ *
+ * ## Lifecycle Integration
+ *
+ * The FSM initializes at the configured lifecycle phase:
+ *
+ * ```typescript
+ * @kosStateMachine({
+ *   initial: 'idle',
+ *   initializeAt: DependencyLifecycle.READY, // Default
+ *   states: { ... }
+ * })
+ * ```
+ *
+ * - **INIT**: FSM needs to be active during model initialization (rare)
+ * - **READY**: FSM operational as soon as data loaded (most common)
+ * - **ACTIVATE**: FSM only relevant when UI is active (UI-bound models)
+ *
+ * ## TypeScript Usage
+ *
+ * **IMPORTANT**: Use TypeScript interface merging to get proper type information:
+ *
+ * ```typescript
+ * type MyState = 'idle' | 'active';
+ * type MyEvent = 'START' | 'STOP';
+ *
+ * interface MyModelImpl extends KosStateMachineAware<MyState, MyEvent> {}
+ *
+ * @kosStateMachine<MyState, MyEvent>({ ... })
+ * class MyModelImpl implements IKosDataModel {
+ *   // All FSM properties are now available with full type safety
+ * }
+ * ```
+ *
+ * @param config State machine configuration
+ * @param options Optional configuration for FSM behavior
+ * @returns A class decorator that modifies the target class prototype
+ *
+ * @see {@link KosStateMachineAware} - Interface for TypeScript merging
+ * @see {@link KosStateMachineConfig} - Configuration interface
+ * @see {@link KosStateMachineOptions} - Options interface
+ *
+ * @example
+ * ```typescript
+ * // Basic FSM with default READY initialization
+ * type PourState = 'idle' | 'pouring' | 'complete';
+ * type PourEvent = 'START' | 'FINISH';
+ *
+ * interface PourModelImpl extends KosStateMachineAware<PourState, PourEvent> {}
+ *
+ * @kosModel({ modelTypeId: "pour-model" })
+ * @kosStateMachine<PourState, PourEvent>({
+ *   initial: 'idle',
+ *   states: {
+ *     idle: { on: { START: 'pouring' } },
+ *     pouring: { on: { FINISH: 'complete' } },
+ *     complete: {}
+ *   }
+ * })
+ * class PourModelImpl implements IKosDataModel {
+ *   async ready(): Promise<void> {
+ *     // After this completes, FSM is initialized to 'idle'
+ *   }
+ *
+ *   startPour(): void {
+ *     this.transition('START'); // idle -> pouring
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // UI-bound FSM with ACTIVATE initialization
+ * type WorkflowState = 'draft' | 'review' | 'approved';
+ * type WorkflowEvent = 'SUBMIT' | 'APPROVE' | 'REJECT';
+ *
+ * interface DocumentModelImpl extends KosStateMachineAware<WorkflowState, WorkflowEvent> {}
+ *
+ * @kosModel({ modelTypeId: "document-model" })
+ * @kosStateMachine<WorkflowState, WorkflowEvent>({
+ *   initial: 'draft',
+ *   initializeAt: DependencyLifecycle.ACTIVATE, // UI-bound
+ *   states: {
+ *     draft: { on: { SUBMIT: 'review' } },
+ *     review: { on: { APPROVE: 'approved', REJECT: 'draft' } },
+ *     approved: {}
+ *   }
+ * })
+ * class DocumentModelImpl implements IKosDataModel {
+ *   // FSM only initializes when UI activates this model
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // FSM with history tracking
+ * interface HistoryModelImpl extends KosStateMachineAware<'idle' | 'active', 'TOGGLE'> {}
+ *
+ * @kosStateMachine<'idle' | 'active', 'TOGGLE'>(
+ *   {
+ *     initial: 'idle',
+ *     states: {
+ *       idle: { on: { TOGGLE: 'active' } },
+ *       active: { on: { TOGGLE: 'idle' } }
+ *     }
+ *   },
+ *   {
+ *     trackHistory: true,
+ *     stateProperty: 'status'
+ *   }
+ * )
+ * class HistoryModelImpl implements IKosDataModel {
+ *   // Access via this.stateHistory
+ * }
+ * ```
+ *
+ * @category KOS Model Decorator
+ * @since 2.1.0
+ */
+export declare function kosStateMachine<TState extends string, TEvent extends string>(config: KosStateMachineConfig<TState, TEvent>, options?: KosStateMachineOptions): ClassDecorator;
+/**
+ * Method decorator that marks a method as a state entry handler.
+ * The decorated method will be called when the state machine enters the specified state.
+ *
+ * @param state The state to handle entry for
+ * @returns A method decorator
+ *
+ * @example
+ * ```typescript
+ * @kosStateEntry('pouring')
+ * handlePouringStart(): void {
+ *   this.logger.info('Pour started');
+ *   EventBus.publish(TOPIC_POUR_STARTED, { id: this.id });
+ * }
+ * ```
+ */
+export declare function kosStateEntry<TState extends string>(state: TState): MethodDecorator;
+/**
+ * Method decorator that marks a method as a state exit handler.
+ * The decorated method will be called when the state machine exits the specified state.
+ *
+ * @param state The state to handle exit for
+ * @returns A method decorator
+ *
+ * @example
+ * ```typescript
+ * @kosStateExit('pouring')
+ * handlePouringEnd(): void {
+ *   this.logger.info('Pour ended');
+ *   EventBus.publish(TOPIC_POUR_ENDED, { id: this.id });
+ * }
+ * ```
+ */
+export declare function kosStateExit<TState extends string>(state: TState): MethodDecorator;
+/**
+ * Options for @kosStateGuard decorator.
+ */
+export interface KosStateGuardOptions<TState extends string> {
+    /**
+     * Array of states in which the decorated method can be called.
+     * The method will throw an error (or log a warning) if called from any other state.
+     */
+    allowedStates: TState[];
+    /**
+     * Whether to throw an error on invalid state.
+     * When false, logs a warning instead.
+     *
+     * @default true (uses the FSM's throwOnInvalid setting)
+     */
+    throwOnInvalid?: boolean;
+}
+/**
+ * Method decorator that guards a method with state validation.
+ * The decorated method can only be called when the state machine is in one of the allowed states.
+ *
+ * **IMPORTANT**: This decorator gracefully handles uninitialized FSM:
+ * - If FSM is not yet initialized, the guard allows the method to proceed
+ * - Once FSM is initialized, the guard enforces state validation
+ *
+ * @param options Guard configuration
+ * @returns A method decorator
+ *
+ * @example
+ * ```typescript
+ * @kosStateGuard({ allowedStates: ['ready'] })
+ * async pourBeverage(bevId: string): Promise<void> {
+ *   // This method can only be called when currentState === 'ready'
+ *   this.transition('POUR');
+ *   await this.deviceService.dispense(bevId);
+ *   this.transition('COMPLETE');
+ * }
+ * ```
+ */
+export declare function kosStateGuard<TState extends string>(options: KosStateGuardOptions<TState>): MethodDecorator;
+//# sourceMappingURL=kos-state-machine.d.ts.map

package/core/core/decorators/kos-state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kos-state-machine.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-state-machine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASlD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,qBAAqB,CACpC,MAAM,SAAS,MAAM,EACrB,MAAM,SAAS,MAAM;IAErB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAEnC;;;;;;;;;;;;;OAaG;IACH,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;QACE;;;WAGG;QACH,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KACtC,CACF,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,MAAM,WAAW,oBAAoB,CACnC,MAAM,SAAS,MAAM,EACrB,MAAM,SAAS,MAAM;IAErB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAEtC;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAEtC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,IAAI,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2IG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,EAC1E,MAAM,EAAE,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7C,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAmBhB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,MAAM,SAAS,MAAM,EACjD,KAAK,EAAE,MAAM,GACZ,eAAe,CAUjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,MAAM,EAChD,KAAK,EAAE,MAAM,GACZ,eAAe,CAUjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,MAAM,SAAS,MAAM;IACzD;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,MAAM,SAAS,MAAM,EACjD,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACpC,eAAe,CAkDjB"}

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

@@ -1 +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"}
+{"version":3,"file":"kosModel.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kosModel.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAilB5C,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/kosTopicHandler.d.ts

@@ -1,5 +1,6 @@
 import { FlowControlOptions } from './kos-topic-handler-flow-control';
 import { IKosDataModel } from '../kosModel';
+import { BaselineDependency } from '../../types/service-response-store';
 import { DependencyLifecycle } from '../../types';
 import { ApiCallback } from '../../../common/events';
 
@@ -10,15 +11,15 @@ 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
+ * Zone 3: Parses wildcard segment from topic pattern and actual topic
  * @internal - exported for testing
  */
-export declare function extractTrailingWildcard(pattern: string, actualTopic: string, wildcardName?: string): Record<string, string>;
+export declare function parseWildcardSegment(pattern: string, actualTopic: string, wildcardName?: string): Record<string, string>;
 /**
- * Check if a topic pattern has a trailing wildcard
+ * Zone 3: Checks if topic pattern has trailing wildcard
  * @internal - exported for testing
  */
-export declare function hasTrailingWildcard(pattern: string): boolean;
+export declare function checkWildcardPattern(pattern: string): boolean;
 /**
  * Configuration parameters for defining a Kos topic handler function within a Kos Data Model class.
  *
@@ -153,6 +154,33 @@ export interface IKosTopicHandlerParams<Response = any, Model extends IKosDataMo
      * ```
      */
     flow?: FlowControlOptions<Response, TransformedResponse>;
+    /**
+     * Baseline dependency configuration for baseline-delta race condition handling.
+     * When specified, this handler will wait for the baseline service request to complete
+     * before processing events, and will intelligently replay queued events based on
+     * temporal comparison with the baseline request/response timing.
+     *
+     * @example
+     * ```typescript
+     * @kosTopicHandler({
+     *   topic: TOPIC_INGREDIENT_UPDATE,
+     *   websocket: true,
+     *   lifecycle: DependencyLifecycle.READY,
+     *   requiresBaseline: {
+     *     path: PATH_INGREDIENTS,
+     *     method: 'get',
+     *     replayStrategy: 'after-request'
+     *   }
+     * })
+     * handleIngredientUpdate(payload: IngredientUpdatePayload) {
+     *   // Framework guarantees:
+     *   // 1. Baseline loaded before this handler executes
+     *   // 2. Queued events replayed with temporal filtering
+     *   // 3. Only events newer than baseline are processed
+     * }
+     * ```
+     */
+    requiresBaseline?: BaselineDependency;
 }
 /**
  * Decorator for defining a Kos topic handler function within a Kos Data Model class.
@@ -216,5 +244,5 @@ export interface IKosTopicHandlerParams<Response = any, Model extends IKosDataMo
  * ```
  * @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;
+export declare function kosTopicHandler<Response = any, Model extends IKosDataModel = any, TransformedResponse = Response>(params: 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":"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"}
+{"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

@@ -17,4 +17,8 @@ export declare const FutureAliases: unique symbol;
 export declare const TroubleAwareSetup: unique symbol;
 export declare const LoggerSetup: unique symbol;
 export declare const ContainerAwareSetup: unique symbol;
+export declare const StateMachineSetup: unique symbol;
+export declare const StateEntryHandlers: unique symbol;
+export declare const StateExitHandlers: unique symbol;
+export declare const StateActionHandlers: unique symbol;
 //# sourceMappingURL=propKeys.d.ts.map

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

@@ -1 +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"}
+{"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;AACjE,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAC7D,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAC/D,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAC7D,eAAO,MAAM,mBAAmB,eAAgC,CAAC"}

package/core/core/kos-registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-registration.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/kos-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAIjC,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAuB/D,KAAK,GAAG,CACN,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IACpC,gCAAgC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAC3C,SAAS,EAAE,KAAK,CAAC;IACjB,OAAO,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACzC,CAAC;AACF,UAAU,iBAAiB,CACzB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACxB;AACD,UAAU,iBAAiB,CACzB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,GAAG,CAAC;CACzB;AACD,qBAAa,eAAe,CAC1B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,GAAG,CAAC;IACxB,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,CAAC;gBAC/D,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAMvE,IAAI,OAAO,kFAEV;IAED,IAAI,YAAY,IAAI,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAS1C;IAED,IAAI,SAAS,+BAEZ;CACF"}
+{"version":3,"file":"kos-registration.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/kos-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gCAAgC,EAIjC,MAAM,UAAU,CAAC;AAGlB,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAuBpE,KAAK,GAAG,CACN,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IACpC,gCAAgC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAC3C,SAAS,EAAE,KAAK,CAAC;IACjB,OAAO,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACzC,CAAC;AACF,UAAU,iBAAiB,CACzB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACxB;AACD,UAAU,iBAAiB,CACzB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,GAAG,CAAC;CACzB;AACD,qBAAa,eAAe,CAC1B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,GAAG,CAAC;IACxB,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,CAAC;gBAC/D,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAMvE,IAAI,OAAO,kFAEV;IAED,IAAI,YAAY,IAAI,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAS1C;IAED,IAAI,SAAS,+BAEZ;CACF"}

package/core/core/kos-singleton-registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-singleton-registration.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/kos-singleton-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kCAAkC,EAClC,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAqB/D,KAAK,GAAG,CACN,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IACpC,kCAAkC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAC7C,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACjC,CAAC;AACF,UAAU,SAAS,CACjB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACxB;AAED,UAAU,iBAAiB,CACzB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,GAAG,CAAC;CACzB;AACD,qBAAa,wBAAwB,CACnC,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,GAAG,CAAC;gBACZ,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAMvE,IAAI,OAAO,kEAEV;IAED,IAAI,YAAY,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CASlC;IAED,IAAI,SAAS,+BAEZ;CACF"}
+{"version":3,"file":"kos-singleton-registration.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/kos-singleton-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kCAAkC,EAClC,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAqBpE,KAAK,GAAG,CACN,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IACpC,kCAAkC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAC7C,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACjC,CAAC;AACF,UAAU,SAAS,CACjB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACxB;AAED,UAAU,iBAAiB,CACzB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,GAAG,CAAC;CACzB;AACD,qBAAa,wBAAwB,CACnC,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,GAAG,CAAC;gBACZ,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAMvE,IAAI,OAAO,kEAEV;IAED,IAAI,YAAY,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CASlC;IAED,IAAI,SAAS,+BAEZ;CACF"}

package/core/core/kosCore.d.ts.map

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

package/core/core/kosModel.d.ts

@@ -117,6 +117,8 @@ export declare class KosModel<DataDef extends IKosDataModel = IKosDataModel> imp
     effectManager?: KosEffectManager;
     httpRouteManager?: KosHttpRouteManager;
     onlineLifecycleManager?: KosOnlineLifecycleManager;
+    serviceResponses: any;
+    serviceRequestManager?: any;
     companionManager: KosCompanionModelManager;
     childResolver: KosChildResolver;
     fsm: KosFSMManager;
@@ -144,6 +146,18 @@ export declare class KosModel<DataDef extends IKosDataModel = IKosDataModel> imp
     unload(): Promise<void>;
     init(): Promise<void>;
     registerSubscribers(lifecycle?: DependencyLifecycle): Promise<void>;
+    /**
+     * Initialize the state machine for a specific lifecycle phase.
+     * Called from lifecycle hooks (init, load, ready, activate).
+     * @internal
+     */
+    initializeStateMachineForLifecycle(lifecycle: DependencyLifecycle): void;
+    /**
+     * Creates lifecycle-deferred companion models at the appropriate phase.
+     * Called from lifecycle hooks (init, load, ready, activate, online).
+     * @internal
+     */
+    private createLifecycleCompanions;
     online(): Promise<void>;
     offline(): Promise<void>;
     accept(visitor: IKosVisitor<IKosModel>): void;