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

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

@@ -4,23 +4,276 @@ import { IKosModelContainer } from '../core/kos-container-model';
 interface Identifiable {
     id: string;
 }
-export type IdMapper = <D extends Identifiable = Identifiable>(entity: D) => D;
+/**
+ * Function that transforms an entity's ID before container synchronization.
+ *
+ * The IdMapper pattern enables two critical capabilities:
+ *
+ * 1. **Compound Model IDs**: Transform simple backend IDs into compound IDs that include
+ *    parent context (e.g., `"123"` → `"release-version-abc-123"`). This ensures unique
+ *    model IDs even when backend IDs are only unique within their parent scope.
+ *
+ * 2. **Backend ID Preservation**: Add a `rawId` property to preserve the original backend ID
+ *    for server communication while using compound IDs for model identity.
+ *
+ * @template D - Input entity type (data from backend)
+ * @template M - Mapped entity type (data after transformation, defaults to D if no transformation)
+ *
+ * @example Simple ID prefix transformation
+ * ```typescript
+ * const idMapper: IdMapper<User, User & { rawId: string }> = (user) => ({
+ *   ...user,
+ *   rawId: user.id,
+ *   id: `user-${user.id}`
+ * });
+ * ```
+ *
+ * @example Compound ID with parent context
+ * ```typescript
+ * type WithRawId<T> = T & { rawId: string };
+ *
+ * const idMapper: IdMapper<VersionResponse, WithRawId<VersionResponse>> = (version) => ({
+ *   ...version,
+ *   rawId: version.id,
+ *   id: `release-version-${templateId}-${version.id}`
+ * });
+ * ```
+ *
+ * @example Multi-level compound ID
+ * ```typescript
+ * const idMapper: IdMapper<CandidateResponse, WithRawId<CandidateResponse>> = (candidate) => ({
+ *   ...candidate,
+ *   rawId: candidate.id,
+ *   id: `release-candidate-${templateId}-${versionId}-${candidate.id}`
+ * });
+ * ```
+ *
+ * @kosService core.container-utils
+ */
+export type IdMapper<D extends Identifiable = Identifiable, M extends Identifiable = D> = (entity: D) => M;
 type Container = IKosContainerModel<any, any> | IKosModelContainer<any>;
