@bradtech/sensor-lorawan 1.1.0

package/dist/BradOSCodec.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Standard decoded telemetry channel extracted from a binary LoRaWAN payload frame.
+ */
+export interface DecodedRawChannel {
+    /** Semantic channel type corresponding to the decoded physical quantity */
+    channelType: 'canopy_temp' | 'canopy_hum' | 'soil_moisture' | 'soil_temp' | 'soil_ec' | 'solar' | 'rain' | 'wind_speed' | 'wind_dir' | 'pressure' | 'battery' | 'acoustic_spl' | 'acoustic_rain' | 'acoustic_wind' | 'generic';
+    /** Numerical value extracted from the 32-bit floating point payload */
+    rawValue: number;
+    /** Physical hardware transducer manufacturer identifier (e.g. 'SHT40', 'Brad soil sensor', 'SI1145', 'BMP280') */
+    sensorSource?: string;
+    /** Full commercial model name of the sensor component (e.g. 'Sensirion SHT40', 'Silicon Labs SI1145') */
+    sensorModel?: string;
+    /** Depth placement in centimeters for multi-layer soil probes (10, 20, 30 cm) */
+    depthCm?: number;
+    /** Optional unit hint for human diagnostic display */
+    unitHint?: string;
+}
+/**
+ * Decoded fields extracted from the 9-byte BradOS boot frame (FPort 1).
+ */
+export interface DecodedBootPayload {
+    /** Firmware semantic version string (e.g. "2.1.0") */
+    version: string;
+    /** Build day of year code (e.g. 236 for DOY 236) */
+    buildDoy: number;
+    /** Battery voltage at boot in millivolts */
+    batteryMv: number;
+    /** Microcontroller hardware reset reason bitmask/code */
+    resetReason: number;
+}
+/**
+ * BradOS Binary LoRaWAN Payload Codec.
+ *
+ * Decodes compact IEEE 754 Float32 Little-Endian telemetry payloads and maps
+ * LoRaWAN FPort identifiers to hardware sensor sources and physical channels.
+ */
+export declare class BradOSCodec {
+    /**
+     * Decodes a Base64-encoded string or raw binary Buffer into an IEEE 754 32-bit Little-Endian float.
+     *
+     * @param data - Base64 string from ChirpStack or Node.js Buffer.
+     * @returns Decoded number, or null if buffer length is invalid (< 4 bytes).
+     */
+    static decodeFloat32(data: string | Buffer): number | null;
+    /**
+     * Decodes the 9-byte BradOS boot payload frame transmitted on FPort 1.
+     *
+     * Byte layout:
+     * - Byte 0..2: Major, Minor, Patch version (uint8, uint8, uint8)
+     * - Byte 3..4: Build Day-of-Year (uint16 LE)
+     * - Byte 5..6: Battery voltage in mV (uint16 LE)
+     * - Byte 7: Hardware reset reason (uint8)
+     *
+     * @param data - Base64 string or binary buffer.
+     * @returns Decoded boot parameters, or null if corrupted.
+     */
+    static decodeBootPayload(data: string | Buffer): DecodedBootPayload | null;
+    /**
+     * Maps an incoming LoRaWAN FPort number and binary payload to a standard channel descriptor
+     * with automatic hardware sensor attribution (SHT40, Brad soil sensor, Davis, SI1145, BMP280, MP34DT01).
+     *
+     * @param fPort - LoRaWAN Application Port number.
+     * @param data - Base64 string or raw binary buffer containing the 4-byte Float32 payload.
+     * @returns Decoded raw channel descriptor, or null if payload is malformed.
+     */
+    static decodeFPortChannel(fPort: number, data: string | Buffer): DecodedRawChannel | null;
+}
+//# sourceMappingURL=BradOSCodec.d.ts.map

package/dist/BradOSCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BradOSCodec.d.ts","sourceRoot":"","sources":["../src/BradOSCodec.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC/B,2EAA2E;IAC3E,WAAW,EACN,aAAa,GACb,YAAY,GACZ,eAAe,GACf,WAAW,GACX,SAAS,GACT,OAAO,GACP,MAAM,GACN,YAAY,GACZ,UAAU,GACV,UAAU,GACV,SAAS,GACT,cAAc,GACd,eAAe,GACf,eAAe,GACf,SAAS,CAAA;IACd,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;IAChB,kHAAkH;IAClH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yGAAyG;IACzG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAChC,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACrB;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;IAU1D;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAuB1E;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,GAAG,IAAI;CAmD3F"}

