@intellegens/cornerstone-client 0.0.9999-alpha-41 → 0.0.9999-alpha-43

package/dist/adapters/search-adapter.d.ts

@@ -0,0 +1,83 @@
+import { PropertyPathDto, ReadSelectedOrderingDirection, ReadSelectedSearchDefinitionDto } from '../data';
+import { IReadSelectedClient } from '../services';
+import { IHasObservableProperty, SingularEventTarget } from '../utils';
+export type SearchAdapterBaseOptions<TDto> = {
+    primaryKey: string | ((item: TDto) => string);
+    multiselect: boolean;
+    defaultSearch?: ReadSelectedSearchDefinitionDto<TDto>;
+    defaultText?: string;
+    searchTriggerMinLength?: number;
+    searchDebounceDelay?: number;
+    ordering?: {
+        path: PropertyPathDto;
+        direction: ReadSelectedOrderingDirection;
+    }[];
+    limit?: number;
+};
+export type SearchAdapterOptions<TDto> = SearchAdapterBaseOptions<TDto> & (TDto extends {
+    type: string;
+} ? {
+    typesToSearch?: string[];
+} : {});
+export interface ISearchAdapter<TDto> extends IHasObservableProperty<'isLoading', boolean>, IHasObservableProperty<'error', string | undefined>, IHasObservableProperty<'searchData', readonly TDto[]>, IHasObservableProperty<'totalItemCount', number>, IHasObservableProperty<'types', string[] | undefined>, IHasObservableProperty<'search', ReadSelectedSearchDefinitionDto<TDto> | undefined>, IHasObservableProperty<'text', string | undefined>, IHasObservableProperty<'selection', readonly TDto[]> {
+    readonly options: Required<SearchAdapterBaseOptions<TDto>>;
+    readonly searchTriggerMinLength: number;
+    setTypes(types: string[] | undefined): void;
+    setSearch(search: ReadSelectedSearchDefinitionDto<TDto> | undefined): void;
+    setText(text: string | undefined): void;
+    refresh(): void;
+    selectionAdd(item: TDto): void;
+    selectionRemove(item: TDto): void;
+    selectionToggle(item: TDto): void;
+    selectionClear(): void;
+    destroy(): void;
+}
+export declare class SearchAdapter<TDto> implements ISearchAdapter<TDto> {
+    readonly options: Required<SearchAdapterBaseOptions<TDto>>;
+    readonly isLoadingChanged: SingularEventTarget<boolean>;
+    readonly errorChanged: SingularEventTarget<string | undefined>;
+    readonly searchDataChanged: SingularEventTarget<readonly TDto[]>;
+    readonly totalItemCountChanged: SingularEventTarget<number>;
+    readonly typesChanged: SingularEventTarget<string[] | undefined>;
+    readonly searchChanged: SingularEventTarget<ReadSelectedSearchDefinitionDto<TDto> | undefined>;
+    readonly textChanged: SingularEventTarget<string | undefined>;
+    readonly selectionChanged: SingularEventTarget<readonly TDto[]>;
+    private _readClient;
+    private _isLoading;
+    private _error;
+    private _searchData;
+    private _totalItemCount;
+    private _types;
+    private _search;
+    private _text;
+    private _selection;
+    private _lastSearchedText;
+    private _currentAbortController?;
+    private _fetchTimeout?;
+    constructor(options: SearchAdapterOptions<TDto>, client: IReadSelectedClient<any, any> | string);
+    get isLoading(): boolean;
+    get error(): string | undefined;
+    get searchData(): readonly TDto[];
+    get totalItemCount(): number;
+    get types(): string[] | undefined;
+    get search(): ReadSelectedSearchDefinitionDto<TDto> | undefined;
+    get text(): string | undefined;
+    get selection(): readonly TDto[];
+    get searchTriggerMinLength(): number;
+    setTypes(types: string[] | undefined): void;
+    setSearch(search: ReadSelectedSearchDefinitionDto<TDto> | undefined): void;
+    setText(text: string | undefined): void;
+    refresh(): void;
+    private _getItemKey;
+    selectionAdd(item: TDto): void;
+    selectionRemove(item: TDto): void;
+    selectionToggle(item: TDto): void;
+    selectionClear(): void;
+    destroy(): void;
+    private _triggerFetch;
+    private _scheduleFetch;
+    private _executeFetch;
+    private _emitSearchState;
+    private _buildDefinition;
+    private _cancelPendingRequests;
+}

package/dist/adapters/search-adapter.js

