@kosdev-code/kos-ui-sdk 2.0.44 → 2.0.45

package/core/core/decorators/kos-parent.d.ts

@@ -3,6 +3,10 @@ import { IKosDataModel } from '../kosModel';
 interface DecoratedKosModel<T extends IKosDataModel = IKosDataModel> {
     new (...args: any[]): T;
 }
+/**
+ * @kosService core.parent
+ * @kosApiLevel 2
+ */
 export interface KosParentProps {
     parentId?: string;
 }

package/core/core/decorators/kos-parent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-parent.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-parent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,UAAU,iBAAiB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IACjE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD,eAAO,MAAM,cAAc,sCACW,cAAc,mBACpC,kBAAkB,CAAC,CAAC,KAAG,GAIpC,CAAC"}
+{"version":3,"file":"kos-parent.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-parent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,UAAU,iBAAiB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IACjE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD,eAAO,MAAM,cAAc,sCACW,cAAc,mBACpC,kBAAkB,CAAC,CAAC,KAAG,GAOpC,CAAC"}

package/core/core/decorators/kos-reference.d.ts

@@ -1,6 +1,15 @@
+/**
+ * @kosService core.reference
+ * @kosApiLevel 2
+ */
 interface ReferenceProps {
     modelType: string;
 }
+/**
+ * @kosService core.reference
+ * @kosApiLevel 2
+ * @kosDeprecated {replacement: @kosDependency, removeAt: 3}
+ */
 export declare const kosReference: (props: ReferenceProps) => (target: {} | any, name: PropertyKey) => any;
 export {};
 //# sourceMappingURL=kos-reference.d.ts.map

package/core/core/decorators/kos-reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-reference.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-reference.ts"],"names":[],"mappings":"AAMA,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,YAAY,UACf,cAAc,cACb,EAAE,GAAG,GAAG,QAAQ,WAAW,KAAG,GAGtC,CAAC"}
+{"version":3,"file":"kos-reference.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-reference.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,UACf,cAAc,cACb,EAAE,GAAG,GAAG,QAAQ,WAAW,KAAG,GAItC,CAAC"}

package/core/core/decorators/kos-service-request-helpers.d.ts

@@ -0,0 +1,60 @@
+import { ErrorResponseContext } from '../../util/service-request-error';
+
+/**
+ * Helper functions for kosServiceRequest decorator.
+ *
+ * These functions are extracted to reduce complexity and improve maintainability
+ * of the service request decorator implementation.
+ */
+/**
+ * Resolves all parameters for a service request.
+ *
+ * This helper function handles the complex parameter resolution logic including:
+ * - Resolving PropKeys in path
+ * - Merging decorator-defined params with runtime params
+ * - Building the final API params object
+ *
+ * @param metadata - Service request metadata
+ * @param modelInstance - The model instance (this context)
+ * @param args - Original method arguments
+ * @param runtimeOptions - Runtime execution options
+ * @returns Resolved parameters for the API request
+ */
+export declare function resolveServiceRequestParameters(metadata: any, modelInstance: any, args: any[], runtimeOptions: any): {
+    resolvedPath: string;
+    apiParams: any;
+    finalBody: any;
+    finalRequestOptions: any;
+};
+/**
+ * Executes an API method with the appropriate HTTP verb.
+ *
+ * This helper function handles the complexity of method selection and execution,
+ * supporting GET, POST, PUT, and DELETE operations with proper parameter passing.
+ *
+ * @param API - The API client instance
+ * @param method - HTTP method (get, post, put, delete)
+ * @param path - Resolved API path
+ * @param params - API parameters (path, query)
+ * @param body - Request body (for POST, PUT, DELETE)
+ * @param requestOptions - Additional request options
+ * @returns Error-first tuple with response
+ */
+export declare function executeApiMethod(API: any, method: string | undefined, path: string, params: any, body: any, requestOptions: any): Promise<[string | null, any, ErrorResponseContext?]>;
+/**
+ * Handles service request errors according to the configured error handling strategy.
+ *
+ * This helper function implements the error handling strategies defined in metadata:
+ * - "throw": Return error tuple for caller to handle
+ * - "log": Log error and return default value
+ * - "ignore": Silently return default value
+ * - "default": Return default value
+ *
+ * @param error - Error message from API call
+ * @param response - API response (may contain status code)
+ * @param errorHandler - Error handler configuration from metadata
+ * @param modelInstance - The model instance (this context)
+ * @returns Error-first tuple with default value or error
+ */
+export declare function handleServiceRequestError(error: string, response: any, errorHandler: any, modelInstance: any, errorContext?: ErrorResponseContext): [string | null, any];
+//# sourceMappingURL=kos-service-request-helpers.d.ts.map