-interface ResolveParams<T extends Container, D> {
+/**
+ * Parameters for resolving container deltas.
+ * @template T - The container type
+ * @template D - The input entity type with an id property
+ * @template M - The mapped entity type (after idMapper transformation)
+ */
+interface ResolveParams<T extends Container, D extends Identifiable, M extends Identifiable = D> {
+    /** The container to synchronize */
     container: T;
-    onAddItem: (entity: D) => any;
-    onRemoveItem: (id: string) => any;
-    idMapper?: IdMapper;
+    /** Callback to create a new item when an entity is added */
+    onAddItem: (entity: M) => any;
+    /** Optional callback when an item is removed, receives the id to remove */
+    onRemoveItem?: (id: string) => any;
+    /** Optional callback when an existing item needs updating */
+    onUpdateItem?: (entity: M, existingModel: any) => any;
+    /** Optional mapper to transform entity ids before processing */
+    idMapper?: IdMapper<D, M>;
 }
-export declare const resolveContainerDeltas: <T extends IKosModelContainer<any>, D extends Identifiable>({ container, onAddItem, onRemoveItem, idMapper, }: ResolveParams<T, D>) => (entities: D[]) => void;
-export declare const resolveListDeltas: <T extends IKosContainerModel<any, any>, D extends Identifiable>({ container, onAddItem, onRemoveItem, idMapper, }: ResolveParams<T, D>) => (entities: D[]) => void;
-interface ResolveItemsParams<T extends Identifiable, D> {
+/**
+ * Creates a function that synchronizes a container with a new list of entities.
+ *
+ * This is the primary utility for delta-based container synchronization. It compares incoming
+ * data against the current container state and performs minimal operations (add/update/remove)
+ * to achieve synchronization.
+ *
+ * Key features:
+ * - **Delta resolution**: Only processes actual changes (add/update/remove)
+ * - **ID transformation**: Optional `idMapper` transforms backend IDs to model IDs
+ * - **Update-in-place**: `onUpdateItem` can update existing models without recreating
+ * - **Type safety**: Generic type parameters ensure type consistency through transformation
+ *
+ * Workflow:
+ * 1. Apply `idMapper` to transform entity IDs (if provided)
+ * 2. Calculate deltas: which IDs are missing from new data (removals)
+ * 3. Invoke `onRemoveItem` for each ID to remove
+ * 4. For each entity in new data:
+ *    - If model exists: invoke `onUpdateItem` (if provided) or `onAddItem`
+ *    - If model doesn't exist: invoke `onAddItem`
+ * 5. Add all new models to container in batch
+ *
+ * @template T - Container type implementing IKosModelContainer
+ * @template D - Input entity type (data from backend)
+ * @template M - Mapped entity type (after idMapper transformation, defaults to D)
+ *
+ * @param params - Configuration for resolving deltas
+ * @param params.container - The container to synchronize
+ * @param params.onAddItem - Callback to create a new model from entity data
+ * @param params.onUpdateItem - Optional callback to update existing model (return null to skip adding)
+ * @param params.onRemoveItem - Optional callback invoked with each ID to remove (default: identity function)
+ * @param params.idMapper - Optional function to transform entity IDs before processing
+ *
+ * @returns A function that accepts entities and synchronizes the container
+ *
+ * @kosService core.container-utils
+ *
+ * @example Basic synchronization without ID transformation
+ * ```typescript
+ * const syncUsers = resolveContainerDeltas({
+ *   container: userContainer,
+ *   onAddItem: (user) => User.instance(user.id).options(user).build(),
+ *   onUpdateItem: (user, existing) => {
+ *     existing.updateModel(user);
+ *     return null; // Don't add, just updated in place
+ *   },
+ *   onRemoveItem: (id) => id
+ * });
+ * syncUsers(newUserList);
+ * ```
+ *
+ * @example ID transformation with compound IDs and rawId preservation
+ * ```typescript
+ * type WithRawId<T> = T & { rawId: string };
+ *
+ * const syncVersions = resolveContainerDeltas<
+ *   typeof template.versions,
+ *   VersionResponse,
+ *   WithRawId<VersionResponse>
+ * >({
+ *   container: template.versions,
+ *   idMapper: (versionData) => ({
+ *     ...versionData,
+ *     rawId: versionData.id,  // Preserve backend ID
+ *     id: ReleaseIdFactory.version(templateId, versionData.id)  // Compound model ID
+ *   }),
+ *   onAddItem: (data) => {
+ *     const model = ReleaseVersion.instance(data.id)
+ *       .options({
+ *         rawId: data.rawId,  // Store backend ID for server communication
+ *         version: data.version,
+ *         // ... other options
+ *       })
+ *       .build();
+ *     // Recursively sync nested containers
+ *     syncCandidates(model, data.candidates || []);
+ *     return model;
+ *   },
+ *   onUpdateItem: (data, existingVersion) => {
+ *     existingVersion.updateModel({
+ *       rawId: data.rawId || existingVersion.rawId,
+ *       version: data.version,
+ *       // ... other updates
+ *     });
+ *     // Recursively sync nested containers
+ *     syncCandidates(existingVersion, data.candidates || []);
+ *     return null; // Don't add, just updated in place
+ *   },
+ *   onRemoveItem: (id) => id
+ * })(versionsData);
+ * ```
+ *
+ * @example Nested container synchronization
+ * ```typescript
+ * // Parent level
+ * syncTemplates(containerModel, templatesData);
+ *
+ * // Within onAddItem and onUpdateItem, sync children
+ * function syncTemplates(container, templates) {
+ *   resolveContainerDeltas({
+ *     container: container.container,
+ *     idMapper: (template) => ({
+ *       ...template,
+ *       rawId: template.id,
+ *       id: ReleaseIdFactory.template(template.id)
+ *     }),
+ *     onAddItem: (template) => {
+ *       const model = createTemplateModel(template);
+ *       syncQueues(model, template.queues);  // Nested sync
+ *       syncVersions(model, template.versions);  // Nested sync
+ *       return model;
+ *     },
+ *     onUpdateItem: (template, existing) => {
+ *       existing.updateModel(template);
+ *       syncQueues(existing, template.queues);  // Nested sync
+ *       syncVersions(existing, template.versions);  // Nested sync
+ *       return null;
+ *     }
+ *   })(templates);
+ * }
+ * ```
+ * @kosApiLevel 2
+ */
+export declare const resolveContainerDeltas: <T extends IKosModelContainer<any>, D extends Identifiable, M extends Identifiable = D>({ container, onAddItem, onUpdateItem, onRemoveItem, idMapper, }: ResolveParams<T, D, M>) => (entities: D[]) => void;
+/**
+ * Creates a function that synchronizes a container model's list with new entities.
+ * Simpler alternative to resolveContainerDeltas that directly invokes callbacks for each addition and removal.
+ *
+ * @template T - Container model type implementing IKosContainerModel
+ * @template D - Input entity type with an id property
+ * @template M - Mapped entity type (after idMapper transformation)
+ * @param params - Configuration for resolving deltas
+ * @returns A function that accepts entities and synchronizes by invoking callbacks
+ *
+ * @kosService core.container-utils
+ *
+ * @example
+ * const syncLayers = resolveListDeltas({
+ *   container: layerContainer,
+ *   onAddItem: (layer) => addLayer(layer),
+ *   onRemoveItem: (id) => removeLayer(id)
+ * });
+ * syncLayers(newLayerList);
+ * @kosApiLevel 2
+ */
+export declare const resolveListDeltas: <T extends IKosContainerModel<any, any>, D extends Identifiable, M extends Identifiable = D>({ container, onAddItem, onRemoveItem, idMapper, }: ResolveParams<T, D, M>) => (entities: D[]) => void;
+/**
+ * Parameters for resolving deltas on plain item arrays (not container models).
+ * @template T - Current item type with an id property
+ * @template D - Input entity type with an id property
+ * @template M - Mapped entity type (after idMapper transformation)
+ */
+interface ResolveItemsParams<T extends Identifiable, D extends Identifiable, M extends Identifiable = D> {
+    /** The current array of items to synchronize */
     items: T[];
-    onAddItem: (entity: D) => void;
+    /** Callback invoked for each entity to add */
+    onAddItem: (entity: M) => void;
+    /** Callback invoked for each id to remove */
     onRemoveItem: (id: string) => void;
-    idMapper?: IdMapper;
+    /** Optional mapper to transform entity ids before processing */
+    idMapper?: IdMapper<D, M>;
 }
-export declare const resolveItemListDeltas: <T extends Identifiable, D extends Identifiable>({ items, onAddItem, onRemoveItem, idMapper, }: ResolveItemsParams<T, D>) => (entities: D[]) => void;
+/**
+ * Creates a function that synchronizes a plain array of items with new entities.
+ * Does not require a container model - works with any array of identifiable items.
+ *
+ * @template T - Current item type with an id property
+ * @template D - Input entity type with an id property
+ * @template M - Mapped entity type (after idMapper transformation)
+ * @param params - Configuration including the items array and callbacks
+ * @returns A function that accepts entities and synchronizes the array
+ *
+ * @kosService core.container-utils
+ *
+ * @example
+ * const currentItems = [{ id: '1', name: 'Item 1' }];
+ * const syncItems = resolveItemListDeltas({
+ *   items: currentItems,
+ *   onAddItem: (item) => currentItems.push(item),
+ *   onRemoveItem: (id) => {
+ *     const index = currentItems.findIndex(i => i.id === id);
+ *     if (index >= 0) currentItems.splice(index, 1);
+ *   }
+ * });
+ * syncItems(newItems);
+ * @kosApiLevel 2
+ */
+export declare const resolveItemListDeltas: <T extends Identifiable, D extends Identifiable, M extends Identifiable = D>({ items, onAddItem, onRemoveItem, idMapper, }: ResolveItemsParams<T, D, M>) => (entities: D[]) => void;
+/**
+ * Removes a prefix from an id string if present.
+ * Useful for normalizing ids that may have parent or namespace prefixes.
+ *
+ * @param id - The id string to process
+ * @param prefix - The prefix to remove (defaults to "parent-")
+ * @returns The id with the prefix removed, or the original id if prefix not found
+ *
+ * @example
+ * processId("parent-123") // returns "123"
+ * processId("parent-abc", "parent-") // returns "abc"
+ * processId("child-456", "parent-") // returns "child-456"
+ *
+ * @kosService core.container-utils
+ * @kosApiLevel 2
+ */
 export declare const processId: (id: string, prefix?: string) => string;
 export {};
 //# sourceMappingURL=container-utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"container-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/container-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAqBD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;AAE/E,KAAK,SAAS,GAAG,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACxE,UAAU,aAAa,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC;IACb,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,GAAG,CAAC;IAC9B,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,GAAG,CAAC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,eAAO,MAAM,sBAAsB,iHAM9B,cAAc,CAAC,EAAE,CAAC,CAAC,gBACX,CAAC,EAAE,SAOb,CAAC;AAEJ,eAAO,MAAM,iBAAiB,sHAMzB,cAAc,CAAC,EAAE,CAAC,CAAC,gBACX,CAAC,EAAE,SAKb,CAAC;AAEJ,UAAU,kBAAkB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC;IACpD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,eAAO,MAAM,qBAAqB,kGAM7B,mBAAmB,CAAC,EAAE,CAAC,CAAC,gBAChB,CAAC,EAAE,SAKb,CAAC;AAEJ,eAAO,MAAM,SAAS,OAAQ,MAAM,4BAMnC,CAAC"}
+{"version":3,"file":"container-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/container-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,MAAM,QAAQ,CAClB,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,YAAY,GAAG,CAAC,IACxB,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;AAErB,KAAK,SAAS,GAAG,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;AAExE;;;;;GAKG;AACH,UAAU,aAAa,CACrB,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,YAAY,EACtB,CAAC,SAAS,YAAY,GAAG,CAAC;IAE1B,mCAAmC;IACnC,SAAS,EAAE,CAAC,CAAC;IACb,4DAA4D;IAC5D,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,GAAG,CAAC;IAC9B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,GAAG,CAAC;IACnC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,GAAG,KAAK,GAAG,CAAC;IACtD,gEAAgE;IAChE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC3B;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0HG;AACH,eAAO,MAAM,sBAAsB,2JAW9B,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,gBACd,CAAC,EAAE,SAkBb,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB,kJAUzB,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,gBACd,CAAC,EAAE,SAKb,CAAC;AAEJ;;;;;GAKG;AACH,UAAU,kBAAkB,CAC1B,CAAC,SAAS,YAAY,EACtB,CAAC,SAAS,YAAY,EACtB,CAAC,SAAS,YAAY,GAAG,CAAC;IAE1B,gDAAgD;IAChD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,8CAA8C;IAC9C,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,6CAA6C;IAC7C,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,qBAAqB,8HAM7B,mBAAmB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,gBACnB,CAAC,EAAE,SAKb,CAAC;AAEJ;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,OAAQ,MAAM,4BAMnC,CAAC"}

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

@@ -1,7 +1,27 @@
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare function formatDateSince(date: Date): string;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 3
+ */
 export declare const isLeapYear: (year: number) => boolean;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 3
+ */
 export declare const getDaysInMonth: (year: number, month: number) => number;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 3
+ */
 export declare const addMonthsToDate: (date: Date, value: number) => Date;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 3
+ */
 export declare const addDaysToDate: (date: Date, value: number) => Date;
 interface FormatDateOptions {
     dateStyle?: "short" | "medium" | "long" | "full";
@@ -34,6 +54,9 @@ interface FormatDateTimeOptions extends FormatDateOptions, FormatTimeOptions {
  * @param options.dateStyle - One of `"short"`, `"medium"`, `"long"`, or `"full"`.
  * @param options.locales - Optional locale string or array of locale strings.
  * @returns A formatted date string.
+ *
+ * @kosService core.utils
+ * @kosApiLevel 3
  */
 export declare const formatDate: (date?: Date | number, { dateStyle, locales }?: FormatDateOptions) => string;
 /**
@@ -54,6 +77,9 @@ export declare const formatDate: (date?: Date | number, { dateStyle, locales }?:
  * @param options.timeStyle - One of `"short"`, `"medium"`, `"long"`, or `"full"`.
  * @param options.locales - Optional locale string or locale array.
  * @returns A formatted time string.
+ *
+ * @kosService core.utils
+ * @kosApiLevel 3
  */
 export declare const formatTime: (date?: Date | number, { locales, timeStyle }?: FormatTimeOptions) => string;
 /**
@@ -98,6 +124,9 @@ export declare const formatTime: (date?: Date | number, { locales, timeStyle }?:
  * @param options.timeStyle - Custom time format: `"short"`, `"medium"`, `"long"`, or `"full"`.
  * @param options.locales - Optional locale string or locale array.
  * @returns A string representing the formatted date and/or time.
+ *
+ * @kosService core.utils
+ * @kosApiLevel 3
  */
 export declare const formatDateTime: (date?: Date | number, { dateStyle, locales, timeStyle, }?: FormatDateTimeOptions) => string;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/date-utils.ts"],"names":[],"mappings":"AAcA,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,UAWzC;AAED,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OACgB,CAAC;AAE3D,eAAO,MAAM,cAAc,SAAU,MAAM,SAAS,MAAM,KAAG,MAG1D,CAAC;AAEJ,eAAO,MAAM,eAAe,SAAU,IAAI,SAAS,MAAM,SAOxD,CAAC;AAEF,eAAO,MAAM,aAAa,SAAU,IAAI,SAAS,MAAM,SAItD,CAAC;AAIF,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,qBAAsB,SAAQ,iBAAiB,EAAE,iBAAiB;CAAG;AA6D/E;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,UAAU,UACd,IAAI,GAAG,MAAM,2BAC+B,iBAAiB,WAOrE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,UAAU,UACd,IAAI,GAAG,MAAM,2BAC+B,iBAAiB,WAOrE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,eAAO,MAAM,cAAc,UAClB,IAAI,GAAG,MAAM,uCAKjB,qBAAqB,WAWzB,CAAC"}
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/date-utils.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,UAWzC;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OACgB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,cAAc,SAAU,MAAM,SAAS,MAAM,KAAG,MAG1D,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,eAAe,SAAU,IAAI,SAAS,MAAM,SAOxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,SAAU,IAAI,SAAS,MAAM,SAItD,CAAC;AAIF,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,qBAAsB,SAAQ,iBAAiB,EAAE,iBAAiB;CAAG;AA6D/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,eAAO,MAAM,UAAU,UACd,IAAI,GAAG,MAAM,2BAC+B,iBAAiB,WAOrE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,UAAU,UACd,IAAI,GAAG,MAAM,2BAC+B,iBAAiB,WAOrE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,eAAO,MAAM,cAAc,UAClB,IAAI,GAAG,MAAM,uCAKjB,qBAAqB,WAWzB,CAAC"}

package/core/util/debounce.d.ts

@@ -13,6 +13,9 @@
  * const debouncedFn = debounce(this, myFunction, 500);
  * debouncedFn(arg1, arg2);
  * ```
+ *
+ * @kosService core.utils
+ * @kosApiLevel 2
  */
 declare function debounce(context: any, func: Function, timeout?: number): (...args: any) => void;
 export default debounce;

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

@@ -1 +1 @@
-{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,SAAM,aAQ1C,GAAG,UAarB;AAED,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,SAAM,aAQ1C,GAAG,UAarB;AAED,eAAe,QAAQ,CAAC"}

package/core/util/error-logger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Zone 3 utility for logging errors with structured context
+ */
+export interface ModelInstantiationErrorContext {
+    modelType: string;
+    options: any;
+    registryId: string;
+}
+/**
+ * Logs a model instantiation error with structured metadata.
+ *
+ * @param error - The error that occurred during instantiation
+ * @param context - Contextual information about the failed instantiation
+ */
+export declare function logModelInstantiationError(error: unknown, context: ModelInstantiationErrorContext): void;
+//# sourceMappingURL=error-logger.d.ts.map

package/core/util/error-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-logger.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/error-logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,8BAA8B,GACtC,IAAI,CASN"}

package/core/util/feature-flags.d.ts

@@ -1,7 +1,22 @@
+/**
+ * @kosService core.utils
+ * @kosApiLevel 12
+ */
 export declare const EXTENSION_FEATURE_FLAG_RESOLVER = "featureFlagResolver";
+/**
+ * @kosService core.utils
+ */
 export type FlagResolver<T = any> = (input: T) => Promise<string[]>;
 type FeatureFlags = Record<string, boolean>;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 12
+ */
 export declare const LOADER_FEATURE_FLAG = "kos.loader.featureFlag";
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare class FeatureFlagService {
     private flags;
     constructor(initialFlags?: FeatureFlags);
@@ -11,6 +26,10 @@ export declare class FeatureFlagService {
     toggleFeature(flag: string): void;
     updateFlags(newFlags: FeatureFlags): void;
 }
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const KosFeatureFlags: FeatureFlagService;
 export {};
 //# sourceMappingURL=feature-flags.d.ts.map

package/core/util/feature-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/feature-flags.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,+BAA+B,wBAAwB,CAAC;AACrE,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAuCpE,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAC5D,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAA+B;gBAEhC,YAAY,GAAE,YAAiB;IAK3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKvC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;CAG1C;AAID,eAAO,MAAM,eAAe,oBAAyB,CAAC"}
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/feature-flags.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,+BAA+B,wBAAwB,CAAC;AACrE;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAuCpE,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAC5D;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAA+B;gBAEhC,YAAY,GAAE,YAAiB;IAK3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKvC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;CAG1C;AAID;;;GAGG;AACH,eAAO,MAAM,eAAe,oBAAyB,CAAC"}

package/core/util/get-query-params.d.ts

@@ -1,2 +1,6 @@
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const getQueryParams: (query?: null) => {};
 //# sourceMappingURL=get-query-params.d.ts.map

package/core/util/get-query-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-query-params.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/get-query-params.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,sBAiBjB,CAAC"}
+{"version":3,"file":"get-query-params.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/get-query-params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc,sBAiBjB,CAAC"}

package/core/util/hsl-to-hex.d.ts

@@ -1,5 +1,21 @@
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const hslToHex: (h: number, s: number, l: number) => string;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const hslStringToHex: (hsl: string) => string;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const resolveVariable: (element: Element, variable: string) => string;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const variableToHex: (element: Element, variable: string) => string;
 //# sourceMappingURL=hsl-to-hex.d.ts.map

package/core/util/hsl-to-hex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hsl-to-hex.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/hsl-to-hex.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,WAWvD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAS,MAAM,WAOzC,CAAC;AAEF,eAAO,MAAM,eAAe,YAAa,OAAO,YAAY,MAAM,WACZ,CAAC;AACvD,eAAO,MAAM,aAAa,YAAa,OAAO,YAAY,MAAM,WACZ,CAAC"}
+{"version":3,"file":"hsl-to-hex.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/hsl-to-hex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,QAAQ,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,WAWvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAS,MAAM,WAOzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,YAAa,OAAO,YAAY,MAAM,WACZ,CAAC;AACvD;;;GAGG;AACH,eAAO,MAAM,aAAa,YAAa,OAAO,YAAY,MAAM,WACZ,CAAC"}

package/core/util/index.d.ts

@@ -1,3 +1,4 @@
+export * from './ancestor-path-visitor';
 export * from './api-request-id';
 export * from './apply-mixins';
 export * from './array-utils';
@@ -26,6 +27,8 @@ export * from './paired-client-heartbeat';
 export * from './pipe';
 export * from './retry-with-exponential-backoff';
 export * from './service-factory';
+export * from './service-request-error';
+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,yBAAyB,CAAC;AACxC,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,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/core/util/kos-config-init.d.ts

@@ -3,13 +3,50 @@ interface KosConfig {
     profiles: string[];
     [key: string]: boolean | string[] | string | number | undefined;
 }
+/**
+ * @kosService core.utils
+ * @kosApiLevel 20
+ */
+export declare const PROFILE_ENABLE_RELEASES = "studio.enable.releases";
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const PROFILE_TOOLS_PREVIEW = "studio.tools.preview";
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const PROFILE_RELAX_STORE_VALIDATION = "studio.relax.store.validation";
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const PROFILE_LOG_DEBUG = "studio.log.debug";
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const PROFILE_LOG_INFO = "studio.log.info";
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const KosGlobalConfig: KosConfig;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const resolveKosProfiles: () => string[];
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const hasKosProfile: (profile: string) => boolean;
+/**
+ * @kosService core.utils
+ * @kosApiLevel 2
+ */
 export declare const isKosLoggingEnabled: () => boolean;
 export {};
 //# sourceMappingURL=kos-config-init.d.ts.map

package/core/util/kos-config-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-config-init.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/kos-config-init.ts"],"names":[],"mappings":"AAAA,UAAU,SAAS;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACjE;AAED,eAAO,MAAM,qBAAqB,yBAAyB,CAAC;AAC5D,eAAO,MAAM,8BAA8B,kCAAkC,CAAC;AAC9E,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAUlD,eAAO,MAAM,eAAe,EAAE,SAAqB,CAAC;AAEpD,eAAO,MAAM,kBAAkB,gBAAuC,CAAC;AAEvE,eAAO,MAAM,aAAa,YAAa,MAAM,YACL,CAAC;AAEzC,eAAO,MAAM,mBAAmB,eAAyC,CAAC"}
+{"version":3,"file":"kos-config-init.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/kos-config-init.ts"],"names":[],"mappings":"AAAA,UAAU,SAAS;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACjE;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,yBAAyB,CAAC;AAC5D;;;GAGG;AACH,eAAO,MAAM,8BAA8B,kCAAkC,CAAC;AAC9E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAUlD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAqB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,gBAAuC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,aAAa,YAAa,MAAM,YACL,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAyC,CAAC"}

package/core/util/kos-data-mapper-utils.d.ts

@@ -1,6 +1,12 @@
 import { IKosDataModel } from '../core/kosModel';
 
+/**
+ * @kosService core.utils
+ */
 export type KosDataMapper<D extends object = any, T extends IKosDataModel = IKosDataModel> = (data: D, model: T) => Partial<Omit<T, keyof IKosDataModel>>;
+/**
+ * @kosService core.utils
+ */
 export type KosDataMapperUtils<D extends object, T extends IKosDataModel> = KosDataMapper<D, T>;
 /**
  * Utility function that can be used to map an arbitrary data object to a model.
@@ -9,6 +15,9 @@ export type KosDataMapperUtils<D extends object, T extends IKosDataModel> = KosD
  * @param model - the target model to map the data to
  * @param mapper - a mapping function that takes the input data and the target model and returns a partial of the target model.  The
  * results will be applied to the model.
+ *
+ * @kosService core.utils
+ * @kosApiLevel 2
  */
 export declare const mapDataToModel: <D extends object, T extends IKosDataModel>(data: D, model: T, mapper?: KosDataMapperUtils<D, T>) => void;
 //# sourceMappingURL=kos-data-mapper-utils.d.ts.map

package/core/util/kos-data-mapper-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-data-mapper-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/kos-data-mapper-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,CAAC,SAAS,aAAa,GAAG,aAAa,IACrC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,aAAa,CAAC,CAAC,CAAC;AAEjE,MAAM,MAAM,kBAAkB,CAC5B,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,aAAa,IACrB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAaxB;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,oDACnB,CAAC,SACA,CAAC,WACA,mBAAmB,CAAC,EAAE,CAAC,CAAC,SAMjC,CAAC"}
+{"version":3,"file":"kos-data-mapper-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/kos-data-mapper-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,CAAC,SAAS,aAAa,GAAG,aAAa,IACrC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,aAAa,CAAC,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAC5B,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,aAAa,IACrB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAaxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,oDACnB,CAAC,SACA,CAAC,WACA,mBAAmB,CAAC,EAAE,CAAC,CAAC,SAMjC,CAAC"}

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

@@ -4,6 +4,9 @@ import { KosFetchOptions, Response } from '../types/utils/kos-fetch';
  * Represents the response data received from a Kos service.
  *
  * @typeparam T - The type of data in the response.
+ *
+ * @kosService core.fetch
+ * @kosApiLevel 2
  */
 export interface KosServiceResponse<T> {
     data: T;
@@ -11,8 +14,17 @@ export interface KosServiceResponse<T> {
 }
 /**
  * Represents the base URL for Kos fetch requests.
+ *
+ * @kosService core.fetch
+ * @kosApiLevel 2
  */
 declare let BASE_URL: string;
+/**
+ * KOS fetch function — WebSocket-based fetch implementation for KOS transport.
+ *
+ * @kosService core.fetch
+ * @kosApiLevel 2
+ */
 declare let kosFetch: (url: string, options?: KosFetchOptions) => Promise<Response>;
 export { BASE_URL, kosFetch };
 //# sourceMappingURL=kos-fetch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/kos-fetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAmBrE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB;AAkTD;;GAEG;AACH,QAAA,IAAI,QAAQ,QAAS,CAAC;AACtB,QAAA,IAAI,QAAQ,QAtNL,MAAM,YACD,eAAe,KACxB,QAAQ,QAAQ,CAoNM,CAAC;AAS1B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/kos-fetch.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAmBrE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB;AAkTD;;;;;GAKG;AACH,QAAA,IAAI,QAAQ,QAAS,CAAC;AACtB;;;;;GAKG;AACH,QAAA,IAAI,QAAQ,QA/NL,MAAM,YACD,eAAe,KACxB,QAAQ,QAAQ,CA6NM,CAAC;AAS1B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC"}