@@ -0,0 +1,284 @@
+import { ErrorCode, ReadSelectedComparisonOperator, ReadSelectedLogicalOperator, ReadSelectedPropertyType, } from '../data';
+import { ApiReadControllerClient } from '../services';
+import { SingularEventTarget, toPascalCase } from '../utils';
+const DEFAULT_OPTIONS = {
+    defaultSearch: undefined,
+    defaultText: undefined,
+    searchTriggerMinLength: 1,
+    searchDebounceDelay: 100,
+    ordering: [],
+    limit: undefined,
+};
+export class SearchAdapter {
+    options;
+    isLoadingChanged = new SingularEventTarget();
+    errorChanged = new SingularEventTarget();
+    searchDataChanged = new SingularEventTarget();
+    totalItemCountChanged = new SingularEventTarget();
+    typesChanged = new SingularEventTarget();
+    searchChanged = new SingularEventTarget();
+    textChanged = new SingularEventTarget();
+    selectionChanged = new SingularEventTarget();
+    _readClient;
+    _isLoading = false;
+    _error = undefined;
+    _searchData = [];
+    _totalItemCount = 0;
+    _types;
+    _search;
+    _text;
+    _selection = [];
+    _lastSearchedText = undefined;
+    _currentAbortController;
+    _fetchTimeout;
+    constructor(options, client) {
+        this._readClient = typeof client === 'string' ? new ApiReadControllerClient(client) : client;
+        this.options = {
+            ...DEFAULT_OPTIONS,
+            ...options,
+        };
+        this._types = options.typesToSearch;
+        this._search = this.options.defaultSearch;
+        this._text = this.options.defaultText;
+    }
+    // --- Getters ---
+    get isLoading() {
+        return this._isLoading;
+    }
+    get error() {
+        return this._error;
+    }
+    get searchData() {
+        return this._searchData;
+    }
+    get totalItemCount() {
+        return this._totalItemCount;
+    }
+    get types() {
+        return this._types;
+    }
+    get search() {
+        return this._search;
+    }
+    get text() {
+        return this._text;
+    }
+    get selection() {
+        return this._selection;
+    }
+    get searchTriggerMinLength() {
+        return this.options.searchTriggerMinLength;
+    }
+    // --- Mutations ---
+    setTypes(types) {
+        this._types = types;
+        this._lastSearchedText = undefined;
+        this.typesChanged.dispatchEvent(this._types);
+        this._triggerFetch();
+    }
+    setSearch(search) {
+        this._search = search;
+        this._lastSearchedText = undefined;
+        this.searchChanged.dispatchEvent(this._search);
+        this._triggerFetch();
+    }
+    setText(text) {
+        if (this._text === text)
+            return;
+        this._text = text;
+        this.textChanged.dispatchEvent(this._text);
+        this._triggerFetch();
+    }
+    refresh() {
+        this._lastSearchedText = undefined;
+        this._triggerFetch();
+    }
+    // --- Selection ---
+    _getItemKey(item) {
+        const pk = this.options.primaryKey;
+        if (typeof pk === 'function')
+            return pk(item);
+        return String(item[pk]);
+    }
+    selectionAdd(item) {
+        const key = this._getItemKey(item);
+        if (this._selection.find(x => this._getItemKey(x) === key))
+            return;
+        if (this.options.multiselect) {
+            this._selection = [...this._selection, item];
+        }
+        else {
+            this._selection = [item];
+        }
+        this._searchData = this._searchData.filter(d => this._getItemKey(d) !== key);
+        this.selectionChanged.dispatchEvent(this._selection);
+        this.searchDataChanged.dispatchEvent(this._searchData);
+    }
+    selectionRemove(item) {
+        const key = this._getItemKey(item);
+        this._selection = this._selection.filter(s => this._getItemKey(s) !== key);
+        this._searchData = [...this._searchData, item];
+        this.selectionChanged.dispatchEvent(this._selection);
+        this.searchDataChanged.dispatchEvent(this._searchData);
+    }
+    selectionToggle(item) {
+        const key = this._getItemKey(item);
+        if (this._selection.find(x => this._getItemKey(x) === key)) {
+            this.selectionRemove(item);
+        }
+        else {
+            this.selectionAdd(item);
+        }
+    }
+    selectionClear() {
+        this._selection = [];
+        this.selectionChanged.dispatchEvent(this._selection);
+    }
+    // --- Lifecycle ---
+    destroy() {
+        this._cancelPendingRequests();
+    }
+    // --- Private ---
+    _triggerFetch() {
+        const textLength = this._text?.length ?? 0;
+        if (textLength < this.options.searchTriggerMinLength) {
+            this._searchData = [];
+            this._lastSearchedText = undefined;
+            this._emitSearchState();
+            return;
+        }
+        if (this._text === this._lastSearchedText)
+            return;
+        this._lastSearchedText = this._text;
+        this._searchData = [];
+        this._scheduleFetch();
+    }
+    _scheduleFetch() {
+        this._isLoading = true;
+        this.isLoadingChanged.dispatchEvent(true);
+        if (this._fetchTimeout !== undefined) {
+            clearTimeout(this._fetchTimeout);
+        }
+        this._fetchTimeout = setTimeout(() => this._executeFetch(), this.options.searchDebounceDelay);
+    }
+    async _executeFetch() {
+        let abortController;
+        try {
+            if (this._currentAbortController) {
+                try {
+                    this._currentAbortController.abort();
+                }
+                catch {
+                    // Ignore abort errors
+                }
+            }
+            abortController = new AbortController();
+            this._currentAbortController = abortController;
+            const definition = this._buildDefinition();
+            const response = await this._readClient.readSelected(definition, abortController.signal);
+            if (!response.ok) {
+                if (response.error.code === ErrorCode.Aborted)
+                    return;
+                this._error = response.error.details ?? response.error.message ?? 'Unknown error';
+            }
+            else {
+                this._error = undefined;
+                this._totalItemCount = response.metadata?.totalCount ?? response.result.length;
+                const selectedKeys = new Set(this._selection.map(item => this._getItemKey(item)));
+                this._searchData = response.result.filter((item) => !selectedKeys.has(this._getItemKey(item)));
+            }
+        }
+        catch (error) {
+            console.error('Error fetching data:', error);
+            this._error = error instanceof Error ? error.message : 'Unknown error';
+        }
+        finally {
+            if (abortController && this._currentAbortController === abortController) {
+                this._isLoading = false;
+                this._currentAbortController = undefined;
+                this.isLoadingChanged.dispatchEvent(false);
+                this.errorChanged.dispatchEvent(this._error);
+                this._emitSearchState();
+            }
+        }
+    }
+    _emitSearchState() {
+        this.searchDataChanged.dispatchEvent(this._searchData);
+        this.totalItemCountChanged.dispatchEvent(this._totalItemCount);
+    }
+    _buildDefinition() {
+        const definition = {};
+        // Pagination
+        if (this.options.limit !== undefined) {
+            definition.paginationDefinition = { skip: 0, limit: this.options.limit };
+        }
+        // Ordering
+        if (this.options.ordering.length > 0) {
+            definition.orderingDefinition = {
+                order: this.options.ordering.map(o => ({
+                    propertyPath: o.path.map(x => toPascalCase(x)),
+                    direction: o.direction,
+                })),
+            };
+        }
+        // Search definition (from options or setSearch)
+        if (this._search) {
+            definition.searchDefinition = { ...this._search };
+        }
+        // Text search criterion
+        if (this._text) {
+            const textCriterion = {
+                propertyName: 'Name',
+                comparisonOperator: ReadSelectedComparisonOperator.IContains,
+                valueType: ReadSelectedPropertyType.String,
+                value: this._text,
+            };
+            if (!definition.searchDefinition) {
+                definition.searchDefinition = {
+                    logicalOperator: ReadSelectedLogicalOperator.And,
+                    propertyCriteria: [textCriterion],
+                };
+            }
+            else {
+                definition.searchDefinition.propertyCriteria = [...(definition.searchDefinition.propertyCriteria || []), textCriterion];
+            }
+        }
+        // Type criteria
+        if (this._types && this._types.length > 0) {
+            if (!definition.searchDefinition) {
+                definition.searchDefinition = {
+                    logicalOperator: ReadSelectedLogicalOperator.And,
+                    propertyCriteria: [],
+                };
+            }
+            if (!definition.searchDefinition.searches) {
+                definition.searchDefinition.searches = [];
+            }
+            definition.searchDefinition.searches.push({
+                logicalOperator: ReadSelectedLogicalOperator.Or,
+                propertyCriteria: this._types.map(type => ({
+                    propertyName: 'Type',
+                    comparisonOperator: ReadSelectedComparisonOperator.IEqual,
+                    valueType: ReadSelectedPropertyType.String,
+                    value: type,
+                })),
+            });
+        }
+        return definition;
+    }
+    _cancelPendingRequests() {
+        if (this._fetchTimeout !== undefined) {
+            clearTimeout(this._fetchTimeout);
+            this._fetchTimeout = undefined;
+        }
+        if (this._currentAbortController) {
+            try {
+                this._currentAbortController.abort();
+            }
+            catch {
+                // Ignore abort errors
+            }
+            this._currentAbortController = undefined;
+        }
+    }
+}

