@mintplayer/ng-spark 0.0.9 → 0.1.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mintplayer/ng-spark",
   "private": false,
-  "version": "0.0.9",
+  "version": "0.1.1",
   "description": "Angular component library for MintPlayer.Spark CRUD applications",
   "repository": {
     "type": "git",
@@ -13,7 +13,7 @@
     "@angular/common": "^21.0.0",
     "@angular/router": "^21.0.0",
     "@angular/forms": "^21.0.0",
-    "@mintplayer/ng-bootstrap": "^21.12.3",
+    "@mintplayer/ng-bootstrap": "^21.12.4",
     "@mintplayer/pagination": "*",
     "rxjs": "~7.8.0"
   },

package/types/mintplayer-ng-spark.d.ts

@@ -1,6 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { WritableSignal, InjectionToken, Type, TemplateRef, PipeTransform, InputSignal, Provider } from '@angular/core';
 import { SortColumn, PaginationResponse } from '@mintplayer/pagination';
+import { Observable } from 'rxjs';
 import { Color } from '@mintplayer/ng-bootstrap';
 import { DatatableSettings } from '@mintplayer/ng-bootstrap/datatable';
 import * as _mintplayer_ng_spark from '@mintplayer/ng-spark';
@@ -170,6 +171,8 @@ interface SparkQuery {
     useProjection?: boolean;
     /** Optional entity type name (e.g., "Person"). When set, used for entity type resolution. */
     entityType?: string;
+    /** When true, this query uses WebSocket streaming with snapshot + patch updates. */
+    isStreamingQuery?: boolean;
 }
 
 interface QueryResult {
@@ -263,6 +266,24 @@ interface SparkConfig {
 declare const SPARK_CONFIG: InjectionToken<SparkConfig>;
 declare const defaultSparkConfig: SparkConfig;
 
+interface StreamingSnapshotMessage {
+    type: 'snapshot';
+    data: PersistentObject[];
+}
+interface StreamingPatchItem {
+    id: string;
+    attributes: Record<string, any>;
+}
+interface StreamingPatchMessage {
+    type: 'patch';
+    updated: StreamingPatchItem[];
+}
+interface StreamingErrorMessage {
+    type: 'error';
+    message: string;
+}
+type StreamingMessage = StreamingSnapshotMessage | StreamingPatchMessage | StreamingErrorMessage;
+
 declare class SparkService {
     private readonly config;
     private readonly baseUrl;
@@ -283,7 +304,10 @@ declare class SparkService {
         take?: number;
         search?: string;
     }): Promise<QueryResult>;
-    executeQueryByName(queryName: string): Promise<QueryResult>;
+    executeQueryByName(queryName: string, options?: {
+        parentId?: string;
+        parentType?: string;
+    }): Promise<QueryResult>;
     getProgramUnits(): Promise<ProgramUnitsConfiguration>;
     list(type: string): Promise<PersistentObject[]>;
     get(type: string, id: string): Promise<PersistentObject>;
@@ -305,6 +329,16 @@ declare class SparkService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SparkService>;
 }
 
+declare class SparkStreamingService {
+    private readonly config;
+    private readonly baseUrl;
+    private readonly ngZone;
+    connectToStreamingQuery(queryId: string): Observable<StreamingMessage>;
+    private buildWebSocketUrl;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkStreamingService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<SparkStreamingService>;
+}
+
 declare class SparkLanguageService {
     private readonly http;
     private readonly config;
@@ -341,6 +375,8 @@ declare class SparkPoFormComponent {
     validationErrors: _angular_core.InputSignal<ValidationError[]>;
     showButtons: _angular_core.InputSignal<boolean>;
     isSaving: _angular_core.InputSignal<boolean>;
+    parentId: _angular_core.InputSignal<string>;
+    parentType: _angular_core.InputSignal<string>;
     save: _angular_core.OutputEmitterRef<void>;
     cancel: _angular_core.OutputEmitterRef<void>;
     colors: typeof Color;
@@ -403,7 +439,7 @@ declare class SparkPoFormComponent {
     selectReferenceItem(item: PersistentObject): void;
     closeReferenceModal(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkPoFormComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkPoFormComponent, "spark-po-form", never, { "entityType": { "alias": "entityType"; "required": false; "isSignal": true; }; "formData": { "alias": "formData"; "required": false; "isSignal": true; }; "validationErrors": { "alias": "validationErrors"; "required": false; "isSignal": true; }; "showButtons": { "alias": "showButtons"; "required": false; "isSignal": true; }; "isSaving": { "alias": "isSaving"; "required": false; "isSignal": true; }; }, { "formData": "formDataChange"; "save": "save"; "cancel": "cancel"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkPoFormComponent, "spark-po-form", never, { "entityType": { "alias": "entityType"; "required": false; "isSignal": true; }; "formData": { "alias": "formData"; "required": false; "isSignal": true; }; "validationErrors": { "alias": "validationErrors"; "required": false; "isSignal": true; }; "showButtons": { "alias": "showButtons"; "required": false; "isSignal": true; }; "isSaving": { "alias": "isSaving"; "required": false; "isSignal": true; }; "parentId": { "alias": "parentId"; "required": false; "isSignal": true; }; "parentType": { "alias": "parentType"; "required": false; "isSignal": true; }; }, { "formData": "formDataChange"; "save": "save"; "cancel": "cancel"; }, never, never, true, never>;
 }
 
 declare class SparkPoCreateComponent {
@@ -509,7 +545,9 @@ declare class SparkQueryListComponent {
     private readonly route;
     private readonly router;
     private readonly sparkService;
+    private readonly streamingService;
     private readonly rendererRegistry;
+    private readonly destroyRef;
     extraActionsTemplate: _angular_core.InputSignal<TemplateRef<void>>;
     rowClicked: _angular_core.OutputEmitterRef<PersistentObject>;
     createClicked: _angular_core.OutputEmitterRef<void>;
@@ -523,6 +561,10 @@ declare class SparkQueryListComponent {
     searchTerm: string;
     canRead: _angular_core.WritableSignal<boolean>;
     canCreate: _angular_core.WritableSignal<boolean>;
+    isStreaming: _angular_core.WritableSignal<boolean>;
+    private streamingSub;
+    private allItems;
+    private filteredItems;
     settings: _angular_core.WritableSignal<DatatableSettings>;
     virtualDataSource: _angular_core.WritableSignal<VirtualDatatableDataSource<PersistentObject>>;
     virtualSettings: _angular_core.WritableSignal<DatatableSettings>;
@@ -542,6 +584,10 @@ declare class SparkQueryListComponent {
     getColumnRendererInputs(item: PersistentObject, attr: EntityAttributeDefinition): Record<string, any>;
     private loadLookupReferenceOptions;
     onCreate(): void;
+    private connectStreaming;
+    private disconnectStreaming;
+    private handleStreamingMessage;
+    private applyFilter;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkQueryListComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkQueryListComponent, "spark-query-list", never, { "extraActionsTemplate": { "alias": "extraActionsTemplate"; "required": false; "isSignal": true; }; }, { "rowClicked": "rowClicked"; "createClicked": "createClicked"; }, never, never, true, never>;
 }
@@ -814,5 +860,5 @@ declare function sparkRoutes(config?: SparkRouteConfig): Routes;
 
 declare function provideSpark(config?: Partial<SparkConfig>): Provider[];
 
-export { ArrayValuePipe, AsDetailCellValuePipe, AsDetailColumnsPipe, AsDetailDisplayValuePipe, AsDetailTypePipe, AttributeValuePipe, CanCreateDetailRowPipe, CanDeleteDetailRowPipe, ELookupDisplayType, ErrorForAttributePipe, IconNamePipe, InlineRefOptionsPipe, InputTypePipe, LookupDisplayTypePipe, LookupDisplayValuePipe, LookupOptionsPipe, RawAttributeValuePipe, ReferenceAttrValuePipe, ReferenceDisplayValuePipe, ReferenceLinkRoutePipe, ResolveTranslationPipe, RetryActionService, RouterLinkPipe, SPARK_ATTRIBUTE_RENDERERS, SPARK_CONFIG, ShowedOn, SparkIconComponent, SparkIconRegistry, SparkLanguageService, SparkPoCreateComponent, SparkPoDetailComponent, SparkPoEditComponent, SparkPoFormComponent, SparkQueryListComponent, SparkRetryActionModalComponent, SparkService, SparkSubQueryComponent, TranslateKeyPipe, currentLanguage, defaultSparkConfig, hasShowedOnFlag, provideSpark, provideSparkAttributeRenderers, resolveTranslation, sparkRoutes };
-export type { AttributeGroup, AttributeTab, CustomActionDefinition, EntityAttributeDefinition, EntityPermissions, EntityType, LookupReference, LookupReferenceListItem, LookupReferenceValue, PersistentObject, PersistentObjectAttribute, ProgramUnit, ProgramUnitGroup, ProgramUnitsConfiguration, QueryResult, RetryActionPayload, RetryActionResult, SparkAttributeColumnRenderer, SparkAttributeDetailRenderer, SparkAttributeEditRenderer, SparkAttributeRendererRegistration, SparkConfig, SparkQuery, SparkQueryRenderMode, SparkQuerySortColumn, SparkRouteConfig, TranslatedString, ValidationError, ValidationRule };
+export { ArrayValuePipe, AsDetailCellValuePipe, AsDetailColumnsPipe, AsDetailDisplayValuePipe, AsDetailTypePipe, AttributeValuePipe, CanCreateDetailRowPipe, CanDeleteDetailRowPipe, ELookupDisplayType, ErrorForAttributePipe, IconNamePipe, InlineRefOptionsPipe, InputTypePipe, LookupDisplayTypePipe, LookupDisplayValuePipe, LookupOptionsPipe, RawAttributeValuePipe, ReferenceAttrValuePipe, ReferenceDisplayValuePipe, ReferenceLinkRoutePipe, ResolveTranslationPipe, RetryActionService, RouterLinkPipe, SPARK_ATTRIBUTE_RENDERERS, SPARK_CONFIG, ShowedOn, SparkIconComponent, SparkIconRegistry, SparkLanguageService, SparkPoCreateComponent, SparkPoDetailComponent, SparkPoEditComponent, SparkPoFormComponent, SparkQueryListComponent, SparkRetryActionModalComponent, SparkService, SparkStreamingService, SparkSubQueryComponent, TranslateKeyPipe, currentLanguage, defaultSparkConfig, hasShowedOnFlag, provideSpark, provideSparkAttributeRenderers, resolveTranslation, sparkRoutes };
+export type { AttributeGroup, AttributeTab, CustomActionDefinition, EntityAttributeDefinition, EntityPermissions, EntityType, LookupReference, LookupReferenceListItem, LookupReferenceValue, PersistentObject, PersistentObjectAttribute, ProgramUnit, ProgramUnitGroup, ProgramUnitsConfiguration, QueryResult, RetryActionPayload, RetryActionResult, SparkAttributeColumnRenderer, SparkAttributeDetailRenderer, SparkAttributeEditRenderer, SparkAttributeRendererRegistration, SparkConfig, SparkQuery, SparkQueryRenderMode, SparkQuerySortColumn, SparkRouteConfig, StreamingErrorMessage, StreamingMessage, StreamingPatchItem, StreamingPatchMessage, StreamingSnapshotMessage, TranslatedString, ValidationError, ValidationRule };