@en-solutions/tgm-client-sdk 1.6.21

package/lib/services/index.d.ts

@@ -0,0 +1,7 @@
+export * from './auth';
+export * from './admin';
+export * from './api';
+export * from './chat';
+export * from './realtime';
+export * from './reservoir';
+export * from './video';

package/lib/services/realtime/index.d.ts

@@ -0,0 +1 @@
+export { RealtimeEventService } from './realtime-event.service';

package/lib/services/realtime/realtime-event.service.d.ts

@@ -0,0 +1,137 @@
+import { OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
+import { WebSocketService } from '../../core/websocket.service';
+import { EntityChangeEvent, QueueMessageEvent, QueueMessageFirehoseEvent, IoTEvent, NotificationEvent, CalendarUpdateEvent } from '../../models/realtime/realtime-event.models';
+import * as i0 from "@angular/core";
+/**
+ * Real-time event service for subscribing to entity CRUD changes,
+ * dynamic queue messages, IoT events, notifications, and calendar updates.
+ *
+ * ## Entity Changes
+ *
+ * When any entity is created, updated, or deleted via the API, an event is
+ * broadcast to WebSocket. No RabbitMQ required — this works automatically
+ * for every entity type managed by BaseApiController.
+ *
+ * ```typescript
+ * // All entity changes
+ * this.realtimeEvents.allEntityChanges$.subscribe(event => { ... });
+ *
+ * // Specific resource type
+ * this.realtimeEvents.entityChanges('inspections').subscribe(event => { ... });
+ * ```
+ *
+ * ## Dynamic Queue Messages
+ *
+ * When a RabbitMQ dynamic queue message is processed, it is broadcast to
+ * WebSocket. The queue must exist and have an active listener (create via
+ * QueueAdminService).
+ *
+ * ```typescript
+ * // All queue messages
+ * this.realtimeEvents.allQueueMessages$.subscribe(event => { ... });
+ *
+ * // Specific queue
+ * this.realtimeEvents.queueMessages('tgm_iot').subscribe(event => { ... });
+ * ```
+ *
+ * ## Connection
+ *
+ * Call `connect()` once (e.g. after login). The service uses the shared
+ * `WebSocketService` and auto-reconnects on disconnect.
+ */
+export declare class RealtimeEventService implements OnDestroy {
+    private ws;
+    private destroy$;
+    private connected;
+    /**
+     * All entity CRUD changes (firehose).
+     * Emits for every create, update, and delete across all entity types.
+     *
+     * STOMP destination: `/topic/entities`
+     */
+    readonly allEntityChanges$: Observable<EntityChangeEvent>;
+    /**
+     * All dynamic queue messages (firehose).
+     * Emits for every successfully processed message across all queues.
+     *
+     * STOMP destination: `/topic/queues`
+     */
+    readonly allQueueMessages$: Observable<QueueMessageFirehoseEvent>;
+    /**
+     * IoT sensor events from the static RabbitMQ listener.
+     *
+     * STOMP destination: `/topic/iot-event`
+     */
+    readonly iotEvents$: Observable<IoTEvent>;
+    /**
+     * Notifications for the authenticated user.
+     *
+     * STOMP destination: `/user/queue/notifications`
+     */
+    readonly notifications$: Observable<NotificationEvent>;
+    /**
+     * Calendar updates for the authenticated user.
+     *
+     * STOMP destination: `/user/queue/calendar`
+     */
+    readonly calendarUpdates$: Observable<CalendarUpdateEvent>;
+    constructor(ws: WebSocketService);
+    /**
+     * Connect to the WebSocket server.
+     * Call once after authentication (e.g. in AppComponent.ngOnInit or after login).
+     * Subsequent calls are no-ops.
+     */
+    connect(): void;
+    /**
+     * Disconnect from the WebSocket server.
+     */
+    disconnect(): void;
+    /**
+     * Subscribe to entity changes for a specific resource type.
+     *
+     * @param resourceName The API resource name (plural) — e.g. 'inspections', 'units', 'interventions', 'failures', 'locations'
+     * @returns Observable that emits EntityChangeEvent for that resource
+     *
+     * STOMP destination: `/topic/entities/{resourceName}`
+     *
+     * @example
+     * ```typescript
+     * this.realtimeEvents.entityChanges('inspections').subscribe(event => {
+     *   console.log(event.action, event.entityId, event.data);
+     * });
+     * ```
+     */
+    entityChanges<T = any>(resourceName: string): Observable<EntityChangeEvent<T>>;
+    /**
+     * Subscribe to messages from a specific dynamic queue.
+     *
+     * The queue must exist in RabbitMQ with an active listener.
+     * Create queues via `QueueAdminService.create()`.
+     *
+     * @param queueName The queue name — e.g. 'tgm_iot', 'tgm_notifications', 'my_custom_queue'
+     * @returns Observable that emits QueueMessageEvent for that queue
+     *
+     * STOMP destination: `/topic/queues/{queueName}`
+     *
+     * @example
+     * ```typescript
+     * this.realtimeEvents.queueMessages('tgm_iot').subscribe(event => {
+     *   console.log(event.handlerType, event.payload);
+     * });
+     * ```
+     */
+    queueMessages<T = any>(queueName: string): Observable<QueueMessageEvent<T>>;
+    /**
+     * Stop listening to a specific entity resource.
+     * Useful when navigating away from a page that was watching a resource.
+     */
+    unsubscribeEntity(resourceName: string): void;
+    /**
+     * Stop listening to a specific queue.
+     */
+    unsubscribeQueue(queueName: string): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RealtimeEventService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<RealtimeEventService>;
+}

package/lib/services/reservoir/index.d.ts

@@ -0,0 +1 @@
+export { ReservoirWebSocketService } from './reservoir-websocket.service';

package/lib/services/reservoir/reservoir-websocket.service.d.ts

@@ -0,0 +1,47 @@
+import { OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
+import { WebSocketService } from '../../core/websocket.service';
+import { ReservoirSensorEvent, ReservoirExternalMessage, ReservoirManualMessage, ReservoirStatusMessage } from '../../models/api/reservoir-websocket.models';
+import * as i0 from "@angular/core";
+/**
+ * WebSocket service for real-time reservoir data streams.
+ *
+ * Provides 4 strongly-typed observable streams per reservoir:
+ * - `sensors$` — real-time sensor readings (single or bulk)
+ * - `externalData$` — weather, grid market, lab results, fish monitoring, regulatory updates
+ * - `manualData$` — inspections, manual readings, operational observations
+ * - `statusAlerts$` — operating events and alert notifications
+ */
+export declare class ReservoirWebSocketService implements OnDestroy {
+    private ws;
+    private destroy$;
+    private connected;
+    private currentReservoirId;
+    private sensorsSubject$;
+    private externalDataSubject$;
+    private manualDataSubject$;
+    private statusAlertsSubject$;
+    /** Real-time sensor readings stream (single or bulk messages) */
+    readonly sensors$: Observable<ReservoirSensorEvent>;
+    /** External data stream (weather, grid market, lab results, etc.) */
+    readonly externalData$: Observable<ReservoirExternalMessage>;
+    /** Manual data stream (inspections, manual readings, observations) */
+    readonly manualData$: Observable<ReservoirManualMessage>;
+    /** Status and alert notifications stream */
+    readonly statusAlerts$: Observable<ReservoirStatusMessage>;
+    constructor(ws: WebSocketService);
+    /** Connects to the WebSocket and subscribes to all 4 streams for the given reservoir. */
+    connect(reservoirId: string): void;
+    /** Disconnects from the WebSocket. */
+    disconnect(): void;
+    /** Sends a subscription request to the backend for a specific data type. */
+    subscribe(reservoirId: string, dataType: string): void;
+    /** Sends an unsubscription request for a specific data type. */
+    unsubscribe(reservoirId: string, dataType: string): void;
+    /** The currently subscribed reservoir ID. */
+    getCurrentReservoirId(): string | null;
+    private unsubscribeStreams;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReservoirWebSocketService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ReservoirWebSocketService>;
+}

package/lib/services/video/index.d.ts

@@ -0,0 +1,2 @@
+export { VideoCallRestService } from './video-call-rest.service';
+export { VideoCallWebSocketService } from './video-call-websocket.service';

package/lib/services/video/video-call-rest.service.d.ts

@@ -0,0 +1,19 @@
+import { Observable } from 'rxjs';
+import { TgmHttpClient } from '../../core/http-client.service';
+import { ApiResponse, PagedResponse } from '../../models/base.models';
+import { VideoCall, InitiateCallRequest, VideoCallTokenResponse } from '../../models/video/video-call.models';
+import * as i0 from "@angular/core";
+export declare class VideoCallRestService {
+    private http;
+    private readonly basePath;
+    constructor(http: TgmHttpClient);
+    initiateCall(request: InitiateCallRequest): Observable<ApiResponse<VideoCall>>;
+    answerCall(callId: number, accepted: boolean): Observable<ApiResponse<VideoCallTokenResponse | null>>;
+    joinCall(callId: number): Observable<ApiResponse<VideoCallTokenResponse>>;
+    endCall(callId: number): Observable<ApiResponse<void>>;
+    getCall(callId: number): Observable<ApiResponse<VideoCall>>;
+    getCallHistory(companyId: number, page?: number, size?: number): Observable<ApiResponse<PagedResponse<VideoCall>>>;
+    getActiveCall(companyId: number): Observable<ApiResponse<VideoCall | null>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VideoCallRestService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VideoCallRestService>;
+}

package/lib/services/video/video-call-websocket.service.d.ts

@@ -0,0 +1,31 @@
+import { OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
+import { WebSocketService } from '../../core/websocket.service';
+import { VideoCall, InitiateCallRequest, VideoCallTokenResponse, IncomingCallEvent, CallAnsweredEvent, CallEndedEvent } from '../../models/video/video-call.models';
+import * as i0 from "@angular/core";
+export declare class VideoCallWebSocketService implements OnDestroy {
+    private ws;
+    private destroy$;
+    /** Incoming call notification (for targets) */
+    readonly incomingCall$: Observable<IncomingCallEvent>;
+    /** Call initiated confirmation (for initiator) */
+    readonly callInitiated$: Observable<VideoCall>;
+    /** Call answered notification */
+    readonly callAnswered$: Observable<CallAnsweredEvent>;
+    /** LiveKit token delivery (after accepting call) */
+    readonly callToken$: Observable<VideoCallTokenResponse>;
+    /** Call ended notification */
+    readonly callEnded$: Observable<CallEndedEvent>;
+    /** Call rejected notification */
+    readonly callRejected$: Observable<CallAnsweredEvent>;
+    /** Error messages */
+    readonly errors$: Observable<any>;
+    constructor(ws: WebSocketService);
+    initiateCall(request: InitiateCallRequest): void;
+    answerCall(callId: number, accepted: boolean): void;
+    endCall(callId: number): void;
+    rejectCall(callId: number): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VideoCallWebSocketService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VideoCallWebSocketService>;
+}

package/lib/tgm-sdk.config.d.ts

@@ -0,0 +1,36 @@
+import { InjectionToken } from '@angular/core';
+export interface TokenStorageStrategy {
+    getToken(): string | null;
+    setToken(token: string): void;
+    removeToken(): void;
+    getRefreshToken(): string | null;
+    setRefreshToken(token: string): void;
+    removeRefreshToken(): void;
+}
+export interface TgmSdkConfig {
+    /** Base URL of the TGM Manager backend (e.g., 'http://localhost:1337') */
+    baseUrl: string;
+    /** Static client identifier for multi-tenancy (X-Client-ID header) */
+    clientId?: string;
+    /** WebSocket endpoint path (defaults to '/ws') */
+    wsEndpoint?: string;
+    /** Custom token storage strategy. Defaults to in-memory storage. */
+    tokenStorage?: TokenStorageStrategy;
+    /** Whether to automatically refresh tokens on 401 (defaults to true) */
+    autoRefresh?: boolean;
+    /** Token key name used in auth responses (defaults to 'jwt') */
+    tokenKey?: string;
+    /** Refresh token key name (defaults to 'refreshToken') */
+    refreshTokenKey?: string;
+}
+export declare const TGM_SDK_CONFIG: InjectionToken<TgmSdkConfig>;
+export declare class InMemoryTokenStorage implements TokenStorageStrategy {
+    private token;
+    private refreshToken;
+    getToken(): string | null;
+    setToken(token: string): void;
+    removeToken(): void;
+    getRefreshToken(): string | null;
+    setRefreshToken(token: string): void;
+    removeRefreshToken(): void;
+}

package/lib/tgm-sdk.module.d.ts

@@ -0,0 +1,13 @@
+import { ModuleWithProviders } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { TgmSdkConfig } from './tgm-sdk.config';
+import { TgmHttpClient } from './core/http-client.service';
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/common/http";
+export declare function tgmHttpClientFactory(http: HttpClient, config: TgmSdkConfig | null): TgmHttpClient;
+export declare class TgmSdkModule {
+    static forRoot(config: TgmSdkConfig): ModuleWithProviders<TgmSdkModule>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TgmSdkModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<TgmSdkModule, never, [typeof i1.HttpClientModule], never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<TgmSdkModule>;
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@en-solutions/tgm-client-sdk",
+  "version": "1.6.21",
+  "description": "TGM Manager Client SDK for Angular 18 - Type-safe services for all TGM API endpoints",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EN-Solutions/tgm-client-sdk.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/common": "^18.0.0",
+    "@angular/core": "^18.0.0",
+    "@angular/forms": "^18.0.0",
+    "rxjs": "^7.8.0"
+  },
+  "dependencies": {
+    "@stomp/stompjs": "^7.0.0",
+    "livekit-client": "^2.0.0",
+    "sockjs-client": "^1.6.1",
+    "tslib": "^2.3.0"
+  },
+  "module": "fesm2022/en-solutions-tgm-client-sdk.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2022": "./esm2022/en-solutions-tgm-client-sdk.mjs",
+      "esm": "./esm2022/en-solutions-tgm-client-sdk.mjs",
+      "default": "./fesm2022/en-solutions-tgm-client-sdk.mjs"
+    }
+  },
+  "sideEffects": false
+}