package/dist/data/api/dto/crud/crud-metadata-dto.js

@@ -0,0 +1 @@
+export {};

package/dist/data/api/dto/crud/index.d.ts

@@ -1 +1 @@
-export * from './CrudMetadataDto';
+export * from './crud-metadata-dto';

package/dist/data/api/dto/crud/index.js

@@ -1 +1 @@
-export * from './CrudMetadataDto';
+export * from './crud-metadata-dto';

package/dist/data/api/dto/index.d.ts

@@ -1,4 +1,4 @@
 export * from './response';
 export * from './read';
 export * from './crud';
-export * from './PropertyPathDto';
+export * from './property-path-dto';

package/dist/data/api/dto/index.js

@@ -1,4 +1,4 @@
 export * from './response';
 export * from './read';
 export * from './crud';
-export * from './PropertyPathDto';
+export * from './property-path-dto';

package/dist/data/api/dto/property-path-dto.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Array of properties that when combined form a path to a property.
+ */
+export type PropertyPathDto = string[];

package/dist/data/api/dto/property-path-dto.js

@@ -0,0 +1 @@
+export {};

package/dist/data/api/dto/read/index.d.ts

@@ -1,10 +1,10 @@
-export * from './ReadMetadataDto';
-export * from './ReadSelectedSearchPropertyDefinitionDto';
-export * from './ReadSelectedNestedCriteriaDto';
-export * from './ReadSelectedNestedCollectionCriteriaDto';
-export * from './ReadSelectedOrderingDefinitionDto';
-export * from './ReadSelectedOrderingPropertyDefinitionDto';
-export * from './ReadSelectedPaginationDefinitionDto';
-export * from './ReadSelectedDefinitionDto';
-export * from './ReadSelectedSearchDefinitionDto';
-export * from './ReadSelectedSearchDefinitionBuilder';
+export * from './read-metadata-dto';
+export * from './read-selected-search-property-definition-dto';
+export * from './read-selected-nested-criteria-dto';
+export * from './read-selected-nested-collection-criteria-dto';
+export * from './read-selected-ordering-definition-dto';
+export * from './read-selected-ordering-property-definition-dto';
+export * from './read-selected-pagination-definition-dto';
+export * from './read-selected-definition-dto';
+export * from './read-selected-search-definition-dto';
+export * from './read-selected-search-definition-builder';

