@en-solutions/tgm-client-sdk 1.9.2 → 1.9.8

package/lib/models/api/component.models.d.ts

@@ -1,4 +1,4 @@
-import { ComponentType, ComponentCategory, ComponentInfoType, ComponentInfoCategory, ComponentInfoStatus, MeteringParameterType, MeteringParameterSubType, AssetPhase } from '../enums';
+import { ComponentType, ComponentCategory, ComponentInfoType, ComponentInfoCategory, ComponentInfoStatus, MeteringParameterType, MeteringParameterSubType, AssetPhase, ChainSegment } from '../enums';
 import { Failure } from './failure.models';
 import { StrapiFile } from './media.models';
 import { TurbineType } from './misc.models';
@@ -9,6 +9,8 @@ export interface Component {
     description?: string;
     type?: ComponentType;
     category?: ComponentCategory;
+    /** Position in the electricity value chain (GENERATION / TRANSMISSION / DISTRIBUTION). */
+    chainSegment?: ChainSegment;
     status?: ComponentInfoStatus;
     isActive?: boolean;
     isSubComponent?: boolean;
@@ -107,6 +109,8 @@ export type ComponentUpdateRequest = ComponentCreateRequest;
 export interface ComponentGroup {
     id: number;
     name: string;
+    /** Position in the electricity value chain (GENERATION / TRANSMISSION / DISTRIBUTION). */
+    chainSegment?: ChainSegment;
     description?: string;
     isActive?: boolean;
     code?: string;
@@ -156,6 +160,8 @@ export type ComponentGroupUpdateRequest = ComponentGroupCreateRequest;
 export interface SubAssembly {
     id: number;
     name: string;
+    /** Position in the electricity value chain (GENERATION / TRANSMISSION / DISTRIBUTION). */
+    chainSegment?: ChainSegment;
     code?: string;
     description?: string;
     isActive?: boolean;

package/lib/models/api/energy.models.d.ts

@@ -84,6 +84,10 @@ export interface OutageEvent {
     status?: OutageStatus;
     unitId?: number;
     failureId?: number;
+    /** Grid Management: the grid node this outage concerns (set for grid outages). */
+    gridNodeId?: number;
+    /** True when auto-created by the grid auto-response (vs entered manually). */
+    autoGenerated?: boolean;
     plannedStart?: string;
     plannedEnd?: string;
     actualStart?: string;
@@ -104,6 +108,36 @@ export interface OutageEvent {
     createdAt?: string;
     updatedAt?: string;
 }
+/** Per-resource-type roll-up inside an {@link OutageAnalysis} (backend: ResourceSummaryDTO). */
+export interface OutageResourceSummary {
+    resourceType?: string;
+    count: number;
+    estimatedHours: number;
+    actualHours: number;
+    variance: number;
+}
+/** Post-outage analysis contract (backend: PostOutageAnalysisDTO) returned by `getAnalysis(id)`. */
+export interface OutageAnalysis {
+    outageId: number;
+    outageNumber?: string;
+    title?: string;
+    status?: string;
+    plannedDurationHours?: number;
+    actualDurationHours?: number;
+    durationVarianceHours?: number;
+    durationVariancePercent?: number;
+    estimatedCost?: number;
+    actualCost?: number;
+    costVariance?: number;
+    costVariancePercent?: number;
+    lostRevenue?: number;
+    lostCapacityMw?: number;
+    totalResourcesAssigned?: number;
+    totalEstimatedHours?: number;
+    totalActualHours?: number;
+    resourceHoursVariance?: number;
+    resourceBreakdown?: OutageResourceSummary[];
+}
 export interface OperatingEvent {
     id: number;
     name?: string;

package/lib/models/api/grid.models.d.ts

@@ -51,5 +51,9 @@ export interface GridNodeStatus {
     parentNodeId?: number;
     lastTelemetryAt?: string;
     activeAlertSeverity?: 'INFO' | 'WARNING' | 'CRITICAL' | 'EMERGENCY' | null;
+    /** Id of the worst active SensorAlert on this node — pass to acknowledge/resolve/escalate. */
+    activeAlertId?: number | null;
     reachable: boolean;
+    /** Number of OPEN interventions covering this node (badge "travaux en cours" on the map). */
+    openInterventions?: number;
 }

package/lib/models/api/intervention.models.d.ts

@@ -211,6 +211,8 @@ export interface InterventionRequest {
     components?: any[];
     location?: any;
     company?: any;
+    /** Grid Management: grid node(s) this intervention covers (lazy — read with ?populate=gridNodeIds). */
+    gridNodeIds?: number[];
     locationId?: number;
     unitId?: number;
     componentId?: number;

package/lib/models/api/plugin.models.d.ts

@@ -10,6 +10,29 @@ export interface PluginStatus {
     status: 'INSTALLED' | 'DISABLED' | 'NOT_INSTALLED' | string;
     installedAt?: string | null;
 }
+/**
+ * Full detail of one plugin = descriptor + curated rich content + this organization's install status.
+ * Returned by `GET /api/plugins/{id}`; everything a plugin detail page needs (pure JSON, no backend UI).
+ */
+export interface PluginDetail {
+    id: string;
+    name: string;
+    version: string;
+    category: string;
+    description: string;
+    tagline: string;
+    longDescription: string;
+    features: string[];
+    dataModel: string[];
+    endpoints: string[];
+    useCases: string[];
+    dependsOn: string[];
+    requiredLicenseFeature?: string | null;
+    menuModuleId?: string | null;
+    installed: boolean;
+    status: 'INSTALLED' | 'DISABLED' | 'NOT_INSTALLED' | string;
+    installedAt?: string | null;
+}
 export interface InstalledPlugin {
     id?: number;
     pluginId: string;

package/lib/models/enums/status.enums.d.ts

@@ -278,6 +278,9 @@ export declare const WorkflowStatus: {
 };
 export type WorkflowStatus = (typeof WorkflowStatus)[keyof typeof WorkflowStatus];
 export declare const InterventionRequestStatus: {
+    readonly PENDING: "PENDING";
+    readonly THREATED: "THREATED";
+    readonly CANCELLED: "CANCELLED";
     readonly ON_HOLD: "OnHold";
     readonly ACCEPTED: "Accepted";
     readonly REJECTED: "Rejected";

package/lib/models/enums/type.enums.d.ts

@@ -81,6 +81,13 @@ export declare const ComponentType: {
     readonly HYBRID_PLANT: "HYBRIDPLANT";
 };
 export type ComponentType = (typeof ComponentType)[keyof typeof ComponentType];
+/** Position of an asset element in the electricity value chain. */
+export declare const ChainSegment: {
+    readonly GENERATION: "GENERATION";
+    readonly TRANSMISSION: "TRANSMISSION";
+    readonly DISTRIBUTION: "DISTRIBUTION";
+};
+export type ChainSegment = (typeof ChainSegment)[keyof typeof ChainSegment];
 export declare const ConversationType: {
     readonly DIRECT: "DIRECT";
     readonly GROUP: "GROUP";

package/lib/services/api/energy.service.d.ts

@@ -2,7 +2,7 @@ import { Observable } from 'rxjs';
 import { TgmHttpClient } from '../../core/http-client.service';
 import { BaseCrudService } from './base-crud.service';
 import { ApiResponse } from '../../models/base.models';
-import { AncillaryService, GridConnection, CurtailmentEvent, OutageEvent, OperatingEvent, SiteAssessment } from '../../models/api/energy.models';
+import { AncillaryService, GridConnection, CurtailmentEvent, OutageEvent, OutageAnalysis, OperatingEvent, SiteAssessment } from '../../models/api/energy.models';
 import * as i0 from "@angular/core";
 export declare class AncillaryServiceCrudService extends BaseCrudService<AncillaryService> {
     protected resourcePath: string;
@@ -26,9 +26,20 @@ export declare class OutageEventService extends BaseCrudService<OutageEvent> {
     protected resourcePath: string;
     constructor(http: TgmHttpClient);
     getGantt(start: string, end: string): Observable<ApiResponse<any>>;
-    getAnalysis(id: number): Observable<ApiResponse<any>>;
+    /** Post-outage impact analysis (backend: PostOutageAnalysisDTO). */
+    getAnalysis(id: number): Observable<ApiResponse<OutageAnalysis>>;
+    /** Schedule overlaps (backend: OverlapDTO[]). */
     getOverlaps(id: number): Observable<ApiResponse<any[]>>;
+    /** Resource conflicts (backend: ResourceConflictDTO[]). */
     getResourceConflicts(id: number): Observable<ApiResponse<any[]>>;
+    /**
+     * Lifecycle actions (backend: `POST /api/outages/{id}/approve|complete|cancel`).
+     * NB: `approve` drives the separate `approvalStatus` field (PENDING → APPROVED), while
+     * `complete`/`cancel` drive `status` (ACTIVE → COMPLETED/CANCELLED).
+     */
+    approve(id: number, notes?: string): Observable<ApiResponse<OutageEvent>>;
+    complete(id: number, notes?: string): Observable<ApiResponse<OutageEvent>>;
+    cancel(id: number): Observable<ApiResponse<OutageEvent>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<OutageEventService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<OutageEventService>;
 }

package/lib/services/api/grid.service.d.ts

@@ -4,6 +4,7 @@ import { WebSocketService } from '../../core/websocket.service';
 import { BaseCrudService } from './base-crud.service';
 import { ApiResponse } from '../../models/base.models';
 import { GridLink, GridNode, GridNodeStatus } from '../../models/api/grid.models';
+import { InterventionRequest } from '../../models/api/intervention.models';
 import * as i0 from "@angular/core";
 /** CRUD for grid nodes (`/api/grid/nodes`). Requires the grid-management plugin. */
 export declare class GridNodeService extends BaseCrudService<GridNode> {
@@ -42,6 +43,32 @@ export declare class GridService {
     recompute(): Observable<ApiResponse<{
         changed: number;
     }>>;
+    /**
+     * Admin: run the grid auto-response — opens/closes `OutageEvent`s (and maintenance tickets) from the
+     * current derived states. This is more than `recompute()` (which only persists/broadcasts states).
+     */
+    autoResponse(): Observable<ApiResponse<{
+        changed: number;
+    }>>;
+    /**
+     * Raise a maintenance intervention on a single grid node — routes the work into the core
+     * Intervention/Maintenance module, pre-filled from the node (component/location/grid link).
+     * `POST /api/grid/nodes/{id}/intervention`.
+     */
+    createIntervention(nodeId: number, body?: {
+        title?: string;
+        description?: string;
+        priority?: string;
+    }): Observable<ApiResponse<InterventionRequest>>;
+    /**
+     * Raise ONE intervention covering several grid nodes (e.g. a feeder reconfiguration).
+     * `POST /api/grid/interventions`.
+     */
+    createInterventionForNodes(gridNodeIds: number[], body?: {
+        title?: string;
+        description?: string;
+        priority?: string;
+    }): Observable<ApiResponse<InterventionRequest>>;
     /**
      * Live stream of full status snapshots pushed on `/topic/grid/status`.
      * Ensure {@link WebSocketService.connect} has been called once after login.

package/lib/services/api/plugin.service.d.ts

@@ -1,7 +1,7 @@
 import { Observable } from 'rxjs';
 import { TgmHttpClient } from '../../core/http-client.service';
 import { ApiResponse } from '../../models/base.models';
-import { InstalledPlugin, PluginStatus } from '../../models/api/plugin.models';
+import { InstalledPlugin, PluginDetail, PluginStatus } from '../../models/api/plugin.models';
 import * as i0 from "@angular/core";
 /**
  * Installable modules (plugins) for the current organization.
@@ -16,10 +16,21 @@ export declare class PluginService {
     constructor(http: TgmHttpClient);
     /** Catalog of all plugins with this organization's install status. */
     list(): Observable<ApiResponse<PluginStatus[]>>;
+    /** Full detail of one plugin (rich content + this organization's install status) — for a detail page. */
+    detail(pluginId: string): Observable<ApiResponse<PluginDetail>>;
     /** True if the given plugin is installed for the current organization. */
     isInstalled(pluginId: string): Observable<boolean>;
     install(pluginId: string): Observable<ApiResponse<InstalledPlugin>>;
     uninstall(pluginId: string): Observable<ApiResponse<void>>;
+    private platformBase;
+    /** Tenant-agnostic plugin catalog (descriptors). */
+    platformCatalog(): Observable<ApiResponse<PluginStatus[]>>;
+    /** Plugins with a specific client's install status. */
+    platformListForClient(clientId: string): Observable<ApiResponse<PluginStatus[]>>;
+    /** Install a plugin for a specific client. */
+    platformInstall(clientId: string, pluginId: string): Observable<ApiResponse<InstalledPlugin>>;
+    /** Disable a plugin for a specific client (data retained). */
+    platformUninstall(clientId: string, pluginId: string): Observable<ApiResponse<void>>;
     static ɵfac: i0.ɵɵFactoryDeclaration<PluginService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<PluginService>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@en-solutions/tgm-client-sdk",
-  "version": "1.9.2",
+  "version": "1.9.8",
   "description": "TGM Manager Client SDK for Angular 18 - Type-safe services for all TGM API endpoints",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {