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

package/core/core/model/service-response-store.d.ts

@@ -0,0 +1,140 @@
+import { ResponseCacheConfig } from '../../types/service-response-store';
+
+/**
+ * ServiceResponseStore manages keyed storage of service responses with flexible retention policies.
+ *
+ * Responses are stored by `{method}:{path}` key (e.g., 'GET:/api/ingredients')
+ * and can be configured with different retention policies to control caching behavior.
+ *
+ * @example
+ * const store = new ServiceResponseStore();
+ *
+ * // Store with TTL (replaces on each request)
+ * store.set('GET:/api/status', statusData, {
+ *   retention: ResponseRetention.TTL,
+ *   ttl: 5 * 60 * 1000
+ * });
+ *
+ * // Store with TTL extension (keeps existing data, extends TTL)
+ * const stored = store.set('GET:/api/expensive', expensiveData, {
+ *   retention: ResponseRetention.TTL,
+ *   ttl: 5 * 60 * 1000,
+ *   extendOnRefresh: true
+ * });
+ * // stored === false if cache was extended, true if new data stored
+ *
+ * // Retrieve
+ * const status = store.get('GET:/api/status');
+ */
+export declare class ServiceResponseStore {
+    private responses;
+    private retentionPolicies;
+    private cleanupTimers;
+    /**
+     * Store a response with retention policy
+     *
+     * @param key - Storage key (typically `{method}:{path}`)
+     * @param response - Response data to cache
+     * @param config - Caching configuration (defaults to SINGLE retention)
+     * @returns true if response was stored, false if refresh extended existing TTL
+     */
+    set<T>(key: string, response: T, config?: ResponseCacheConfig): boolean;
+    /**
+     * Get response if not expired
+     *
+     * @param key - Storage key
+     * @returns Response data or undefined if not found/expired
+     */
+    get<T = any>(key: string): T | undefined;
+    /**
+     * Get response by path and method
+     *
+     * @param path - API path
+     * @param method - HTTP method (defaults to 'get')
+     * @returns Response data or undefined if not found/expired
+     */
+    getByPath<T = any>(path: string, method?: string): T | undefined;
+    /**
+     * Check if response exists and is not expired
+     *
+     * @param key - Storage key
+     * @returns true if valid response exists
+     */
+    has(key: string): boolean;
+    /**
+     * Manually delete a response
+     *
+     * @param key - Storage key
+     */
+    delete(key: string): void;
+    /**
+     * Clear all responses for a path (all methods)
+     *
+     * @param path - API path to clear
+     */
+    clearPath(path: string): void;
+    /**
+     * Clear all responses
+     */
+    clear(): void;
+    /**
+     * Get count of cached responses
+     */
+    get size(): number;
+    /**
+     * Check if a response should be cleaned up after handler completes
+     *
+     * @param key - Storage key
+     * @returns true if response has IMMEDIATE retention policy
+     */
+    shouldCleanupAfterHandler(key: string): boolean;
+    /**
+     * Zone 2: Evaluates if TTL should be extended instead of replacing data
+     */
+    private shouldExtendTTL;
+    /**
+     * Extend TTL for existing cached response
+     */
+    private extendExistingTTL;
+    /**
+     * Zone 3: Reset cleanup timer for a cached response
+     */
+    private resetCleanupTimer;
+    /**
+     * Clear cleanup timer if it exists
+     */
+    private clearTimerIfExists;
+    /**
+     * Create cached response object with metadata
+     */
+    private createCachedResponse;
+    /**
+     * Calculate expiration timestamp based on config
+     */
+    private calculateExpiresAt;
+    /**
+     * Store response with retention policy
+     */
+    private storeResponse;
+    /**
+     * Zone 2: Configures retention policy for a stored response
+     */
+    private applyRetentionPolicy;
+    /**
+     * Make storage key from path and method
+     */
+    private makeKey;
+    /**
+     * Extract path from storage key
+     */
+    private extractPath;
+    /**
+     * Extract method from storage key
+     */
+    private extractMethod;
+    /**
+     * Cleanup expired responses (called periodically if needed)
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=service-response-store.d.ts.map

package/core/core/model/service-response-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-response-store.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/model/service-response-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EAEpB,MAAM,oCAAoC,CAAC;AAmD5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,aAAa,CAAqC;IAE1D;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,EACH,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,EACX,MAAM,GAAE,mBAA6D,GACpE,OAAO;IAWV;;;;;OAKG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAcxC;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,CAAC,GAAG,SAAS;IAI/D;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAWzB;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK/C;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/core/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from './model';
 export * from './utils/kos-fetch';
 export * from './kos-dependency';
+export * from './service-response-store';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC"}

package/core/types/service-response-store.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Response retention policies for ServiceResponseStore
+ * Controls how long service responses are cached and when they're cleaned up
+ */
+export declare enum ResponseRetention {
+    /**
+     * Clear immediately after handler completes
+     * Use for one-time operations with no caching needs
+     *
+     * Note: Response remains available during handler execution (including async handlers).
+     * Cleanup happens AFTER the handler returns/resolves via ServiceRequestManager.
+     */
+    IMMEDIATE = "immediate",
+    /**
+     * Keep until next response for same path
+     * Default behavior - previous response replaced on new request
+     */
+    SINGLE = "single",
+    /**
+     * Keep for specified duration (ms)
+     * Automatic cleanup after TTL expires
+     */
+    TTL = "ttl",
+    /**
+     * Keep until model is destroyed
+     * Use for data needed throughout model lifetime
+     */
+    PERMANENT = "permanent",
+    /**
+     * Keep until explicitly cleared
+     * Manual cleanup required via clearServiceResponse()
+     */
+    MANUAL = "manual"
+}
+/**
+ * Configuration for response caching behavior
+ */
+export interface ResponseCacheConfig {
+    /**
+     * Retention policy determining when response is cleaned up
+     */
+    retention: ResponseRetention;
+    /**
+     * Time-to-live in milliseconds (required for TTL retention)
+     */
+    ttl?: number;
+    /**
+     * For TTL retention: extend TTL instead of replacing data on new request
+     *
+     * When false (default): New request clears old data and stores new data with fresh TTL
+     * When true: If cached data exists and hasn't expired, extend TTL without replacing data
+     *
+     * Use extendOnRefresh=true to avoid re-running expensive operations when cached data is still valid.
+     *
+     * @default false
+     *
+     * @example
+     * // Replace on each request (default)
+     * cache: { retention: ResponseRetention.TTL, ttl: 5 * 60 * 1000 }
+     *
+     * @example
+     * // Extend TTL on refresh - avoid re-fetching if cache valid
+     * cache: { retention: ResponseRetention.TTL, ttl: 5 * 60 * 1000, extendOnRefresh: true }
+     */
+    extendOnRefresh?: boolean;
+    /**
+     * Maximum number of responses to cache per path (future use)
+     */
+    maxSize?: number;
+}
+/**
+ * Cached response with metadata
+ */
+export interface CachedResponse<T = any> {
+    /**
+     * The response data
+     */
+    data: T;
+    /**
+     * When the response was cached (timestamp)
+     */
+    timestamp: number;
+    /**
+     * The API path this response came from
+     */
+    path: string;
+    /**
+     * The HTTP method used
+     */
+    method: string;
+    /**
+     * When this response expires (for TTL retention)
+     */
+    expiresAt?: number;
+}
+//# sourceMappingURL=service-response-store.d.ts.map

package/core/types/service-response-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-response-store.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/service-response-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,iBAAiB;IAC3B;;;;;;OAMG;IACH,SAAS,cAAc;IAEvB;;;OAGG;IACH,MAAM,WAAW;IAEjB;;;OAGG;IACH,GAAG,QAAQ;IAEX;;;OAGG;IACH,SAAS,cAAc;IAEvB;;;OAGG;IACH,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,EAAE,iBAAiB,CAAC;IAE7B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,GAAG;IACrC;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/core/util/index.d.ts

@@ -26,6 +26,7 @@ export * from './paired-client-heartbeat';
 export * from './pipe';
 export * from './retry-with-exponential-backoff';
 export * from './service-factory';
+export * from './service-response';
 export * from './session-utils';
 export * from './wait-for-request';
 export * from './when-ready';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,kCAAkC,CAAC;AACjD,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

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

@@ -49,6 +49,14 @@ export type ClientResponse<Paths extends Record<string, any>, K extends keyof Pa
         };
     };
 } ? R[keyof R] : unknown;