package/dist/data/api/dto/read/index.js

@@ -1,10 +1,10 @@
-export * from './ReadMetadataDto';
-export * from './ReadSelectedSearchPropertyDefinitionDto';
-export * from './ReadSelectedNestedCriteriaDto';
-export * from './ReadSelectedNestedCollectionCriteriaDto';
-export * from './ReadSelectedOrderingDefinitionDto';
-export * from './ReadSelectedOrderingPropertyDefinitionDto';
-export * from './ReadSelectedPaginationDefinitionDto';
-export * from './ReadSelectedDefinitionDto';
-export * from './ReadSelectedSearchDefinitionDto';
-export * from './ReadSelectedSearchDefinitionBuilder';
+export * from './read-metadata-dto';
+export * from './read-selected-search-property-definition-dto';
+export * from './read-selected-nested-criteria-dto';
+export * from './read-selected-nested-collection-criteria-dto';
+export * from './read-selected-ordering-definition-dto';
+export * from './read-selected-ordering-property-definition-dto';
+export * from './read-selected-pagination-definition-dto';
+export * from './read-selected-definition-dto';
+export * from './read-selected-search-definition-dto';
+export * from './read-selected-search-definition-builder';

package/dist/data/api/dto/read/read-metadata-dto.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Metadata associated with a read result.
+ *
+ * @property {number} [totalCount] - The total number of items available.
+ */
+export type ReadMetadataDto = {
+    totalCount?: number;
+};

package/dist/data/api/dto/read/read-metadata-dto.js

@@ -0,0 +1 @@
+export {};

package/dist/data/api/dto/read/read-selected-definition-dto.d.ts