package/public-api.d.ts

@@ -0,0 +1,42 @@
+export { TgmSdkModule } from './lib/tgm-sdk.module';
+export { TGM_SDK_CONFIG, TgmSdkConfig, TokenStorageStrategy, InMemoryTokenStorage } from './lib/tgm-sdk.config';
+export { TgmHttpClient, TgmSdkError, RequestOptions } from './lib/core/http-client.service';
+export { WebSocketService, ConnectionState } from './lib/core/websocket.service';
+export { AuthInterceptor } from './lib/core/auth-interceptor';
+export { ClientInterceptor } from './lib/core/client-interceptor';
+export { TgmApiError, mapHttpError } from './lib/core/error-handler';
+export * from './lib/models';
+export * from './lib/services';
+export { ScheduledReportService } from './lib/services/api/scheduled-report.service';
+export { EntityCommentService } from './lib/services/api/entity-comment.service';
+export { AuditEntryService } from './lib/services/api/audit-entry.service';
+export { VideoCallModule } from './lib/components/video-call/video-call.module';
+export { VideoRoomComponent } from './lib/components/video-call/video-room/video-room.component';
+export { VideoControlsComponent } from './lib/components/video-call/video-controls/video-controls.component';
+export { VideoParticipantComponent } from './lib/components/video-call/video-participant/video-participant.component';
+export { IncomingCallComponent } from './lib/components/video-call/incoming-call/incoming-call.component';
+export { LivekitRoomService } from './lib/components/video-call/services/livekit-room.service';
+export { VideoCallSignalingService } from './lib/components/video-call/services/video-call-signaling.service';
+export { VideoCallStateService, VideoCallState } from './lib/components/video-call/services/video-call-state.service';
+export { ParticipantInfo } from './lib/components/video-call/types/video-call.types';
+export { ReportingModule } from './lib/components/reporting/reporting.module';
+export { ReportTemplateListComponent } from './lib/components/reporting/report-template-list/report-template-list.component';
+export { ReportGenerateDialogComponent } from './lib/components/reporting/report-generate-dialog/report-generate-dialog.component';
+export { ReportDefinitionListComponent } from './lib/components/reporting/report-definition-list/report-definition-list.component';
+export { ReportDefinitionFormComponent } from './lib/components/reporting/report-definition-form/report-definition-form.component';
+export { GeneratedReportListComponent } from './lib/components/reporting/generated-report-list/generated-report-list.component';
+export { ReportStatsComponent, StatCard } from './lib/components/reporting/report-stats/report-stats.component';
+export { ExportButtonComponent, ExportFormat } from './lib/components/reporting/export-button/export-button.component';
+export { DatabaseManagerModule } from './lib/components/database-manager/database-manager.module';
+export { DatabaseManagerComponent } from './lib/components/database-manager/database-manager/database-manager.component';
+export { ObjectBrowserComponent } from './lib/components/database-manager/object-browser/object-browser.component';
+export { QueryEditorComponent } from './lib/components/database-manager/query-editor/query-editor.component';
+export { QueryToolbarComponent } from './lib/components/database-manager/query-toolbar/query-toolbar.component';
+export { ResultsGridComponent } from './lib/components/database-manager/results-grid/results-grid.component';
+export { TableStructureComponent } from './lib/components/database-manager/table-structure/table-structure.component';
+export { TableDataViewerComponent } from './lib/components/database-manager/table-data-viewer/table-data-viewer.component';
+export { RecordDetailComponent } from './lib/components/database-manager/record-detail/record-detail.component';
+export { EntitySchemaService } from './lib/components/database-manager/services/entity-schema.service';
+export { QueryExecutorService } from './lib/components/database-manager/services/query-executor.service';
+export { EntityFieldMeta, EntityRegistryEntry, QueryModel, QueryResult, DatabaseManagerConfig, EditorTab, EntityModuleGroup, } from './lib/components/database-manager/types/database-manager.types';
+export { ENTITY_REGISTRY, DEFAULT_EXCLUDED_ENTITIES, MODULE_LABELS, ENTITY_SERVICE_MAP } from './lib/components/database-manager/registry/entity-registry';