+export type ClientParams<Paths extends Record<string, any>, K extends keyof Paths, M extends AvailableMethods<Paths[K]> | string> = Paths[K][M] extends {
+    parameters: infer P;
+} ? P : never;
+export type ClientBody<Paths extends Record<string, any>, K extends keyof Paths, M extends AvailableMethods<Paths[K]> | string> = Paths[K][M] extends {
+    requestBody: {
+        content: infer B;
+    };
+} ? B[keyof B] : never;
 export type ServiceResponse<T> = [string, null] | [null, T];
 export type DeepRequired<T> = {
     [K in keyof T]-?: T[K] extends object ? DeepRequired<T[K]> : T[K];

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

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

package/core/util/service-response.d.ts

@@ -0,0 +1,110 @@
+import { IKosDataModel } from '../core/kosModel';
+import { ApiPath, HttpMethod } from '../core/decorators/kos-service-request';
+
+/**
+ * Utility functions for accessing cached service responses from ServiceResponseStore
+ *
+ * These functions provide type-safe access to responses stored by @kosServiceRequest
+ * decorated methods, eliminating the need for "magic last parameter" patterns.
+ *
+ * @example
+ * ```typescript
+ * @kosServiceRequest({
+ *   path: PATH_INGREDIENTS,
+ *   method: 'get',
+ *   lifecycle: DependencyLifecycle.LOAD
+ * })
+ * private onIngredientsLoaded(): void {
+ *   const response = getServiceResponse(this, PATH_INGREDIENTS, 'get');
+ *   this.processIngredients(response.data.ingredients);
+ * }
+ * ```
+ */
+/**
+ * Get cached service response by path and method
+ *
+ * Returns the response data cached by @kosServiceRequest decorated methods.
+ * TypeScript will infer types from your OpenAPI schema when using typed path constants.
+ *
+ * For cross-package scenarios where OpenAPI specs differ, you can optionally
+ * provide an explicit type parameter.
+ *
+ * @param model - The KOS model instance
+ * @param path - The API path constant
+ * @param method - The HTTP method (defaults to 'get')
+ * @returns The cached response data, or undefined if not found/expired
+ *
+ * @example Standard usage (types inferred from OpenAPI)
+ * ```typescript
+ * const status = getServiceResponse(this, PATH_DEVICE_STATUS, 'get');
+ * // TypeScript infers the type from PATH_DEVICE_STATUS
+ * ```
+ *
+ * @example Cross-package usage with explicit type (when OpenAPI schemas differ)
+ * ```typescript
+ * // Studio models using different OpenAPI than main SDK
+ * const vms = getServiceResponse<StudioVMResponse>(this, PATH_VMS, 'get');
+ * ```
+ */
+export declare function getServiceResponse<T = any>(model: IKosDataModel, path: ApiPath, method?: HttpMethod): T | undefined;
+/**
+ * Check if a cached response exists for the given path and method
+ *
+ * @param model - The KOS model instance
+ * @param path - The API path constant
+ * @param method - The HTTP method (defaults to 'get')
+ * @returns true if a valid cached response exists
+ *
+ * @example
+ * ```typescript
+ * if (hasCachedResponse(this, PATH_DEVICE_STATUS, 'get')) {
+ *   // Use cached data
+ *   const status = getServiceResponse(this, PATH_DEVICE_STATUS, 'get');
+ * } else {
+ *   // Fetch fresh data
+ *   await this.refreshStatus();
+ * }
+ * ```
+ */
+export declare function hasCachedResponse(model: IKosDataModel, path: ApiPath, method?: HttpMethod): boolean;
+/**
+ * Manually clear a cached service response
+ *
+ * @param model - The KOS model instance
+ * @param path - The API path constant
+ * @param method - The HTTP method (defaults to 'get')
+ *
+ * @example
+ * ```typescript
+ * // Clear cached response to force refresh on next request
+ * clearServiceResponse(this, PATH_TEMP_DATA, 'post');
+ * ```
+ */
+export declare function clearServiceResponse(model: IKosDataModel, path: ApiPath, method?: HttpMethod): void;
+/**
+ * Clear all cached responses for a specific path (all methods)
+ *
+ * @param model - The KOS model instance
+ * @param path - The API path constant
+ *
+ * @example
+ * ```typescript
+ * // Clear all cached responses for this endpoint
+ * clearPath(this, PATH_INGREDIENTS);
+ * // Clears GET, POST, PUT, DELETE responses for this path
+ * ```
+ */
+export declare function clearPath(model: IKosDataModel, path: ApiPath): void;
+/**
+ * Clear all cached service responses in the model
+ *
+ * @param model - The KOS model instance
+ *
+ * @example
+ * ```typescript
+ * // Clear all cached responses (typically during model cleanup)
+ * clearAllServiceResponses(this);
+ * ```
+ */
+export declare function clearAllServiceResponses(model: IKosDataModel): void;
+//# sourceMappingURL=service-response.d.ts.map

package/core/util/service-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-response.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/service-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACX,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EACxC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,CAAC,GAAG,SAAS,CAOf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,OAAO,CAOT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,UAAkB,GACzB,IAAI,CAON;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAOnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAOnE"}