package/core/core/decorators/kos-service-request-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kos-service-request-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-service-request-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAM7E;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,GAAG,EACb,aAAa,EAAE,GAAG,EAClB,IAAI,EAAE,GAAG,EAAE,EACX,cAAc,EAAE,GAAG;;;;;EAgEpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,GAAG,EACX,IAAI,EAAE,GAAG,EACT,cAAc,EAAE,GAAG,GAClB,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAgBtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,GAAG,EACb,YAAY,EAAE,GAAG,EACjB,aAAa,EAAE,GAAG,EAClB,YAAY,CAAC,EAAE,oBAAoB,GAClC,CAAC,MAAM,GAAG,IAAI,EAAE,GAAG,CAAC,CAqCtB"}

package/core/core/decorators/kos-service-request.d.ts

@@ -0,0 +1,498 @@
+import { KosExecutionContext } from './kos-execution-context';
+import { KosModelRegistrationType } from '../registration/model-registration';
+import { IKosDataModel } from '../kosModel';
+import { ServiceRequestError } from '../../util/service-request-error';
+import { ClientBody, ClientParams } from '../../util/kos-service-request';
+import { KosFetchOptions } from '../../types/utils/kos-fetch';
+import { ResponseCacheConfig } from '../../types/service-response-store';
+import { DependencyLifecycle } from '../../types';
+
+/**
+ * @kosService core.service-request
+ */
+export type RequestOptions = Omit<KosFetchOptions, "method" | "body">;
+export type { KosExecutionContext };
+/**
+ * Symbol for storing service request handlers metadata on model instances
+ * @internal
+ */
+export declare const ServiceRequestHandlers: unique symbol;
+/**
+ * HTTP methods supported by kosServiceRequest
+ *
+ * @kosService core.service-request
+ */
+export type HttpMethod = "get" | "GET" | "post" | "POST" | "put" | "PUT" | "delete" | "DELETE" | "patch" | "PATCH";
+/**
+ * API path type - string representing an API endpoint
+ *
+ * @kosService core.service-request
+ */
+export type ApiPath = string;
+/**
+ * Configuration for field mapping in data transformation
+ *
+ * @kosService core.service-request
+ * @kosApiLevel 15
+ */
+export interface FieldMapping {
+    /**
+     * Source field path (dot notation supported, e.g., 'data.user.name')
+     */
+    from: string;
+    /**
+     * Target field name in the model
+     */
+    to: string;
+    /**
+     * Optional transformation to apply
+     * Built-in: 'string', 'number', 'boolean', 'date', 'json'
+     * Custom: function name or transformer function
+     */
+    transform?: string | ((value: any) => any);
+    /**
+     * Whether this field is required
+     */
+    required?: boolean;
+    /**
+     * Default value if field is missing
+     */
+    default?: any;
+}
+/**
+ * Configuration for extension points during transformation
+ *
+ * @kosService core.service-request
+ * @kosApiLevel 15
+ */
+export interface ExtensionConfig {
+    /**
+     * Type of extension point
+     */
+    type: "loader" | "data-mapper" | "validator";
+    /**
+     * Extension identifier (e.g., ExtensionType.IngredientMapper)
+     */
+    extension: any;
+    /**
+     * When to execute the extension
+     */
+    phase?: "before" | "after" | "transform";
+}
+/**
+ * Configuration for error handling in service requests.
+ *
+ * Provides multiple strategies for handling request failures, enabling soft failures
+ * with cached default values and error-first parameter patterns.
+ *
+ * @remarks
+ * All strategies except 'throw' cache defaultValue in the response store, ensuring
+ * consistency across model lifecycle. Lifecycle-triggered handlers receive error-first
+ * parameters: (error, data), while method-driven requests use $request executor
+ * returning tuple: [error, data].
+ *
+ * @example
+ * ```typescript
+ * // Soft failure with logging
+ * @kosServiceRequest({
+ *   path: '/api/data',
+ *   errorHandler: {
+ *     strategy: 'log',
+ *     defaultValue: []
+ *   }
+ * })
+ * async loadData(error: string | null, data: DataType[]): Promise<void> {
+ *   if (error) {
+ *     this.logger.error(`Load failed: ${error}`);
+ *   }
+ *   this.processData(data); // Either real data or defaultValue
+ * }
+ * ```
+ *
+ * @category Service Request
+ * @see {@link KosServiceRequestConfig} for complete decorator configuration
+ * @kosService core.service-request
+ * @kosApiLevel 15
+ */
+export interface ErrorHandlerConfig {
+    /**
+     * How to handle errors:
+     *
+     * - 'throw': Re-throw error (default) - handler not called, no caching
+     *
+     * - 'log': Log error, cache defaultValue, and call handler with (error, defaultValue)
+     *   Enables soft failure - log the error but continue processing with default data
+     *
+     * - 'ignore': Cache defaultValue and call handler with (error, defaultValue)
+     *   Soft failure without logging - silent recovery
+     *
+     * - 'default': Same as 'ignore' - cache defaultValue and call handler
+     *   (Kept for backward compatibility, behaves identically to 'ignore')
+     *
+     * All strategies except 'throw' cache defaultValue in response store for consistency.
+     *
+     * Note: For lifecycle requests, handler receives error-first parameters: (error, data)
+     *       For method-driven requests, $request executor returns tuple: [error, data]
+     */
+    strategy: "throw" | "log" | "ignore" | "default";
+    /**
+     * Default value to use when an error occurs.
+     * Used with 'log', 'ignore', or 'default' strategies.
+     * - Stored in response cache for subsequent access
+     * - Passed to handler as second parameter: handler(errorMessage, defaultValue)
+     */
+    defaultValue?: any;
+    /**
+     * Custom error handler function called when a request fails.
+     *
+     * When the failure is an HTTP error response, `error` will be a
+     * {@link ServiceRequestError} instance with `status`, `statusText`,
+     * `responseBody`, and `responseHeaders` properties.
+     *
+     * For non-HTTP failures (network errors, timeouts), `error` is a
+     * plain `Error`.
+     *
+     * @example
+     * ```typescript
+     * onError: (error, model) => {
+     *   if (error instanceof ServiceRequestError) {
+     *     console.error(`HTTP ${error.status}`, error.responseBody, error.responseHeaders);
+     *   }
+     * }
+     * ```
+     */
+    onError?: (error: Error | ServiceRequestError, model: IKosDataModel) => void;
+}
+/**
+ * Configuration parameters for @kosServiceRequest decorator
+ * Enables lifecycle-driven HTTP requests with declarative data transformation
+ *
+ * @typeparam Paths - The OpenAPI paths type (from your OpenAPI schema)
+ * @typeparam Path - The specific API path being requested
+ * @typeparam Method - The HTTP method type
+ * @typeparam Response - The raw response type from the API
+ * @typeparam TransformedResponse - The transformed response type after mappings
+ *
+ * @kosService core.service-request
+ * @kosApiLevel 15
+ */
+export interface IKosServiceRequestParams<Paths extends Record<string, any> = Record<string, any>, Path extends keyof Paths = string, Method extends HttpMethod = "get", Response = any, TransformedResponse = Response> {
+    /**
+     * API path to request
+     *
+     * @example
+     * path: '/api/kos/ingredients'
+     * path: `/api/devices/${PROP_DEVICE_ID}/status` // with PropKey
+     */
+    path: Path;
+    /**
+     * HTTP method
+     *
+     * @default 'get'
+     */
+    method?: Method;
+    /**
+     * When to execute this request during model lifecycle
+     *
+     * If omitted, the request executes when the decorated method is called (method-driven).
+     * If specified, the request executes automatically during the given lifecycle phase (lifecycle-driven).
+     *
+     * @example
+     * // Lifecycle-driven (auto-execute during LOAD phase)
+     * lifecycle: DependencyLifecycle.LOAD
+     *
+     * @example
+     * // Method-driven (execute when method is called)
+     * lifecycle: undefined  // or omit entirely
+     */
+    lifecycle?: DependencyLifecycle;
+    /**
+     * Path parameters to expand in the URL
+     * Strongly typed from OpenAPI schema
+     * Can be static values or PropKey references
+     *
+     * @example
+     * // Static value
+     * pathParams: { deviceId: 'device-123' }
+     *
+     * @example
+     * // PropKey reference (use PROP_ prefix)
+     * pathParams: { deviceId: PROP_DEVICE_ID }
+     *
+     * @example
+     * // Dynamic from method arguments
+     * pathParams: (model, deviceId, status) => ({ deviceId })
+     */
+    pathParams?: (ClientParams<Paths, Path, Method> extends {
+        path?: infer P;
+    } ? P : never) | ((model: IKosDataModel, ...args: any[]) => ClientParams<Paths, Path, Method> extends {
+        path?: infer P;
+    } ? P : never);
+    /**
+     * Query parameters
+     * Strongly typed from OpenAPI schema
+     *
+     * @example
+     * // Static
+     * queryParams: { includeMetadata: true, format: 'json' }
+     *
+     * @example
+     * // Dynamic from method arguments
+     * queryParams: (model, deviceId, debug) => ({ debug })
+     */
+    queryParams?: (ClientParams<Paths, Path, Method> extends {
+        query?: infer Q;
+    } ? Q : never) | ((model: IKosDataModel, ...args: any[]) => ClientParams<Paths, Path, Method> extends {
+        query?: infer Q;
+    } ? Q : never);
+    /**
+     * Request body (for POST/PUT/PATCH)
+     * Strongly typed from OpenAPI schema
+     *
+     * @example
+     * // Static body
+     * body: { action: 'start' }
+     *
+     * @example
+     * // Dynamic from method arguments
+     * body: (model, vehicleType, speed) => ({ vehicleType, speed })
+     */
+    body?: ClientBody<Paths, Path, Method> | ((model: IKosDataModel, ...args: any[]) => ClientBody<Paths, Path, Method>);
+    /**
+     * JSON path to iterate over in response
+     * Creates models for each item in the array
+     *
+     * @example
+     * iterateOver: 'data.ingredients' // Iterates response.data.ingredients array
+     */
+    iterateOver?: string;
+    /**
+     * Model registration object for creating instances from array items
+     * Used with iterateOver to create child models using the builder pattern
+     *
+     * @example
+     * modelFactory: IngredientModel  // The registration object itself
+     *
+     * deprecated The old curried function signature is deprecated:
+     * modelFactory?: (id: string) => (options: any) => IKosDataModel
+     */
+    modelFactory?: KosModelRegistrationType<IKosDataModel, Record<string, unknown>> | ((id: string) => (options: unknown) => IKosDataModel);
+    /**
+     * Function to extract the model ID from response data items
+     * Required when using modelFactory if items don't have an 'id' field
+     *
+     * @example
+     * idExtractor: (item) => item.ingredientId
+     * idExtractor: (item) => `${item.type}-${item.index}`
+     */
+    idExtractor?: (item: any) => string;
+    /**
+     * Field mappings for data transformation
+     * Same format as @kosTopicHandler mappings
+     *
+     * @example
+     * mappings: [
+     *   { from: 'id', to: 'id' },
+     *   { from: 'ingredientId', to: 'ingredientId' },
+     *   { from: 'metadata.calories', to: 'calories', transform: 'number' }
+     * ]
+     */
+    mappings?: FieldMapping[];
+    /**
+     * Extension points to execute during transformation
+     *
+     * @example
+     * extensions: [
+     *   { type: 'data-mapper', extension: ExtensionType.IngredientMapper }
+     * ]
+     */
+    extensions?: ExtensionConfig[];
+    /**
+     * Transformation function for response data
+     * Applied before mappings
+     *
+     * @example
+     * transform: (response) => response.data
+     */
+    transform?: (response: Response) => TransformedResponse;
+    /**
+     * Condition to determine if request should execute
+     *
+     * @example
+     * condition: (model) => model.isInitialized
+     */
+    condition?: (model: IKosDataModel) => boolean;
+    /**
+     * Error handling strategy
+     *
+     * @example
+     * errorHandler: {
+     *   strategy: 'default',
+     *   defaultValue: [],
+     *   onError: (error, model) => model.logger.error('Failed to load', error)
+     * }
+     */
+    errorHandler?: ErrorHandlerConfig;
+    /**
+     * Response caching configuration
+     * Controls how long responses are stored and when they're cleaned up
+     *
+     * @default { retention: ResponseRetention.SINGLE }
+     *
+     * @example
+     * // No caching - clear immediately after handler
+     * cache: { retention: ResponseRetention.IMMEDIATE }
+     *
+     * @example
+     * // Cache for 5 minutes
+     * cache: { retention: ResponseRetention.TTL, ttl: 5 * 60 * 1000 }
+     *
+     * @example
+     * // Keep for model lifetime
+     * cache: { retention: ResponseRetention.PERMANENT }
+     */
+    cache?: ResponseCacheConfig;
+    /**
+     * Request options for controlling fetch behavior
+     * These are merged with runtime options passed to ctx.$request()
+     * Runtime options take precedence over decorator options
+     *
+     * @example
+     * // Set default timeout and destination for all requests
+     * requestOptions: {
+     *   destinationAddress: 'device-123',
+     *   timeout: 10000
+     * }
+     *
+     * @example
+     * // Dynamic from method arguments
+     * requestOptions: (model, ...args) => ({
+     *   destinationAddress: model.deviceId,
+     *   headers: { 'X-Session': model.sessionId }
+     * })
+     * @kosApiLevel 18
+     */
+    requestOptions?: RequestOptions | ((model: IKosDataModel, ...args: any[]) => RequestOptions);
+}
+/**
+ * Metadata stored for each service request handler
+ * @internal
+ */
+export interface ServiceRequestMetadata<Paths extends Record<string, any> = Record<string, any>, Path extends keyof Paths = string, Method extends HttpMethod = "get", Response = any, TransformedResponse = Response> extends IKosServiceRequestParams<Paths, Path, Method, Response, TransformedResponse> {
+    /**
+     * The method name that handles the response
+     */
+    handlerMethod: string;
+    /**
+     * The original handler function
+     */
+    originalHandler: Function;
+}
+/**
+ * Runtime service request executor injected into method context
+ * Allows imperative execution of the service request defined by the decorator
+ *
+ * @kosService core.service-request
+ */
+export interface ServiceRequestExecutor<Paths extends Record<string, any> = Record<string, any>, Path extends keyof Paths = string, Method extends HttpMethod = "get"> {
+    (options?: {
+        pathParams?: ClientParams<Paths, Path, Method> extends {
+            path?: infer P;
+        } ? P : never;
+        queryParams?: ClientParams<Paths, Path, Method> extends {
+            query?: infer Q;
+        } ? Q : never;
+        body?: ClientBody<Paths, Path, Method>;
+        requestOptions?: RequestOptions;
+    }): Promise<[string | null, any]>;
+}
+/**
+ * Type alias for the service request executor function signature.
+ * This executor is automatically passed as the last parameter to methods
+ * decorated with @kosServiceRequest (without lifecycle).
+ *
+ * @example
+ * ```typescript
+ * type CreateReleaseExecutor = ServiceRequestExecutor<paths, typeof PATH_VM_INSTALL, 'post'>;
+ * ```
+ *
+ * @kosService core.service-request
+ */
+export type ServiceRequestExecutorFn<Paths extends Record<string, any> = Record<string, any>, Path extends keyof Paths = string, Method extends HttpMethod = "get"> = ServiceRequestExecutor<Paths, Path, Method>;
+/**
+ * Decorator for lifecycle-driven service requests within KOS models
+ *
+ * Eliminates service boilerplate by integrating HTTP requests directly into
+ * the model lifecycle. Responses are cached in ServiceResponseStore for access
+ * via utility functions, avoiding "magic last parameter" patterns.
+ *
+ * @param params - Configuration for the service request
+ * @returns Method decorator
+ *
+ * @example Basic GET request during LOAD
+ * ```typescript
+ * @kosServiceRequest({
+ *   path: PATH_DEVICE_STATUS,
+ *   method: 'get',
+ *   lifecycle: DependencyLifecycle.LOAD,
+ *   cache: { retention: ResponseRetention.SINGLE }
+ * })
+ * private onStatusLoaded(): void {
+ *   const response = getServiceResponse(this, PATH_DEVICE_STATUS, 'get');
+ *   this.status = response?.status;
+ * }
+ * ```
+ *
+ * @example Method-driven request with execution context
+ * ```typescript
+ * @kosServiceRequest({
+ *   path: PATH_VM_INSTALL,
+ *   method: 'post',
+ *   requestOptions: {
+ *     timeout: 10000  // Decorator-level default timeout
+ *   }
+ * })
+ * async createRelease(
+ *   path: string,
+ *   keysetId?: string,
+ *   ctx: KosExecutionContext<paths, typeof PATH_VM_INSTALL, 'post'>
+ * ): Promise<void> {
+ *   const [error, response] = await ctx.$request({
+ *     queryParams: { keySetId: keysetId },
+ *     body: { path },
+ *     requestOptions: {
+ *       destinationAddress: 'device-123',  // Runtime options merged with decorator options
+ *       headers: { 'X-Custom-Header': 'value' }
+ *     }
+ *   });
+ *   if (error) throw new Error(error);
+ *   return response?.data;
+ * }
+ * ```
+ *
+ * @example Container model with iteration
+ * ```typescript
+ * @kosServiceRequest({
+ *   path: PATH_INGREDIENTS,
+ *   method: 'get',
+ *   lifecycle: DependencyLifecycle.LOAD,
+ *   iterateOver: 'data.ingredients',
+ *   modelFactory: Ingredient.factory,
+ *   mappings: [
+ *     { from: 'id', to: 'id' },
+ *     { from: 'name', to: 'name' }
+ *   ]
+ * })
+ * private onIngredientsLoaded(): void {
+ *   const response = getServiceResponse(this, PATH_INGREDIENTS, 'get');
+ *   // Mappings already applied to response data
+ *   response?.forEach(i => this.ingredients.addModel(i));
+ * }
+ * ```
+ *
+ * @category KOS Model Decorator
+ * @kosService core.service-request
+ * @kosApiLevel 15
+ */
+export declare function kosServiceRequest<Paths extends Record<string, any> = Record<string, any>, Path extends keyof Paths = string, Method extends HttpMethod = "get", Response = any, TransformedResponse = Response>(params: IKosServiceRequestParams<Paths, Path, Method, Response, TransformedResponse>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=kos-service-request.d.ts.map

package/core/core/decorators/kos-service-request.d.ts.map

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