@@ -0,0 +1,18 @@
+import { ReadSelectedPaginationDefinitionDto, ReadSelectedOrderingDefinitionDto, ReadSelectedSearchDefinitionDto } from '../../..';
+/**
+ * Defines the selection criteria for a controller to fetch multiple records
+ */
+export type ReadSelectedDefinitionDto<T> = {
+    /**
+     * Pagination definition
+     */
+    paginationDefinition?: ReadSelectedPaginationDefinitionDto;
+    /**
+     * Ordering definition
+     */
+    orderingDefinition?: ReadSelectedOrderingDefinitionDto;
+    /**
+     * Search definition (supports both simple search and nested logical groups)
+     */
+    searchDefinition?: ReadSelectedSearchDefinitionDto<T>;
+};

package/dist/data/api/dto/read/read-selected-definition-dto.js

@@ -0,0 +1 @@
+export {};

package/dist/data/api/dto/read/read-selected-nested-collection-criteria-dto.d.ts

@@ -0,0 +1,22 @@
+import { ReadSelectedCollectionOperator, ReadSelectedSearchDefinitionDto } from '../../..';
+/**
+ * Defines criteria for searching within a collection navigation property using quantifiers (Any/All).
+ *
+ * This DTO allows navigation into a collection property and applying search criteria
+ * with a quantifier to determine if any or all elements match.
+ */
+export type ReadSelectedNestedCollectionCriteriaDto<T, TPropertyName extends keyof T> = {
+    /**
+     * The name of the collection navigation property to navigate into.
+     */
+    propertyName: TPropertyName;
+    /**
+     * The quantifier operator determining whether any or all elements must match.
+     */
+    collectionOperator: ReadSelectedCollectionOperator;
+    /**
+     * The search criteria to apply to elements in the collection.
+     * Type should be ReadSelectedSearchDefinitionDto of the collection element type.
+     */
+    criteria: ReadSelectedSearchDefinitionDto<unknown>;
+};

package/dist/data/api/dto/read/read-selected-nested-collection-criteria-dto.js

@@ -0,0 +1 @@
+export {};

package/dist/data/api/dto/read/read-selected-nested-criteria-dto.d.ts

@@ -0,0 +1,18 @@
+import { ReadSelectedSearchDefinitionDto } from '../../..';
+/**
+ * Defines criteria for searching within a nested object property.
+ *
+ * This DTO allows navigation into a nested object property and applying search criteria
+ * to that nested object. The property name must refer to a navigation property (not a collection).
+ */
+export type ReadSelectedNestedCriteriaDto<T, TPropertyName extends keyof T> = {
+    /**
+     * The name of the navigation property to navigate into.
+     */
+    propertyName: TPropertyName;
+    /**
+     * The search criteria to apply to the nested object.
+     * Type should be ReadSelectedSearchDefinitionDto of the nested object type.
+     */
+    criteria: ReadSelectedSearchDefinitionDto<unknown>;
+};

package/dist/data/api/dto/read/read-selected-nested-criteria-dto.js

@@ -0,0 +1 @@
+export {};

package/dist/data/api/dto/read/read-selected-ordering-definition-dto.d.ts

@@ -0,0 +1,7 @@
+import { ReadSelectedOrderingPropertyDefinitionDto } from '../../..';
+/**
+ * Represents the ordering definition for a controller.
+ */
+export type ReadSelectedOrderingDefinitionDto = {
+    order: ReadSelectedOrderingPropertyDefinitionDto[];
+};

package/dist/data/api/dto/read/read-selected-ordering-definition-dto.js

@@ -0,0 +1 @@
+export {};

package/dist/data/api/dto/read/read-selected-ordering-property-definition-dto.d.ts

@@ -0,0 +1,14 @@
+import { PropertyPathDto, ReadSelectedOrderingDirection } from '../../..';
+/**
+ * Defines the ordering property for a controller.
+ */
+export type ReadSelectedOrderingPropertyDefinitionDto = {
+    /**
+     * Gets or sets the property path.
+     */
+    propertyPath: PropertyPathDto;
+    /**
+     * Gets or sets the ordering direction.
+     */
+    direction: ReadSelectedOrderingDirection;
+};

package/dist/data/api/dto/read/read-selected-ordering-property-definition-dto.js

@@ -0,0 +1 @@
+export {};

package/dist/data/api/dto/read/read-selected-pagination-definition-dto.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Defines the pagination parameters for a controller.
+ */
+export type ReadSelectedPaginationDefinitionDto = {
+    /**
+     * Pagination offset
+     */
+    skip: number;
+    /**
+     * Pagination limit
+     */
+    limit: number;
+};

package/dist/data/api/dto/read/read-selected-pagination-definition-dto.js

@@ -0,0 +1 @@
+export {};