@dataclouder/ngx-core 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataclouder/ngx-core",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Angular core components library for DataClouder applications, only for internal use",
   "author": {
     "name": "dataclouder",

package/types/dataclouder-ngx-core.d.ts

@@ -687,10 +687,13 @@ declare class HttpCoreService {
     static ɵprov: i0.ɵɵInjectableDeclaration<HttpCoreService>;
 }
 
+type EntityViewMode = 'list' | 'form' | 'detail';
 declare abstract class EntityCommunicationService<T> {
     protected serviceName: string;
     protected httpService: HttpCoreService;
     protected customHost?: string;
+    currentEntity: WritableSignal<T | undefined>;
+    currentMode: WritableSignal<EntityViewMode | undefined>;
     constructor(serviceName: string);
     findAll(query?: any): Promise<T[]>;
     /**
@@ -708,15 +711,11 @@ declare abstract class EntityCommunicationService<T> {
      * @deprecated Use createOrUpdate(payload) instead.
      */
     createOperation(payload: Partial<T>): Promise<T>;
-    query(filterConfig: FiltersConfig): Promise<IFilterQueryResponse<T>>;
     /**
-     * @deprecated Use createOrUpdate instead.
-     */
+   * @deprecated This was changed to use operation() method., refactor your code to use operation.
+   */
+    query(filterConfig: FiltersConfig): Promise<IFilterQueryResponse<T>>;
     update(id: string, update: any): Promise<T>;
-    /**
-     * @deprecated Use createOrUpdate or updateOne instead.
-     */
-    updateOneOperation(id: string, payload: any): Promise<T>;
     partialUpdate(id: string, partialUpdates: Partial<T>): Promise<T>;
     remove(id: string): Promise<void>;
     /**
@@ -725,8 +724,47 @@ declare abstract class EntityCommunicationService<T> {
     removeOperation(id: string): Promise<any>;
     clone(id: string, overrides?: Partial<T>): Promise<T>;
     getFixedQuery(): Record<string, any>;
+    /**
+     * Executes a single database operation through a flexible interface provided by the backend's `@dataclouder/nest-mongo` ecosystem.
+     * By leveraging this endpoint, clients can safely execute any common MongoDB operation by passing the appropriate configuration.
+     *
+     * @param params - The payload containing the operation details.
+     * @param params.action - The database action to perform. Valid options are:
+     *   - `'findOne'`: Fetch the first document matching `query`.
+     *   - `'find'`: Retrieve multiple documents matching `query` (supports `projection` and `options`).
+     *   - `'create'`: Insert a new document utilizing `payload`.
+     *   - `'updateOne'`: Modify the first document matching `query` using update operators in `payload`.
+     *   - `'updateMany'`: Modify all documents matching `query` using `payload`.
+     *   - `'deleteOne'`: Remove the first document matching `query`.
+     *   - `'deleteMany'`: Remove all documents matching `query`.
+     *   - `'aggregate'`: Run an aggregation pipeline provided in `payload` as an array.
+     *   - `'clone'`: Create a copy of a document identified by `query`, overriding properties with `payload`.
+     * @param params.query - The MongoDB query used to select documents (e.g., `{ status: "active" }`).
+     * @param params.payload - The data for `create`, `updateOne`, `updateMany` (update operators), or the aggregation pipeline array.
+     * @param params.projection - Specifies the fields to return for `find` or `findOne` (e.g., `{ name: 1, email: 1 }`).
+     * @param params.options - Additional options for `find` operations like `limit`, `skip`, or `sort` (e.g., `{ limit: 10 }`).
+     *
+     * @example
+     * // Find multiple documents
+     * this.operation({
+     *   action: 'find',
+     *   query: { status: 'active' },
+     *   projection: { name: 1 },
+     *   options: { limit: 10, sort: { createdAt: -1 } }
+     * });
+     *
+     * @example
+     * // Update a single document
+     * this.operation({
+     *   action: 'updateOne',
+     *   query: { _id: '123' },
+     *   payload: { $set: { status: 'inactive' } }
+     * });
+     *
+     * @returns A Promise resolving to the result of the database operation.
+     */
     operation(params: {
-        action: 'findOne' | 'find' | 'create' | 'updateOne' | 'updateMany' | 'deleteOne' | 'deleteMany' | 'aggregate' | 'count';
+        action: 'findOne' | 'find' | 'create' | 'updateOne' | 'updateMany' | 'deleteOne' | 'deleteMany' | 'aggregate' | 'clone';
         query?: any;
         payload?: any;
         projection?: any;
@@ -813,6 +851,7 @@ declare abstract class EntityBaseFormComponent<T extends {
     abstract form: FormGroup;
     protected abstract entityCommunicationService: EntityCommunicationService<T>;
     protected abstract patchForm(entity: T): void;
+    private _stateSyncEffect;
     save(): Promise<T | undefined>;
     reload(): void;
     getDirtyValues(form: FormGroup | FormArray): {
@@ -827,6 +866,26 @@ declare abstract class EntityBaseFormComponent<T extends {
     static ɵdir: i0.ɵɵDirectiveDeclaration<EntityBaseFormComponent<any>, never, never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "entityInput": { "alias": "entity"; "required": false; "isSignal": true; }; "useFakeSave": { "alias": "useFakeSave"; "required": false; "isSignal": true; }; }, { "fakeSaved": "fakeSaved"; }, never, never, true, never>;
 }
 
+declare abstract class EntityBaseDetailComponent<T extends {
+    _id?: string;
+}> {
+    protected route: ActivatedRoute;
+    toastService: _dataclouder_ngx_core.ToastAlertsAbstractService;
+    id: i0.InputSignal<string>;
+    entity: i0.WritableSignal<T>;
+    isLoading: i0.WritableSignal<boolean>;
+    private entityIdFromUrl;
+    entityId: i0.Signal<string>;
+    protected abstract entityCommunicationService: EntityCommunicationService<T>;
+    /** Called after the entity is successfully loaded. Override to react (e.g. load related data). */
+    protected onEntityLoaded(_entity: T): void;
+    private _loadEffect;
+    private loadEntity;
+    reload(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EntityBaseDetailComponent<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<EntityBaseDetailComponent<any>, never, never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare enum EModelQuality {
     FAST = "fast",// Prioritize speed over intelligence like flash lite
     BALANCED = "balanced",// Equal balance like flash 2.5
@@ -1137,5 +1196,5 @@ declare const CharacterEventActions: {
     label: string;
 }[];
 
-export { APP_CONFIG, AppConfigService, AudioNotificationService, AudioSpeed, AudioSpeedReverse, CharacterEventActions, ChatUserSettings, ConfirmComponent, ConfirmService, DCFilterBarComponent, DCProgressToastComponent, DcAuditableViewerComponent, DcExtensionsViewerComponent, DcLearnableFormComponent, DcLearnableViewerComponent, DcManageableFormComponent, DcManageableViewerComponent, DcReactionsViewerComponent, DcTagsFormComponent, EModelQuality, EmptyStateComponent, EntityBaseFormComponent, EntityBaseListComponent, EntityBaseListV2Component, EntityCommunicationService, FlagPipe, FormUtilsService, GetPathPipe, HTTP_CORE_CONFIG, HttpCoreService, IAIModel, LANGUAGES, LangDescTranslation, LoadingBarComponent, LoadingBarService, MobileService, ModelQualityOptions, MoodState, MoodStateOptions, OptionValue, PaginationBase, PromptService, QuickTableComponent, SUPPORTED_LANGUAGES, TOAST_ALERTS_TOKEN, ToastAlertsAbstractService, UiStateService, availibleFilters, extractJsonFromString, formatCamelCaseString, getLangDesc, getSupportedLanguageOptions, provideToastAlert, sortOptions, sortTypes };
-export type { AppException, ConfirmOptions, DeleteHttpParams, DeletedData, FiltersConfig, GetHttpParams, HttpCoreConfig, HttpCoreError, IAppConfig, IAuditable, ICustomFilter, IExtensionable, IFilterQueryResponse, ILangTranslation, ILanguageData, ILearnable, IManageable, IReactable, LearnableForm, ListFilterBarOptions, MongoState, OnActionEvent, PColumn, PostHttpParams, PromptOptions, PutHttpParams, SortOption, ToastData };
+export { APP_CONFIG, AppConfigService, AudioNotificationService, AudioSpeed, AudioSpeedReverse, CharacterEventActions, ChatUserSettings, ConfirmComponent, ConfirmService, DCFilterBarComponent, DCProgressToastComponent, DcAuditableViewerComponent, DcExtensionsViewerComponent, DcLearnableFormComponent, DcLearnableViewerComponent, DcManageableFormComponent, DcManageableViewerComponent, DcReactionsViewerComponent, DcTagsFormComponent, EModelQuality, EmptyStateComponent, EntityBaseDetailComponent, EntityBaseFormComponent, EntityBaseListComponent, EntityBaseListV2Component, EntityCommunicationService, FlagPipe, FormUtilsService, GetPathPipe, HTTP_CORE_CONFIG, HttpCoreService, IAIModel, LANGUAGES, LangDescTranslation, LoadingBarComponent, LoadingBarService, MobileService, ModelQualityOptions, MoodState, MoodStateOptions, OptionValue, PaginationBase, PromptService, QuickTableComponent, SUPPORTED_LANGUAGES, TOAST_ALERTS_TOKEN, ToastAlertsAbstractService, UiStateService, availibleFilters, extractJsonFromString, formatCamelCaseString, getLangDesc, getSupportedLanguageOptions, provideToastAlert, sortOptions, sortTypes };
+export type { AppException, ConfirmOptions, DeleteHttpParams, DeletedData, EntityViewMode, FiltersConfig, GetHttpParams, HttpCoreConfig, HttpCoreError, IAppConfig, IAuditable, ICustomFilter, IExtensionable, IFilterQueryResponse, ILangTranslation, ILanguageData, ILearnable, IManageable, IReactable, LearnableForm, ListFilterBarOptions, MongoState, OnActionEvent, PColumn, PostHttpParams, PromptOptions, PutHttpParams, SortOption, ToastData };