package/dist/BradOSCodec.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BradOSCodec = void 0;
+/**
+ * BradOS Binary LoRaWAN Payload Codec.
+ *
+ * Decodes compact IEEE 754 Float32 Little-Endian telemetry payloads and maps
+ * LoRaWAN FPort identifiers to hardware sensor sources and physical channels.
+ */
+class BradOSCodec {
+    /**
+     * Decodes a Base64-encoded string or raw binary Buffer into an IEEE 754 32-bit Little-Endian float.
+     *
+     * @param data - Base64 string from ChirpStack or Node.js Buffer.
+     * @returns Decoded number, or null if buffer length is invalid (< 4 bytes).
+     */
+    static decodeFloat32(data) {
+        try {
+            const buffer = typeof data === 'string' ? Buffer.from(data, 'base64') : data;
+            if (buffer.length < 4)
+                return null;
+            return buffer.readFloatLE(0);
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    /**
+     * Decodes the 9-byte BradOS boot payload frame transmitted on FPort 1.
+     *
+     * Byte layout:
+     * - Byte 0..2: Major, Minor, Patch version (uint8, uint8, uint8)
+     * - Byte 3..4: Build Day-of-Year (uint16 LE)
+     * - Byte 5..6: Battery voltage in mV (uint16 LE)
+     * - Byte 7: Hardware reset reason (uint8)
+     *
+     * @param data - Base64 string or binary buffer.
+     * @returns Decoded boot parameters, or null if corrupted.
+     */
+    static decodeBootPayload(data) {
+        try {
+            const buffer = typeof data === 'string' ? Buffer.from(data, 'base64') : data;
+            if (buffer.length < 8)
+                return null;
+            const major = buffer.readUInt8(0);
+            const minor = buffer.readUInt8(1);
+            const patch = buffer.readUInt8(2);
+            const buildDoy = buffer.readUInt16LE(3);
+            const batteryMv = buffer.readUInt16LE(5);
+            const resetReason = buffer.readUInt8(7);
+            return {
+                version: `${major}.${minor}.${patch}`,
+                buildDoy,
+                batteryMv,
+                resetReason,
+            };
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    /**
+     * Maps an incoming LoRaWAN FPort number and binary payload to a standard channel descriptor
+     * with automatic hardware sensor attribution (SHT40, Brad soil sensor, Davis, SI1145, BMP280, MP34DT01).
+     *
+     * @param fPort - LoRaWAN Application Port number.
+     * @param data - Base64 string or raw binary buffer containing the 4-byte Float32 payload.
+     * @returns Decoded raw channel descriptor, or null if payload is malformed.
+     */
+    static decodeFPortChannel(fPort, data) {
+        const floatVal = this.decodeFloat32(data);
+        if (floatVal === null)
+            return null;
+        switch (fPort) {
+            case 2:
+                return { channelType: 'battery', rawValue: floatVal, sensorSource: 'ASR6502 ADC', sensorModel: 'Internal ADC', unitHint: 'V' };
+            case 9:
+                return { channelType: 'solar', rawValue: floatVal, sensorSource: 'SI1145', sensorModel: 'Silicon Labs SI1145', unitHint: 'index' };
+            case 11:
+                return { channelType: 'canopy_hum', rawValue: floatVal, sensorSource: 'SHT40', sensorModel: 'Sensirion SHT40', unitHint: '%' };
+            case 12:
+                return { channelType: 'soil_moisture', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 10cm', depthCm: 10, unitHint: '%' };
+            case 13:
+                return { channelType: 'soil_moisture', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 20cm', depthCm: 20, unitHint: '%' };
+            case 14:
+                return { channelType: 'soil_moisture', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 30cm', depthCm: 30, unitHint: '%' };
+            case 15:
+                return { channelType: 'canopy_temp', rawValue: floatVal, sensorSource: 'SHT40', sensorModel: 'Sensirion SHT40', unitHint: '°C' };
+            case 16:
+                return { channelType: 'soil_temp', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 10cm', depthCm: 10, unitHint: '°C' };
+            case 17:
+                return { channelType: 'soil_temp', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 20cm', depthCm: 20, unitHint: '°C' };
+            case 18:
+                return { channelType: 'soil_temp', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 30cm', depthCm: 30, unitHint: '°C' };
+            case 19:
+                return { channelType: 'solar', rawValue: floatVal, sensorSource: 'SI1145', sensorModel: 'Silicon Labs SI1145', unitHint: 'W/m²' };
+            case 20:
+                return { channelType: 'rain', rawValue: floatVal, sensorSource: 'Davis 7852', sensorModel: 'Davis Rain Collector', unitHint: 'mm' };
+            case 21:
+                return { channelType: 'wind_speed', rawValue: floatVal, sensorSource: 'Davis 6410', sensorModel: 'Davis Anemometer', unitHint: 'km/h' };
+            case 22:
+                return { channelType: 'wind_dir', rawValue: floatVal, sensorSource: 'Davis 6410', sensorModel: 'Davis Vane', unitHint: '°' };
+            case 23:
+                return { channelType: 'pressure', rawValue: floatVal, sensorSource: 'BMP280', sensorModel: 'Bosch BMP280', unitHint: 'hPa' };
+            case 24:
+                return { channelType: 'acoustic_spl', rawValue: floatVal, sensorSource: 'MP34DT01', sensorModel: 'ST MEMS Microphone', unitHint: 'dBA' };
+            case 25:
+                return { channelType: 'acoustic_rain', rawValue: floatVal, sensorSource: 'MP34DT01', sensorModel: 'ST MEMS Microphone', unitHint: 'index' };
+            case 26:
+                return { channelType: 'acoustic_wind', rawValue: floatVal, sensorSource: 'MP34DT01', sensorModel: 'ST MEMS Microphone', unitHint: 'index' };
+            case 31:
+                return { channelType: 'soil_ec', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 10cm', depthCm: 10, unitHint: 'mS/cm' };
+            case 32:
+                return { channelType: 'soil_ec', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 20cm', depthCm: 20, unitHint: 'mS/cm' };
+            case 33:
+                return { channelType: 'soil_ec', rawValue: floatVal, sensorSource: 'Brad soil sensor', sensorModel: 'Brad Soil Sensor 30cm', depthCm: 30, unitHint: 'mS/cm' };
+            default:
+                return { channelType: 'generic', rawValue: floatVal };
+        }
+    }
+}
+exports.BradOSCodec = BradOSCodec;
+//# sourceMappingURL=BradOSCodec.js.map

package/dist/BradOSCodec.js.map

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

package/dist/LoRaWanPipeline.d.ts

@@ -0,0 +1,142 @@
+import type { CompanyUri, DeviceUri, OkfMetricUri, PlotUri } from '@bradtech/types';
+/**
+ * Pure LoRaWAN Uplink message contract from ChirpStack or external Network Server.
+ * Contains purely radio, frame counter, port, and raw binary payload data.
+ * Note: Hardware probe payloads NEVER contain agronomic or soil calibration parameters.
+ */
+export interface PipelineUplinkInput {
+    /** Device metadata from Network Server */
+    deviceInfo?: {
+        /** 64-bit IEEE Extended Unique Identifier in hex (e.g. "0018b20000001234") */
+        devEui?: string;
+        /** Human device name (e.g. "b25s004" or "b26w001") */
+        deviceName?: string;
+        /** ChirpStack Application UUID */
+        applicationId?: string;
+        /** ChirpStack Application Name */
+        applicationName?: string;
+        /** Optional generic Network Server metadata tags */
+        tags?: Record<string, string>;
+    };
+    /** Alternative flat devEUI property */
+    devEUI?: string;
+    /** LoRaWAN Application Port (FPort) indicating the physical channel */
+    fPort?: number;
+    /** Frame uplink counter */
+    fCnt?: number;
+    /** Base64-encoded binary payload string */
+    data?: string;
+    /** Array of receiving gateway metadata records (RSSI, SNR, GPS) */
+    rxInfo?: Array<{
+        gatewayId?: string;
+        rssi?: number;
+        snr?: number;
+        location?: {
+            latitude?: number;
+            longitude?: number;
+            altitude?: number;
+        };
+    }>;
+    /** Transmission RF metadata (frequency in Hz, DataRate) */
+    txInfo?: {
+        frequency?: number;
+        dataRate?: number;
+    };
+    /** ISO 8601 message publication timestamp */
+    publishedAt?: string;
+    /** Alternative ISO 8601 message timestamp */
+    time?: string;
+}
+/**
+ * Agronomic & Plot context resolved from the Backoffice / Master Data Management database.
+ * The Backoffice links a physical probe (devEUI) to an agricultural parcel (Plot),
+ * with its specific soil profile, texture classification, and optional lab calibration model.
+ */
+export interface AgronomicPlotContext {
+    /** Canonical Plot identifier or URI (e.g. "plots/parcelle-nord-01" or "parcelle-nord-01") */
+    plot?: PlotUri | (string & {});
+    /** Canonical Company / Tenant identifier or URI (e.g. "companies/domaine-alpha" or "domaine-alpha") */
+    company?: CompanyUri | (string & {});
+    /** Soil texture classification assigned to the plot in Backoffice (e.g. "clay", "sand", "loam", "silt", "peat") */
+    soilTexture?: 'sand' | 'loam' | 'clay' | 'silt' | 'peat' | 'default' | (string & {});
+    /** Custom plot-specific laboratory calibration model (linear regression: y = slope * raw + intercept) */
+    soilLinearRegression?: {
+        slope: number;
+        intercept: number;
+        modelLabel?: string;
+    };
+    /** Optional hardware vendor tag */
+    vendor?: string;
+    /** Optional hardware model tag */
+    vendorModel?: string;
+}
+/**
+ * Normalized output contract representing an immutable DataPoint ready for PostgreSQL storage.
+ */
+export interface PipelineDataPointOutput {
+    /** Canonical device URI (e.g. 'probes/b25s004' or 'weather-stations/b26w001') */
+    device: DeviceUri | (string & {});
+    /** Canonical plot URI (e.g. 'plots/e5eadee3-...') */
+    plot?: PlotUri | (string & {});
+    /** Canonical company/tenant URI (e.g. 'companies/32c18f05-...') */
+    company?: CompanyUri | (string & {});
+    /** Canonical OKF metric identifier */
+    metric: OkfMetricUri | (string & {});
+    /** Calibrated numerical value */
+    value: number;
+    /** Human-readable physical unit symbol */
+    unit: string;
+    /** Kind indicator: 'measured' for direct sensor readings, 'computed' for agronomic algorithms */
+    kind: 'measured' | 'computed';
+    /** Quality and confidence score between 0.0 and 1.0 */
+    confidence: number;
+    /** Observation timestamp */
+    timestamp: string;
+    /** Comprehensive metadata contract */
+    metadata: Record<string, any>;
+}
+/**
+ * End-to-End LoRaWAN Telemetry Ingestion & Transformation Pipeline.
+ *
+ * Coordinates:
+ * - IEEE 754 Float32 binary decoding via `BradOSCodec`.
+ * - Automatic hardware sensor attribution (SHT40, Brad soil sensor, Davis, SI1145, BMP280, MP34DT01).
+ * - Routing to decoupled domain converter packages (`@bradtech/sensor-*`).
+ * - Agronomic context enrichment from Backoffice (Plot association, Soil profile, Custom calibration curves).
+ */
+export declare class LoRaWanPipeline {
+    private static _airConverter;
+    private static _soilMoistureConverter;
+    private static _soilWpConverter;
+    private static _soilTempConverter;
+    private static _soilEcConverter;
+    private static _solarConverter;
+    private static _rainConverter;
+    private static _windConverter;
+    private static _baroConverter;
+    private static _batteryConverter;
+    private static _acousticSplConverter;
+    private static _acousticWeatherConverter;
+    /**
+     * Ingests a raw LoRaWAN uplink message, decodes binary payload, evaluates domain converters
+     * with optional agronomic plot context provided by the Backoffice, and returns validated DataPoints.
+     *
+     * @param uplink - Incoming ChirpStack LoRaWAN message object (pure radio frame).
+     * @param agronomicContext - Optional agronomic context resolved from Backoffice (Plot ID, Soil Texture, Calibration).
+     * @returns Array of transformed DataPoints.
+     */
+    static process(uplink: PipelineUplinkInput, agronomicContext?: AgronomicPlotContext): PipelineDataPointOutput[];
+    /**
+     * Executes a converter instance and injects class name, model code, and semver version into metadata.
+     */
+    private static _runConverter;
+    /**
+     * Normalizes raw hardware device names into canonical OKF device URIs.
+     */
+    private static _buildDeviceUri;
+    /**
+     * Helper extracting linear regression calibration parameters if provided in tags.
+     */
+    private static _extractLinearRegression;
+}
+//# sourceMappingURL=LoRaWanPipeline.d.ts.map

package/dist/LoRaWanPipeline.d.ts.map

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

package/dist/LoRaWanPipeline.js

@@ -0,0 +1,280 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoRaWanPipeline = void 0;
+const defaultAdapters_1 = require("./defaultAdapters");
+const BradOSCodec_1 = require("./BradOSCodec");
+/**
+ * End-to-End LoRaWAN Telemetry Ingestion & Transformation Pipeline.
+ *
+ * Coordinates:
+ * - IEEE 754 Float32 binary decoding via `BradOSCodec`.
+ * - Automatic hardware sensor attribution (SHT40, Brad soil sensor, Davis, SI1145, BMP280, MP34DT01).
+ * - Routing to decoupled domain converter packages (`@bradtech/sensor-*`).
+ * - Agronomic context enrichment from Backoffice (Plot association, Soil profile, Custom calibration curves).
+ */
+class LoRaWanPipeline {
+    /**
+     * Ingests a raw LoRaWAN uplink message, decodes binary payload, evaluates domain converters
+     * with optional agronomic plot context provided by the Backoffice, and returns validated DataPoints.
+     *
+     * @param uplink - Incoming ChirpStack LoRaWAN message object (pure radio frame).
+     * @param agronomicContext - Optional agronomic context resolved from Backoffice (Plot ID, Soil Texture, Calibration).
+     * @returns Array of transformed DataPoints.
+     */
+    static process(uplink, agronomicContext) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+        const dataPoints = [];
+        // 1. Resolve Canonical Device & Tenancy Identifiers
+        const rawDeviceName = ((_a = uplink.deviceInfo) === null || _a === void 0 ? void 0 : _a.deviceName) || ((_b = uplink.deviceInfo) === null || _b === void 0 ? void 0 : _b.devEui) || uplink.devEUI || 'unknown';
+        const deviceUri = this._buildDeviceUri(rawDeviceName);
+        // Plot & Company resolved from Backoffice agronomic context (with fallback to metadata tags)
+        const rawPlot = (agronomicContext === null || agronomicContext === void 0 ? void 0 : agronomicContext.plot) || ((_d = (_c = uplink.deviceInfo) === null || _c === void 0 ? void 0 : _c.tags) === null || _d === void 0 ? void 0 : _d.plot);
+        const plotUri = rawPlot ? (rawPlot.startsWith('plots/') ? rawPlot : `plots/${rawPlot}`) : undefined;
+        const rawCompany = (agronomicContext === null || agronomicContext === void 0 ? void 0 : agronomicContext.company) || ((_f = (_e = uplink.deviceInfo) === null || _e === void 0 ? void 0 : _e.tags) === null || _f === void 0 ? void 0 : _f.company);
+        const companyUri = rawCompany ? (rawCompany.startsWith('companies/') ? rawCompany : `companies/${rawCompany}`) : undefined;
+        const timestamp = uplink.publishedAt || uplink.time || new Date().toISOString();
+        // Soil texture and calibration model come from the Backoffice plot definition
+        const soilTexture = (agronomicContext === null || agronomicContext === void 0 ? void 0 : agronomicContext.soilTexture) || ((_h = (_g = uplink.deviceInfo) === null || _g === void 0 ? void 0 : _g.tags) === null || _h === void 0 ? void 0 : _h.soilTexture) || 'default';
+        const soilLinearRegression = (agronomicContext === null || agronomicContext === void 0 ? void 0 : agronomicContext.soilLinearRegression) || this._extractLinearRegression((_j = uplink.deviceInfo) === null || _j === void 0 ? void 0 : _j.tags);
+        // 2. Build LoRaWAN Radio Metadata Contract
+        const bestGateway = (_k = uplink.rxInfo) === null || _k === void 0 ? void 0 : _k[0];
+        const vendor = (agronomicContext === null || agronomicContext === void 0 ? void 0 : agronomicContext.vendor) || ((_m = (_l = uplink.deviceInfo) === null || _l === void 0 ? void 0 : _l.tags) === null || _m === void 0 ? void 0 : _m.vendor) || 'brad';
+        const radioMetadata = {
+            interface: '@bradtech/types:LoRaWanMetadataInterface',
+            vendor,
+            vendorModel: (agronomicContext === null || agronomicContext === void 0 ? void 0 : agronomicContext.vendorModel) || ((_p = (_o = uplink.deviceInfo) === null || _o === void 0 ? void 0 : _o.tags) === null || _p === void 0 ? void 0 : _p.vendorModel) || (rawDeviceName.startsWith('b26w') ? 'Brad Weather Station v1' : 'Brad Soil Probe v2.5'),
+            vendorDeviceId: rawDeviceName,
+            integrationType: 'lorawan',
+            devEui: ((_q = uplink.deviceInfo) === null || _q === void 0 ? void 0 : _q.devEui) || uplink.devEUI,
+            fPort: uplink.fPort,
+            fCnt: uplink.fCnt,
+            frequency: (_r = uplink.txInfo) === null || _r === void 0 ? void 0 : _r.frequency,
+            dataRate: (_s = uplink.txInfo) === null || _s === void 0 ? void 0 : _s.dataRate,
+            rssi: bestGateway === null || bestGateway === void 0 ? void 0 : bestGateway.rssi,
+            snr: bestGateway === null || bestGateway === void 0 ? void 0 : bestGateway.snr,
+            gatewayId: bestGateway === null || bestGateway === void 0 ? void 0 : bestGateway.gatewayId,
+            gatewayCount: ((_t = uplink.rxInfo) === null || _t === void 0 ? void 0 : _t.length) || 0,
+        };
+        // 3. Emit Network Quality DataPoints
+        if ((bestGateway === null || bestGateway === void 0 ? void 0 : bestGateway.rssi) !== undefined) {
+            dataPoints.push({
+                device: deviceUri,
+                plot: plotUri,
+                company: companyUri,
+                metric: 'okf:radio/lorawan/rssi',
+                value: bestGateway.rssi,
+                unit: 'dBm',
+                kind: 'measured',
+                confidence: 1.0,
+                timestamp,
+                metadata: radioMetadata,
+            });
+        }
+        if ((bestGateway === null || bestGateway === void 0 ? void 0 : bestGateway.snr) !== undefined) {
+            dataPoints.push({
+                device: deviceUri,
+                plot: plotUri,
+                company: companyUri,
+                metric: 'okf:radio/lorawan/snr',
+                value: Number(bestGateway.snr.toFixed(1)),
+                unit: 'dB',
+                kind: 'measured',
+                confidence: 1.0,
+                timestamp,
+                metadata: radioMetadata,
+            });
+        }
+        // 4. Decode Payload via BradOSCodec
+        if (!uplink.fPort || !uplink.data) {
+            return dataPoints;
+        }
+        // Special Case: FPort 1 (Boot Frame)
+        if (uplink.fPort === 1) {
+            const boot = BradOSCodec_1.BradOSCodec.decodeBootPayload(uplink.data);
+            if (boot) {
+                const battOutputs = LoRaWanPipeline._batteryConverter.convert({ voltageMv: boot.batteryMv });
+                for (const b of battOutputs) {
+                    dataPoints.push({
+                        device: deviceUri,
+                        plot: plotUri,
+                        company: companyUri,
+                        metric: b.metric,
+                        value: b.value,
+                        unit: b.unit,
+                        kind: 'measured',
+                        confidence: b.confidence,
+                        timestamp,
+                        metadata: Object.assign(Object.assign(Object.assign({}, radioMetadata), { bootVersion: boot.version, buildDoy: boot.buildDoy, resetReason: boot.resetReason }), b.metadata),
+                    });
+                }
+            }
+            return dataPoints;
+        }
+        // Standard Telemetry: FPort 2 to 52
+        const channel = BradOSCodec_1.BradOSCodec.decodeFPortChannel(uplink.fPort, uplink.data);
+        if (!channel) {
+            return dataPoints;
+        }
+        const conversionOutputs = [];
+        switch (channel.channelType) {
+            case 'canopy_temp': {
+                const outputs = LoRaWanPipeline._runConverter(LoRaWanPipeline._airConverter, {
+                    temperature: channel.rawValue,
+                    humidity: 60.0,
+                });
+                const tempOut = outputs.find((o) => o.metric.includes('temperature'));
+                if (tempOut)
+                    conversionOutputs.push(tempOut);
+                break;
+            }
+            case 'canopy_hum': {
+                const outputs = LoRaWanPipeline._runConverter(LoRaWanPipeline._airConverter, {
+                    temperature: 20.0,
+                    humidity: channel.rawValue,
+                });
+                const humOut = outputs.find((o) => o.metric.includes('humidity'));
+                if (humOut)
+                    conversionOutputs.push(humOut);
+                break;
+            }
+            case 'soil_moisture': {
+                // Apply plot-specific soil texture & calibration model from agronomic context
+                const vwcOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._soilMoistureConverter, { depthCm: channel.depthCm || 10, rawValue: channel.rawValue }, { soilTexture, soilLinearRegression });
+                conversionOutputs.push(...vwcOut);
+                // Automatically compute derived pF matric potential based on plot soil texture
+                if (vwcOut.length > 0) {
+                    const wpOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._soilWpConverter, { depthCm: channel.depthCm || 10, vwcPercent: vwcOut[0].value }, { soilTexture });
+                    conversionOutputs.push(...wpOut);
+                }
+                break;
+            }
+            case 'soil_temp': {
+                const tempOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._soilTempConverter, {
+                    depthCm: channel.depthCm || 10,
+                    temperature: channel.rawValue,
+                });
+                conversionOutputs.push(...tempOut);
+                break;
+            }
+            case 'soil_ec': {
+                const ecOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._soilEcConverter, {
+                    depthCm: channel.depthCm || 10,
+                    bulkEcMsCm: channel.rawValue,
+                });
+                conversionOutputs.push(...ecOut);
+                break;
+            }
+            case 'solar': {
+                const solarOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._solarConverter, { irradianceWm2: channel.rawValue });
+                conversionOutputs.push(...solarOut);
+                break;
+            }
+            case 'rain': {
+                const rainOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._rainConverter, { tipCount: channel.rawValue });
+                conversionOutputs.push(...rainOut);
+                break;
+            }
+            case 'wind_speed': {
+                const windOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._windConverter, { speedMs: channel.rawValue });
+                conversionOutputs.push(...windOut);
+                break;
+            }
+            case 'wind_dir': {
+                const windDirOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._windConverter, { speedMs: 0, directionDegrees: channel.rawValue });
+                conversionOutputs.push(...windDirOut);
+                break;
+            }
+            case 'pressure': {
+                const baroOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._baroConverter, { pressureHpa: channel.rawValue });
+                conversionOutputs.push(...baroOut);
+                break;
+            }
+            case 'battery': {
+                const battOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._batteryConverter, { voltageV: channel.rawValue });
+                conversionOutputs.push(...battOut);
+                break;
+            }
+            case 'acoustic_spl': {
+                const splOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._acousticSplConverter, { rmsDbfs: channel.rawValue });
+                conversionOutputs.push(...splOut);
+                break;
+            }
+            case 'acoustic_rain':
+            case 'acoustic_wind': {
+                const acWeatherOut = LoRaWanPipeline._runConverter(LoRaWanPipeline._acousticWeatherConverter, {
+                    highFrequencyEnergyRms: channel.channelType === 'acoustic_rain' ? channel.rawValue : -80,
+                    lowFrequencyEnergyRms: channel.channelType === 'acoustic_wind' ? channel.rawValue : -80,
+                });
+                conversionOutputs.push(...acWeatherOut);
+                break;
+            }
+        }
+        // Map conversion outputs to final DataPoints
+        for (const out of conversionOutputs) {
+            const isDerived = out.metric.includes('potential') || out.metric.includes('par_ppfd') || out.metric.includes('percentage');
+            dataPoints.push({
+                device: deviceUri,
+                plot: plotUri,
+                company: companyUri,
+                metric: out.metric,
+                value: out.value,
+                unit: out.unit,
+                kind: isDerived ? 'computed' : 'measured',
+                confidence: out.confidence,
+                timestamp,
+                metadata: Object.assign(Object.assign(Object.assign(Object.assign({}, radioMetadata), { sensorSource: channel.sensorSource, sensorModel: channel.sensorModel }), out.metadata), { interface: isDerived ? '@bradtech/types:ComputedMetadataInterface' : '@bradtech/types:LoRaWanMetadataInterface' }),
+            });
+        }
+        return dataPoints;
+    }
+    /**
+     * Executes a converter instance and injects class name, model code, and semver version into metadata.
+     */
+    static _runConverter(converter, raw, context) {
+        const outputs = converter.convert(raw, context);
+        return outputs.map((out) => (Object.assign(Object.assign({}, out), { metadata: Object.assign({ converterClass: converter.constructor.name, modelCode: converter.modelCode, modelVersion: converter.modelVersion }, out.metadata) })));
+    }
+    /**
+     * Normalizes raw hardware device names into canonical OKF device URIs.
+     */
+    static _buildDeviceUri(deviceName) {
+        const clean = deviceName.trim().toLowerCase();
+        if (clean.startsWith('probes/') || clean.startsWith('weather-stations/')) {
+            return clean;
+        }
+        if (clean.startsWith('b26w') || clean.startsWith('station')) {
+            return `weather-stations/${clean}`;
+        }
+        return `probes/${clean}`;
+    }
+    /**
+     * Helper extracting linear regression calibration parameters if provided in tags.
+     */
+    static _extractLinearRegression(tags) {
+        if (!(tags === null || tags === void 0 ? void 0 : tags.soilSlope) || !(tags === null || tags === void 0 ? void 0 : tags.soilIntercept))
+            return undefined;
+        const slope = parseFloat(tags.soilSlope);
+        const intercept = parseFloat(tags.soilIntercept);
+        if (isNaN(slope) || isNaN(intercept))
+            return undefined;
+        return {
+            slope,
+            intercept,
+            modelLabel: tags.soilModelLabel,
+        };
+    }
+}
+exports.LoRaWanPipeline = LoRaWanPipeline;
+LoRaWanPipeline._airConverter = defaultAdapters_1.defaultSensorAdapters.canopyAir;
+LoRaWanPipeline._soilMoistureConverter = defaultAdapters_1.defaultSensorAdapters.soilMoisture;
+LoRaWanPipeline._soilWpConverter = defaultAdapters_1.defaultSensorAdapters.soilWaterPotential;
+LoRaWanPipeline._soilTempConverter = defaultAdapters_1.defaultSensorAdapters.soilTemperature;
+LoRaWanPipeline._soilEcConverter = defaultAdapters_1.defaultSensorAdapters.soilEc;
+LoRaWanPipeline._solarConverter = defaultAdapters_1.defaultSensorAdapters.solarRadiation;
+LoRaWanPipeline._rainConverter = defaultAdapters_1.defaultSensorAdapters.rainGauge;
+LoRaWanPipeline._windConverter = defaultAdapters_1.defaultSensorAdapters.wind;
+LoRaWanPipeline._baroConverter = defaultAdapters_1.defaultSensorAdapters.barometricPressure;
+LoRaWanPipeline._batteryConverter = defaultAdapters_1.defaultSensorAdapters.battery;
+LoRaWanPipeline._acousticSplConverter = defaultAdapters_1.defaultSensorAdapters.acousticSpl;
+LoRaWanPipeline._acousticWeatherConverter = defaultAdapters_1.defaultSensorAdapters.acousticWeather;
+//# sourceMappingURL=LoRaWanPipeline.js.map