@cepseudo/ngsi-ld 1.0.0

package/dist/models/environment/weather_observed.js

@@ -0,0 +1,46 @@
+import { property } from '../../helpers/property.js';
+import { buildUrn } from '../../helpers/urn.js';
+import { NGSI_LD_CORE_CONTEXT } from '../../types/context.js';
+/**
+ * Builds an NGSI-LD WeatherObserved entity.
+ */
+export function buildWeatherObserved(attrs) {
+    const entity = {
+        id: buildUrn('WeatherObserved', attrs.localId),
+        type: 'WeatherObserved',
+        '@context': NGSI_LD_CORE_CONTEXT,
+    };
+    const observedAt = attrs.dateObserved;
+    if (attrs.dateObserved !== undefined) {
+        entity['dateObserved'] = property(attrs.dateObserved);
+    }
+    if (attrs.temperature !== undefined) {
+        entity['temperature'] = property(attrs.temperature, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.relativeHumidity !== undefined) {
+        entity['relativeHumidity'] = property(attrs.relativeHumidity, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.windSpeed !== undefined) {
+        entity['windSpeed'] = property(attrs.windSpeed, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.windDirection !== undefined) {
+        entity['windDirection'] = property(attrs.windDirection, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.atmosphericPressure !== undefined) {
+        entity['atmosphericPressure'] = property(attrs.atmosphericPressure, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.precipitation !== undefined) {
+        entity['precipitation'] = property(attrs.precipitation, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.snowHeight !== undefined) {
+        entity['snowHeight'] = property(attrs.snowHeight, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.visibility !== undefined) {
+        entity['visibility'] = property(attrs.visibility, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.weatherType !== undefined) {
+        entity['weatherType'] = property(attrs.weatherType);
+    }
+    return entity;
+}
+//# sourceMappingURL=weather_observed.js.map

package/dist/models/environment/weather_observed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather_observed.js","sourceRoot":"","sources":["../../../src/models/environment/weather_observed.ts"],"names":[],"mappings":"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"}

package/dist/models/index.d.ts

@@ -0,0 +1,25 @@
+export { buildAirQualityObserved } from './environment/air_quality_observed.js';
+export type { AirQualityObservedAttributes } from './environment/air_quality_observed.js';
+export { buildWeatherObserved } from './environment/weather_observed.js';
+export type { WeatherObservedAttributes } from './environment/weather_observed.js';
+export { buildWaterQualityObserved } from './environment/water_quality_observed.js';
+export type { WaterQualityObservedAttributes } from './environment/water_quality_observed.js';
+export { buildNoiseLevelObserved } from './environment/noise_level_observed.js';
+export type { NoiseLevelObservedAttributes } from './environment/noise_level_observed.js';
+export { buildStreetLight } from './smart_city/street_light.js';
+export type { StreetLightAttributes } from './smart_city/street_light.js';
+export { buildParkingSpot } from './smart_city/parking_spot.js';
+export type { ParkingSpotAttributes } from './smart_city/parking_spot.js';
+export { buildTrafficFlowObserved } from './smart_city/traffic_flow_observed.js';
+export type { TrafficFlowObservedAttributes } from './smart_city/traffic_flow_observed.js';
+export { buildAgriParcel } from './agrifood/agri_parcel.js';
+export type { AgriParcelAttributes } from './agrifood/agri_parcel.js';
+export { buildAgriSoilMeasurement } from './agrifood/agri_soil_measurement.js';
+export type { AgriSoilMeasurementAttributes } from './agrifood/agri_soil_measurement.js';
+export { buildAgriWeatherObserved } from './agrifood/agri_weather_observed.js';
+export type { AgriWeatherObservedAttributes } from './agrifood/agri_weather_observed.js';
+export { buildDevice } from './device/device.js';
+export type { DeviceAttributes } from './device/device.js';
+export { buildDeviceMeasurement } from './device/device_measurement.js';
+export type { DeviceMeasurementAttributes } from './device/device_measurement.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAC/E,YAAY,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AAEzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAElF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAA;AACnF,YAAY,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAA;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAC/E,YAAY,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AAGzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAEzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAChF,YAAY,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAA;AAG1F,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAErE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAA;AAC9E,YAAY,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAA;AAExF,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAA;AAC9E,YAAY,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAA;AAGxF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AACvE,YAAY,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/models/index.js

@@ -0,0 +1,17 @@
+// Environment models
+export { buildAirQualityObserved } from './environment/air_quality_observed.js';
+export { buildWeatherObserved } from './environment/weather_observed.js';
+export { buildWaterQualityObserved } from './environment/water_quality_observed.js';
+export { buildNoiseLevelObserved } from './environment/noise_level_observed.js';
+// Smart City models
+export { buildStreetLight } from './smart_city/street_light.js';
+export { buildParkingSpot } from './smart_city/parking_spot.js';
+export { buildTrafficFlowObserved } from './smart_city/traffic_flow_observed.js';
+// AgriFood models
+export { buildAgriParcel } from './agrifood/agri_parcel.js';
+export { buildAgriSoilMeasurement } from './agrifood/agri_soil_measurement.js';
+export { buildAgriWeatherObserved } from './agrifood/agri_weather_observed.js';
+// Device models
+export { buildDevice } from './device/device.js';
+export { buildDeviceMeasurement } from './device/device_measurement.js';
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAG/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AAGxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAA;AAGnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAG/E,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAG/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAGhF,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAG3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAA;AAG9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAA;AAG9E,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/models/smart_city/parking_spot.d.ts

@@ -0,0 +1,14 @@
+import type { NgsiLdEntity } from '../../types/entity.js';
+export interface ParkingSpotAttributes {
+    localId: string;
+    status?: 'free' | 'occupied' | 'closed' | 'unknown';
+    category?: string[];
+    refParkingSite?: string;
+    dateModified?: string;
+    name?: string;
+}
+/**
+ * Builds an NGSI-LD ParkingSpot entity.
+ */
+export declare function buildParkingSpot(attrs: ParkingSpotAttributes): NgsiLdEntity;
+//# sourceMappingURL=parking_spot.d.ts.map

package/dist/models/smart_city/parking_spot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parking_spot.d.ts","sourceRoot":"","sources":["../../../src/models/smart_city/parking_spot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAA;AAKzE,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;IACnD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAqB3E"}

package/dist/models/smart_city/parking_spot.js

@@ -0,0 +1,27 @@
+import { property } from '../../helpers/property.js';
+import { buildUrn } from '../../helpers/urn.js';
+import { NGSI_LD_CORE_CONTEXT } from '../../types/context.js';
+/**
+ * Builds an NGSI-LD ParkingSpot entity.
+ */
+export function buildParkingSpot(attrs) {
+    const entity = {
+        id: buildUrn('ParkingSpot', attrs.localId),
+        type: 'ParkingSpot',
+        '@context': NGSI_LD_CORE_CONTEXT,
+    };
+    if (attrs.status !== undefined) {
+        entity['status'] = property(attrs.status);
+    }
+    if (attrs.category !== undefined) {
+        entity['category'] = property(attrs.category);
+    }
+    if (attrs.name !== undefined) {
+        entity['name'] = property(attrs.name);
+    }
+    if (attrs.dateModified !== undefined) {
+        entity['dateModified'] = property(attrs.dateModified);
+    }
+    return entity;
+}
+//# sourceMappingURL=parking_spot.js.map

package/dist/models/smart_city/parking_spot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parking_spot.js","sourceRoot":"","sources":["../../../src/models/smart_city/parking_spot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAW7D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IACzD,MAAM,MAAM,GAAiB;QACzB,EAAE,EAAE,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC;QAC1C,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,oBAAoB;KACnC,CAAA;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAA6B,CAAA;IAC7E,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/models/smart_city/street_light.d.ts

@@ -0,0 +1,16 @@
+import type { NgsiLdEntity } from '../../types/entity.js';
+export interface StreetLightAttributes {
+    localId: string;
+    status?: 'ok' | 'defectiveLamp' | 'columnIssue' | 'ballastProblem' | 'okLampNotWorking' | 'vandalized';
+    powerState?: 'on' | 'off' | 'low' | 'bootingUp';
+    illuminanceLevel?: number;
+    powerConsumption?: number;
+    dateLastSwitchingOn?: string;
+    dateLastSwitchingOff?: string;
+    refStreetLightGroup?: string;
+}
+/**
+ * Builds an NGSI-LD StreetLight entity.
+ */
+export declare function buildStreetLight(attrs: StreetLightAttributes): NgsiLdEntity;
+//# sourceMappingURL=street_light.d.ts.map

package/dist/models/smart_city/street_light.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"street_light.d.ts","sourceRoot":"","sources":["../../../src/models/smart_city/street_light.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAA;AAKzE,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,IAAI,GAAG,eAAe,GAAG,aAAa,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,YAAY,CAAA;IACtG,UAAU,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAA;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CA2B3E"}

package/dist/models/smart_city/street_light.js

@@ -0,0 +1,33 @@
+import { property } from '../../helpers/property.js';
+import { buildUrn } from '../../helpers/urn.js';
+import { NGSI_LD_CORE_CONTEXT } from '../../types/context.js';
+/**
+ * Builds an NGSI-LD StreetLight entity.
+ */
+export function buildStreetLight(attrs) {
+    const entity = {
+        id: buildUrn('StreetLight', attrs.localId),
+        type: 'StreetLight',
+        '@context': NGSI_LD_CORE_CONTEXT,
+    };
+    if (attrs.status !== undefined) {
+        entity['status'] = property(attrs.status);
+    }
+    if (attrs.powerState !== undefined) {
+        entity['powerState'] = property(attrs.powerState);
+    }
+    if (attrs.illuminanceLevel !== undefined) {
+        entity['illuminanceLevel'] = property(attrs.illuminanceLevel);
+    }
+    if (attrs.powerConsumption !== undefined) {
+        entity['powerConsumption'] = property(attrs.powerConsumption);
+    }
+    if (attrs.dateLastSwitchingOn !== undefined) {
+        entity['dateLastSwitchingOn'] = property(attrs.dateLastSwitchingOn);
+    }
+    if (attrs.dateLastSwitchingOff !== undefined) {
+        entity['dateLastSwitchingOff'] = property(attrs.dateLastSwitchingOff);
+    }
+    return entity;
+}
+//# sourceMappingURL=street_light.js.map

package/dist/models/smart_city/street_light.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"street_light.js","sourceRoot":"","sources":["../../../src/models/smart_city/street_light.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAa7D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IACzD,MAAM,MAAM,GAAiB;QACzB,EAAE,EAAE,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC;QAC1C,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,oBAAoB;KACnC,CAAA;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACrD,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,kBAAkB,CAAC,GAAG,QAAQ,CAAS,KAAK,CAAC,gBAAgB,CAA2B,CAAA;IACnG,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,kBAAkB,CAAC,GAAG,QAAQ,CAAS,KAAK,CAAC,gBAAgB,CAA2B,CAAA;IACnG,CAAC;IACD,IAAI,KAAK,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,CAAC,qBAAqB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;IACvE,CAAC;IACD,IAAI,KAAK,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,CAAC,sBAAsB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/models/smart_city/traffic_flow_observed.d.ts

@@ -0,0 +1,19 @@
+import type { NgsiLdEntity } from '../../types/entity.js';
+export interface TrafficFlowObservedAttributes {
+    localId: string;
+    dateObserved?: string;
+    intensity?: number;
+    occupancy?: number;
+    averageVehicleSpeed?: number;
+    averageVehicleLength?: number;
+    congested?: boolean;
+    averageHeadwayTime?: number;
+    laneId?: number;
+    laneDirection?: string;
+    vehicleType?: string;
+}
+/**
+ * Builds an NGSI-LD TrafficFlowObserved entity.
+ */
+export declare function buildTrafficFlowObserved(attrs: TrafficFlowObservedAttributes): NgsiLdEntity;
+//# sourceMappingURL=traffic_flow_observed.d.ts.map

package/dist/models/smart_city/traffic_flow_observed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic_flow_observed.d.ts","sourceRoot":"","sources":["../../../src/models/smart_city/traffic_flow_observed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAA;AAKzE,MAAM,WAAW,6BAA6B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,YAAY,CAgC3F"}

package/dist/models/smart_city/traffic_flow_observed.js

@@ -0,0 +1,37 @@
+import { property } from '../../helpers/property.js';
+import { buildUrn } from '../../helpers/urn.js';
+import { NGSI_LD_CORE_CONTEXT } from '../../types/context.js';
+/**
+ * Builds an NGSI-LD TrafficFlowObserved entity.
+ */
+export function buildTrafficFlowObserved(attrs) {
+    const entity = {
+        id: buildUrn('TrafficFlowObserved', attrs.localId),
+        type: 'TrafficFlowObserved',
+        '@context': NGSI_LD_CORE_CONTEXT,
+    };
+    const observedAt = attrs.dateObserved;
+    if (attrs.dateObserved !== undefined) {
+        entity['dateObserved'] = property(attrs.dateObserved);
+    }
+    if (attrs.intensity !== undefined) {
+        entity['intensity'] = property(attrs.intensity, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.occupancy !== undefined) {
+        entity['occupancy'] = property(attrs.occupancy, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.averageVehicleSpeed !== undefined) {
+        entity['averageVehicleSpeed'] = property(attrs.averageVehicleSpeed, observedAt ? { observedAt } : undefined);
+    }
+    if (attrs.congested !== undefined) {
+        entity['congested'] = property(attrs.congested);
+    }
+    if (attrs.laneId !== undefined) {
+        entity['laneId'] = property(attrs.laneId);
+    }
+    if (attrs.vehicleType !== undefined) {
+        entity['vehicleType'] = property(attrs.vehicleType);
+    }
+    return entity;
+}
+//# sourceMappingURL=traffic_flow_observed.js.map

package/dist/models/smart_city/traffic_flow_observed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic_flow_observed.js","sourceRoot":"","sources":["../../../src/models/smart_city/traffic_flow_observed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAgB7D;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAoC;IACzE,MAAM,MAAM,GAAiB;QACzB,EAAE,EAAE,QAAQ,CAAC,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC;QAClD,IAAI,EAAE,qBAAqB;QAC3B,UAAU,EAAE,oBAAoB;KACnC,CAAA;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAA;IAErC,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAS,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAA2B,CAAA;IAC9H,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAS,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAA2B,CAAA;IAC9H,CAAC;IACD,IAAI,KAAK,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,CAAC,qBAAqB,CAAC,GAAG,QAAQ,CAAS,KAAK,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAA2B,CAAA;IAClJ,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAS,KAAK,CAAC,MAAM,CAA2B,CAAA;IAC/E,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IACvD,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/notifications/notification_sender.d.ts

@@ -0,0 +1,16 @@
+import type { Queue } from 'bullmq';
+import type { Subscription } from '../types/subscription.js';
+import type { NgsiLdEntity } from '../types/entity.js';
+import type { NotificationJobData } from '../types/notification.js';
+/**
+ * Enqueues a notification delivery job in BullMQ.
+ *
+ * Constructs the appropriate payload (normalized or keyValues) and adds
+ * a job to the `ngsi-ld-notifications` queue.
+ *
+ * @param sub - The subscription to notify
+ * @param entity - The entity that triggered the notification
+ * @param queue - The BullMQ queue to enqueue into
+ */
+export declare function enqueueNotification(sub: Subscription, entity: NgsiLdEntity, queue: Queue<NotificationJobData>): Promise<void>;
+//# sourceMappingURL=notification_sender.d.ts.map

package/dist/notifications/notification_sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification_sender.d.ts","sourceRoot":"","sources":["../../src/notifications/notification_sender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAuB,MAAM,0BAA0B,CAAA;AAoBxF;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACrC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,KAAK,CAAC,mBAAmB,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/notifications/notification_sender.js

@@ -0,0 +1,70 @@
+import { randomUUID } from 'crypto';
+/**
+ * Builds a keyValues projection of an NGSI-LD entity.
+ */
+function toKeyValues(entity) {
+    const result = {
+        id: entity.id,
+        type: entity.type,
+    };
+    for (const [key, value] of Object.entries(entity)) {
+        if (key === 'id' || key === 'type' || key === '@context')
+            continue;
+        if (value && typeof value === 'object' && 'type' in value && 'value' in value) {
+            result[key] = value.value;
+        }
+    }
+    return result;
+}
+/**
+ * Enqueues a notification delivery job in BullMQ.
+ *
+ * Constructs the appropriate payload (normalized or keyValues) and adds
+ * a job to the `ngsi-ld-notifications` queue.
+ *
+ * @param sub - The subscription to notify
+ * @param entity - The entity that triggered the notification
+ * @param queue - The BullMQ queue to enqueue into
+ */
+export async function enqueueNotification(sub, entity, queue) {
+    const notificationId = randomUUID();
+    const notifiedAt = new Date().toISOString();
+    // Project attributes if subscription specifies them
+    let entityToSend = entity;
+    if (sub.notificationAttrs && sub.notificationAttrs.length > 0) {
+        const projected = { id: entity.id, type: entity.type };
+        for (const attr of sub.notificationAttrs) {
+            if (entity[attr] !== undefined)
+                projected[attr] = entity[attr];
+        }
+        entityToSend = projected;
+    }
+    // Validate the endpoint URI before enqueueing
+    const endpoint = sub.notificationEndpoint;
+    if (!endpoint)
+        return;
+    const jobData = {
+        subscription: sub,
+        entity: entityToSend,
+        notificationId,
+        notifiedAt,
+    };
+    await queue.add('notify', jobData, {
+        attempts: 3,
+        backoff: {
+            type: 'exponential',
+            delay: 1000,
+        },
+        removeOnComplete: 100,
+        removeOnFail: 50,
+    });
+    // Build the full notification payload (for reference, stored in job data)
+    const _payload = {
+        id: `urn:ngsi-ld:Notification:${notificationId}`,
+        type: 'Notification',
+        subscriptionId: sub.id,
+        notifiedAt,
+        data: [sub.notificationFormat === 'keyValues' ? toKeyValues(entityToSend) : entityToSend],
+    };
+}
+//# sourceMappingURL=notification_sender.js.map

package/dist/notifications/notification_sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification_sender.js","sourceRoot":"","sources":["../../src/notifications/notification_sender.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC;;GAEG;AACH,SAAS,WAAW,CAAC,MAAoB;IACrC,MAAM,MAAM,GAA4B;QACpC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;KACpB,CAAA;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,UAAU;YAAE,SAAQ;QAClE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5E,MAAM,CAAC,GAAG,CAAC,GAAI,KAA4B,CAAC,KAAK,CAAA;QACrD,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,GAAiB,EACjB,MAAoB,EACpB,KAAiC;IAEjC,MAAM,cAAc,GAAG,UAAU,EAAE,CAAA;IACnC,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAE3C,oDAAoD;IACpD,IAAI,YAAY,GAAG,MAAM,CAAA;IACzB,IAAI,GAAG,CAAC,iBAAiB,IAAI,GAAG,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;QACpE,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS;gBAAE,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAClE,CAAC;QACD,YAAY,GAAG,SAAS,CAAA;IAC5B,CAAC;IAED,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,oBAAoB,CAAA;IACzC,IAAI,CAAC,QAAQ;QAAE,OAAM;IAErB,MAAM,OAAO,GAAwB;QACjC,YAAY,EAAE,GAAG;QACjB,MAAM,EAAE,YAAY;QACpB,cAAc;QACd,UAAU;KACb,CAAA;IAED,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE;QAC/B,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE;YACL,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,IAAI;SACd;QACD,gBAAgB,EAAE,GAAG;QACrB,YAAY,EAAE,EAAE;KACnB,CAAC,CAAA;IAEF,0EAA0E;IAC1E,MAAM,QAAQ,GAAwB;QAClC,EAAE,EAAE,4BAA4B,cAAc,EAAE;QAChD,IAAI,EAAE,cAAc;QACpB,cAAc,EAAE,GAAG,CAAC,EAAE;QACtB,UAAU;QACV,IAAI,EAAE,CAAC,GAAG,CAAC,kBAAkB,KAAK,WAAW,CAAC,CAAC,CAAE,WAAW,CAAC,YAAY,CAAkB,CAAC,CAAC,CAAC,YAAY,CAAC;KAC9G,CAAA;AACL,CAAC"}

package/dist/notifications/notification_worker.d.ts

@@ -0,0 +1,19 @@
+import { Worker } from 'bullmq';
+import type { ConnectionOptions } from 'bullmq';
+import type { NotificationJobData } from '../types/notification.js';
+import type { SubscriptionStore } from '../subscriptions/subscription_store.js';
+import type { SubscriptionCache } from '../subscriptions/subscription_cache.js';
+import type { Logger } from '@cepseudo/shared';
+/**
+ * Starts the BullMQ worker that delivers NGSI-LD notifications.
+ *
+ * For each job:
+ * 1. Builds the NotificationPayload
+ * 2. HTTP POSTs to the subscriber's endpoint
+ * 3. Updates times_sent / times_failed / last_success_at in PostgreSQL
+ * 4. Updates last_notification_at in Redis
+ *
+ * Retry: exponential backoff — 1s → 5s → 25s (max 3 attempts via queue config)
+ */
+export declare function startNotificationWorker(redis: ConnectionOptions, store: SubscriptionStore, cache: SubscriptionCache, logger: Logger): Worker<NotificationJobData>;
+//# sourceMappingURL=notification_worker.d.ts.map

package/dist/notifications/notification_worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification_worker.d.ts","sourceRoot":"","sources":["../../src/notifications/notification_worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAuB,MAAM,0BAA0B,CAAA;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI9C;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,GACf,MAAM,CAAC,mBAAmB,CAAC,CAyD7B"}

package/dist/notifications/notification_worker.js

@@ -0,0 +1,65 @@
+import { Worker } from 'bullmq';
+const QUEUE_NAME = 'ngsi-ld-notifications';
+/**
+ * Starts the BullMQ worker that delivers NGSI-LD notifications.
+ *
+ * For each job:
+ * 1. Builds the NotificationPayload
+ * 2. HTTP POSTs to the subscriber's endpoint
+ * 3. Updates times_sent / times_failed / last_success_at in PostgreSQL
+ * 4. Updates last_notification_at in Redis
+ *
+ * Retry: exponential backoff — 1s → 5s → 25s (max 3 attempts via queue config)
+ */
+export function startNotificationWorker(redis, store, cache, logger) {
+    const worker = new Worker(QUEUE_NAME, async (job) => {
+        const { subscription: sub, entity, notificationId, notifiedAt } = job.data;
+        const payload = {
+            id: `urn:ngsi-ld:Notification:${notificationId}`,
+            type: 'Notification',
+            subscriptionId: sub.id,
+            notifiedAt,
+            data: [entity],
+        };
+        let success = false;
+        try {
+            const response = await fetch(sub.notificationEndpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/ld+json',
+                    'Accept': 'application/json',
+                },
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status} from ${sub.notificationEndpoint}`);
+            }
+            success = true;
+            logger.info(`Notification delivered to ${sub.notificationEndpoint} for subscription ${sub.id}`);
+        }
+        catch (err) {
+            logger.warn(`Notification delivery failed for subscription ${sub.id}: ${err instanceof Error ? err.message : String(err)}`);
+            throw err; // Re-throw so BullMQ handles retry
+        }
+        finally {
+            // Update stats regardless of success/failure (best-effort)
+            try {
+                await store.recordNotification(sub.id, success, notifiedAt);
+                await cache.updateLastNotified(sub.id, notifiedAt);
+            }
+            catch (statsErr) {
+                logger.warn(`Failed to update notification stats for ${sub.id}: ${statsErr instanceof Error ? statsErr.message : String(statsErr)}`);
+            }
+        }
+    }, {
+        connection: redis,
+        concurrency: 5,
+    });
+    worker.on('failed', (job, err) => {
+        if (job) {
+            logger.warn(`Notification job ${job.id} failed permanently: ${err.message}`);
+        }
+    });
+    return worker;
+}
+//# sourceMappingURL=notification_worker.js.map

package/dist/notifications/notification_worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification_worker.js","sourceRoot":"","sources":["../../src/notifications/notification_worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAO/B,MAAM,UAAU,GAAG,uBAAuB,CAAA;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACnC,KAAwB,EACxB,KAAwB,EACxB,KAAwB,EACxB,MAAc;IAEd,MAAM,MAAM,GAAG,IAAI,MAAM,CACrB,UAAU,EACV,KAAK,EAAC,GAAG,EAAC,EAAE;QACR,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,IAAI,CAAA;QAE1E,MAAM,OAAO,GAAwB;YACjC,EAAE,EAAE,4BAA4B,cAAc,EAAE;YAChD,IAAI,EAAE,cAAc;YACpB,cAAc,EAAE,GAAG,CAAC,EAAE;YACtB,UAAU;YACV,IAAI,EAAE,CAAC,MAAM,CAAC;SACjB,CAAA;QAED,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE;gBACnD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACL,cAAc,EAAE,qBAAqB;oBACrC,QAAQ,EAAE,kBAAkB;iBAC/B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAChC,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,SAAS,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAA;YAC/E,CAAC;YAED,OAAO,GAAG,IAAI,CAAA;YACd,MAAM,CAAC,IAAI,CAAC,6BAA6B,GAAG,CAAC,oBAAoB,qBAAqB,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;QACnG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,iDAAiD,GAAG,CAAC,EAAE,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC3H,MAAM,GAAG,CAAA,CAAC,mCAAmC;QACjD,CAAC;gBAAS,CAAC;YACP,2DAA2D;YAC3D,IAAI,CAAC;gBACD,MAAM,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;gBAC3D,MAAM,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAA;YACtD,CAAC;YAAC,OAAO,QAAQ,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,2CAA2C,GAAG,CAAC,EAAE,KAAK,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YACxI,CAAC;QACL,CAAC;IACL,CAAC,EACD;QACI,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,CAAC;KACjB,CACJ,CAAA;IAED,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC7B,IAAI,GAAG,EAAE,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,EAAE,wBAAwB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QAChF,CAAC;IACL,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,35 @@
+import type { Router } from 'ultimate-express';
+import type { DatabaseAdapter } from '@cepseudo/database';
+import { Logger } from '@cepseudo/shared';
+/**
+ * Configuration options for the NGSI-LD plugin.
+ */
+export interface NgsiLdPluginOptions {
+    /** Express Router from the engine */
+    router: Router;
+    /** Database adapter for subscription persistence */
+    db: DatabaseAdapter;
+    /** Redis connection config for entity cache and subscription cache */
+    redis: {
+        host: string;
+        port: number;
+        password?: string;
+    };
+    /** All components registered in the engine */
+    components: unknown[];
+    /** Logger instance */
+    logger: Logger;
+}
+/**
+ * Registers the NGSI-LD plugin with the Digital Twin engine.
+ *
+ * This function:
+ * 1. Connects to Redis
+ * 2. Runs the subscription table migration
+ * 3. Warms up the subscription cache
+ * 4. Registers NGSI-LD HTTP endpoints
+ * 5. Starts the notification worker
+ * 6. Listens to engineEventBus for component completion events
+ */
+export declare function registerNgsiLd(options: NgsiLdPluginOptions): Promise<void>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAA;AAczD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,EAAE,EAAE,eAAe,CAAA;IACnB,sEAAsE;IACtE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACxD,8CAA8C;IAC9C,UAAU,EAAE,OAAO,EAAE,CAAA;IACrB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGhF"}

package/dist/plugin.js

@@ -0,0 +1,113 @@
+import { Queue } from 'bullmq';
+import { Redis } from 'ioredis';
+import { engineEventBus } from '@cepseudo/shared';
+import { EntityCache } from './cache/entity_cache.js';
+import { SubscriptionStore } from './subscriptions/subscription_store.js';
+import { SubscriptionCache } from './subscriptions/subscription_cache.js';
+import { SubscriptionMatcher } from './subscriptions/subscription_matcher.js';
+import { isNgsiLdCollector, isNgsiLdHarvester } from './components/type_guards.js';
+import { enqueueNotification } from './notifications/notification_sender.js';
+import { startNotificationWorker } from './notifications/notification_worker.js';
+import { registerEntityEndpoints } from './endpoints/entities.js';
+import { registerAttrsEndpoints } from './endpoints/attrs.js';
+import { registerSubscriptionEndpoints } from './endpoints/subscriptions.js';
+import { registerTypesEndpoints } from './endpoints/types.js';
+/**
+ * Registers the NGSI-LD plugin with the Digital Twin engine.
+ *
+ * This function:
+ * 1. Connects to Redis
+ * 2. Runs the subscription table migration
+ * 3. Warms up the subscription cache
+ * 4. Registers NGSI-LD HTTP endpoints
+ * 5. Starts the notification worker
+ * 6. Listens to engineEventBus for component completion events
+ */
+export async function registerNgsiLd(options) {
+    const { router, db, redis: redisConfig, components, logger } = options;
+    // Connect to Redis
+    const redisConnection = new Redis({
+        host: redisConfig.host,
+        port: redisConfig.port,
+        password: redisConfig.password,
+        maxRetriesPerRequest: null,
+        enableReadyCheck: true,
+    });
+    // Create Redis connection for BullMQ (separate connection, same config)
+    const bullmqConnection = {
+        host: redisConfig.host,
+        port: redisConfig.port,
+        password: redisConfig.password,
+    };
+    // Initialize subsystems
+    const entityCache = new EntityCache(redisConnection);
+    const subscriptionStore = new SubscriptionStore(db);
+    const subscriptionCache = new SubscriptionCache(redisConnection);
+    const matcher = new SubscriptionMatcher(subscriptionCache);
+    // Run migration to create subscriptions table
+    await subscriptionStore.runMigration();
+    // Warm up subscription cache from database
+    const allSubs = await subscriptionStore.findAll();
+    await subscriptionCache.warmup(allSubs);
+    logger.info(`NGSI-LD plugin initialized: ${allSubs.length} subscriptions loaded`);
+    // BullMQ notification queue
+    const notificationQueue = new Queue('ngsi-ld-notifications', {
+        connection: bullmqConnection,
+    });
+    // Register HTTP endpoints
+    registerEntityEndpoints(router, entityCache, subscriptionStore, subscriptionCache);
+    registerAttrsEndpoints(router, entityCache);
+    registerSubscriptionEndpoints(router, subscriptionStore, subscriptionCache);
+    registerTypesEndpoints(router, entityCache);
+    // Start notification delivery worker
+    startNotificationWorker(bullmqConnection, subscriptionStore, subscriptionCache, logger);
+    // Listen to engine events for NGSI-LD-aware components
+    engineEventBus.on('component:event', async (event) => {
+        if (event.type !== 'collector:completed' &&
+            event.type !== 'harvester:completed') {
+            return;
+        }
+        const component = components.find(c => {
+            if (!c || typeof c !== 'object')
+                return false;
+            const conf = c.getConfiguration?.();
+            return conf?.name === event.componentName;
+        });
+        if (!component)
+            return;
+        if (!isNgsiLdCollector(component) && !isNgsiLdHarvester(component))
+            return;
+        try {
+            // Get the latest record from database
+            const record = await db.getLatestByName(event.componentName);
+            if (!record)
+                return;
+            // Parse the data
+            const blob = await record.data();
+            let data;
+            try {
+                data = JSON.parse(blob.toString());
+            }
+            catch {
+                data = blob.toString();
+            }
+            // Convert to NGSI-LD entity
+            const entity = component.toNgsiLdEntity(data, record);
+            const oldEntity = await entityCache.get(entity.id);
+            // Update cache
+            await entityCache.set(entity);
+            // Evaluate subscriptions
+            const matchingSubIds = await matcher.match(entity, oldEntity ?? undefined);
+            for (const subId of matchingSubIds) {
+                const sub = await subscriptionCache.getById(subId);
+                if (sub) {
+                    await enqueueNotification(sub, entity, notificationQueue);
+                }
+            }
+        }
+        catch (err) {
+            logger.warn(`NGSI-LD event processing failed for ${event.componentName}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+//# sourceMappingURL=plugin.js.map