@openeld/openeld 0.1.0

package/proto/providers/eld/keeptruckin/contracts.proto

@@ -0,0 +1,103 @@
+syntax = "proto3";
+
+package openeld.providers.eld.keeptruckin.v1;
+
+import "google/protobuf/timestamp.proto";
+import "providers/eld/shared/common.proto";
+
+// * Represents a legacy KeepTruckin driver record.
+message KeeptruckinDriverRecord {
+  string id = 1;
+  optional string first_name = 2;
+  optional string last_name = 3;
+  optional string status = 4;
+  optional string license_number = 5;
+  optional openeld.providers.eld.shared.v1.EldDriverRecord normalized_projection = 20;
+}
+
+// * Represents a legacy KeepTruckin vehicle record.
+message KeeptruckinVehicleRecord {
+  string id = 1;
+  optional string number = 2;
+  optional string vin = 3;
+  optional double odometer_meters = 4;
+  optional double engine_hours_seconds = 5;
+  optional openeld.providers.eld.shared.v1.EldVehicleRecord normalized_projection = 20;
+}
+
+// * Represents a legacy KeepTruckin log record.
+message KeeptruckinLogRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp start_time = 4;
+  optional google.protobuf.Timestamp end_time = 5;
+  optional string status = 6;
+  optional double latitude = 7;
+  optional double longitude = 8;
+  optional string origin = 9;
+  optional string annotation = 10;
+  optional openeld.providers.eld.shared.v1.EldHosEventRecord normalized_projection = 20;
+}
+
+// * Represents a legacy KeepTruckin HOS clock record.
+message KeeptruckinHosClockRecord {
+  string driver_id = 1;
+  optional double drive_remaining_seconds = 2;
+  optional double shift_remaining_seconds = 3;
+  optional double cycle_remaining_seconds = 4;
+  optional openeld.providers.eld.shared.v1.EldHosClockRecord normalized_projection = 20;
+}
+
+// * Represents a legacy KeepTruckin location record.
+message KeeptruckinLocationRecord {
+  string id = 1;
+  optional string vehicle_id = 2;
+  optional string driver_id = 3;
+  optional google.protobuf.Timestamp timestamp = 4;
+  optional double latitude = 5;
+  optional double longitude = 6;
+  optional double speed_kilometers_per_hour = 7;
+  optional double heading_degrees = 8;
+  optional openeld.providers.eld.shared.v1.EldGpsLocationRecord normalized_projection = 20;
+}
+
+// * Represents a legacy KeepTruckin DVIR record.
+message KeeptruckinDvirRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp inspection_time = 4;
+  optional string inspection_type = 5;
+  optional bool is_safe_to_drive = 6;
+  repeated string defect_descriptions = 7;
+  optional string mechanic_notes = 8;
+  optional openeld.providers.eld.shared.v1.EldDvirRecord normalized_projection = 20;
+}
+
+// * Represents a legacy KeepTruckin diagnostic record.
+message KeeptruckinDiagnosticRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp detected_at = 4;
+  optional string type = 5;
+  optional string code = 6;
+  optional string description = 7;
+  optional bool active = 8;
+  optional openeld.providers.eld.shared.v1.EldDiagnosticRecord normalized_projection = 20;
+}
+
+// * Groups the stable subset of KeepTruckin records used by the normalization layer.
+message KeeptruckinPayload {
+  optional openeld.providers.eld.shared.v1.EldPayloadMetadata metadata = 1;
+  repeated KeeptruckinDriverRecord drivers = 2;
+  repeated KeeptruckinVehicleRecord vehicles = 3;
+  repeated openeld.providers.eld.shared.v1.EldVehicleAssignmentRecord vehicle_assignments = 4;
+  repeated KeeptruckinLogRecord hos_logs = 5;
+  repeated KeeptruckinHosClockRecord hos_clocks = 6;
+  repeated KeeptruckinLocationRecord gps_locations = 7;
+  repeated KeeptruckinDvirRecord dvirs = 8;
+  repeated KeeptruckinDiagnosticRecord diagnostics = 9;
+  repeated openeld.providers.eld.shared.v1.EldSyncCheckpoint checkpoints = 10;
+}

package/proto/providers/eld/motive/contracts.proto

@@ -0,0 +1,108 @@
+syntax = "proto3";
+
+package openeld.providers.eld.motive.v1;
+
+import "google/protobuf/timestamp.proto";
+import "providers/eld/shared/common.proto";
+
+// * Represents a Motive driver record close to the native API shape.
+message MotiveDriverRecord {
+  string id = 1;
+  optional string first_name = 2;
+  optional string last_name = 3;
+  optional string drivers_license_number = 4;
+  optional string status = 5;
+  optional string email = 6;
+  optional string phone = 7;
+  optional openeld.providers.eld.shared.v1.EldDriverRecord normalized_projection = 20;
+}
+
+// * Represents a Motive vehicle record close to the native API shape.
+message MotiveVehicleRecord {
+  string id = 1;
+  optional string number = 2;
+  optional string vin = 3;
+  optional double current_odometer_miles = 4;
+  optional double engine_hours = 5;
+  optional openeld.providers.eld.shared.v1.EldVehicleRecord normalized_projection = 20;
+}
+
+// * Represents a Motive log record with native field semantics preserved.
+message MotiveLogRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp start_time = 4;
+  optional google.protobuf.Timestamp end_time = 5;
+  optional string status = 6;
+  optional double latitude = 7;
+  optional double longitude = 8;
+  optional string origin = 9;
+  optional string annotation = 10;
+  optional double odometer_meters = 11;
+  optional double engine_hours_seconds = 12;
+  optional openeld.providers.eld.shared.v1.EldHosEventRecord normalized_projection = 20;
+}
+
+// * Represents a Motive HOS availability record.
+message MotiveHosClockRecord {
+  string driver_id = 1;
+  optional double drive_remaining_seconds = 2;
+  optional double shift_remaining_seconds = 3;
+  optional double cycle_remaining_seconds = 4;
+  optional double break_remaining_seconds = 5;
+  optional openeld.providers.eld.shared.v1.EldHosClockRecord normalized_projection = 20;
+}
+
+// * Represents a Motive vehicle location record.
+message MotiveVehicleLocationRecord {
+  string id = 1;
+  optional string vehicle_id = 2;
+  optional string driver_id = 3;
+  optional google.protobuf.Timestamp located_at = 4;
+  optional double latitude = 5;
+  optional double longitude = 6;
+  optional double speed_kilometers_per_hour = 7;
+  optional double heading_degrees = 8;
+  optional openeld.providers.eld.shared.v1.EldGpsLocationRecord normalized_projection = 20;
+}
+
+// * Represents a Motive DVIR record.
+message MotiveDvirRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp inspection_time = 4;
+  optional string inspection_type = 5;
+  optional bool is_safe_to_drive = 6;
+  repeated string defect_descriptions = 7;
+  optional string mechanic_notes = 8;
+  optional openeld.providers.eld.shared.v1.EldDvirRecord normalized_projection = 20;
+}
+
+// * Represents a Motive diagnostic record.
+message MotiveDiagnosticRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp detected_at = 4;
+  optional string type = 5;
+  optional string code = 6;
+  optional string description = 7;
+  optional bool active = 8;
+  optional openeld.providers.eld.shared.v1.EldDiagnosticRecord normalized_projection = 20;
+}
+
+// * Groups the stable subset of Motive records used by the normalization layer.
+message MotivePayload {
+  optional openeld.providers.eld.shared.v1.EldPayloadMetadata metadata = 1;
+  repeated MotiveDriverRecord drivers = 2;
+  repeated MotiveVehicleRecord vehicles = 3;
+  repeated openeld.providers.eld.shared.v1.EldVehicleAssignmentRecord vehicle_assignments = 4;
+  repeated MotiveLogRecord hos_logs = 5;
+  repeated MotiveHosClockRecord hos_clocks = 6;
+  repeated MotiveVehicleLocationRecord gps_locations = 7;
+  repeated MotiveDvirRecord dvirs = 8;
+  repeated MotiveDiagnosticRecord diagnostics = 9;
+  repeated openeld.providers.eld.shared.v1.EldSyncCheckpoint checkpoints = 10;
+}

package/proto/providers/eld/samsara/contracts.proto

@@ -0,0 +1,110 @@
+syntax = "proto3";
+
+package openeld.providers.eld.samsara.v1;
+
+import "common/primitives/location.proto";
+import "google/protobuf/timestamp.proto";
+import "providers/eld/shared/common.proto";
+
+// * Represents a Samsara driver record close to the native API shape.
+message SamsaraDriverRecord {
+  string id = 1;
+  optional string name = 2;
+  optional string license_number = 3;
+  optional string driver_activation_status = 4;
+  optional bool eld_exempt = 5;
+  optional string username = 6;
+  optional openeld.providers.eld.shared.v1.EldDriverRecord normalized_projection = 20;
+}
+
+// * Represents a Samsara vehicle record close to the native API shape.
+message SamsaraVehicleRecord {
+  string id = 1;
+  optional string name = 2;
+  optional string vin = 3;
+  optional string license_plate = 4;
+  optional double obd_odometer_meters = 5;
+  optional double engine_seconds = 6;
+  optional string eld_device_id = 7;
+  optional openeld.providers.eld.shared.v1.EldVehicleRecord normalized_projection = 20;
+}
+
+// * Represents a Samsara HOS log record with native field semantics preserved.
+message SamsaraHosLogRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp start_time = 4;
+  optional google.protobuf.Timestamp end_time = 5;
+  optional string hos_status_type = 6;
+  optional string origin = 7;
+  optional openeld.common.primitives.v1.GeoLocation start_location = 8;
+  optional string remark = 9;
+  optional bool certified = 10;
+  optional uint32 sequence_number = 11;
+  optional double odometer_meters = 12;
+  optional double engine_hours_seconds = 13;
+  optional openeld.providers.eld.shared.v1.EldHosEventRecord normalized_projection = 20;
+}
+
+// * Represents a Samsara HOS clock record.
+message SamsaraHosClockRecord {
+  string driver_id = 1;
+  optional double cycle_remaining_seconds = 2;
+  optional double shift_remaining_seconds = 3;
+  optional double drive_remaining_seconds = 4;
+  optional double break_remaining_seconds = 5;
+  optional openeld.providers.eld.shared.v1.EldHosClockRecord normalized_projection = 20;
+}
+
+// * Represents a Samsara vehicle location record.
+message SamsaraVehicleLocationRecord {
+  string vehicle_id = 1;
+  optional string driver_id = 2;
+  optional google.protobuf.Timestamp time = 3;
+  optional double latitude = 4;
+  optional double longitude = 5;
+  optional double speed_miles_per_hour = 6;
+  optional double heading_degrees = 7;
+  optional openeld.providers.eld.shared.v1.EldGpsLocationRecord normalized_projection = 20;
+}
+
+// * Represents a Samsara DVIR record.
+message SamsaraDvirRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp inspection_time = 4;
+  optional string inspection_type = 5;
+  optional bool is_safe_to_drive = 6;
+  repeated string defects = 7;
+  optional string mechanic_notes = 8;
+  optional openeld.providers.eld.shared.v1.EldDvirRecord normalized_projection = 20;
+}
+
+// * Represents a Samsara compliance diagnostic or malfunction record.
+message SamsaraDiagnosticRecord {
+  string id = 1;
+  optional string driver_id = 2;
+  optional string vehicle_id = 3;
+  optional google.protobuf.Timestamp detected_at = 4;
+  optional string type = 5;
+  optional string code = 6;
+  optional string description = 7;
+  optional bool is_active = 8;
+  optional openeld.providers.eld.shared.v1.EldDiagnosticRecord normalized_projection = 20;
+}
+
+// * Groups the stable subset of Samsara records used by the normalization layer.
+message SamsaraPayload {
+  optional openeld.providers.eld.shared.v1.EldPayloadMetadata metadata = 1;
+  repeated SamsaraDriverRecord drivers = 2;
+  repeated SamsaraVehicleRecord vehicles = 3;
+  repeated openeld.providers.eld.shared.v1.EldVehicleAssignmentRecord vehicle_assignments = 4;
+  repeated SamsaraHosLogRecord hos_logs = 5;
+  repeated SamsaraHosClockRecord hos_clocks = 6;
+  repeated SamsaraVehicleLocationRecord gps_locations = 7;
+  repeated SamsaraDvirRecord dvirs = 8;
+  repeated SamsaraDiagnosticRecord diagnostics = 9;
+  repeated openeld.providers.eld.shared.v1.EldSyncCheckpoint checkpoints = 10;
+}

package/proto/providers/eld/shared/common.proto

@@ -0,0 +1,174 @@
+syntax = "proto3";
+
+package openeld.providers.eld.shared.v1;
+
+import "common/metadata/source.proto";
+import "common/primitives/location.proto";
+import "google/protobuf/timestamp.proto";
+
+// * Describes how a provider account authenticates and what environment it targets.
+message EldAuthProfile {
+  string auth_method = 1;
+  optional string environment = 2;
+  optional string base_url = 3;
+  repeated string scope_hints = 4;
+}
+
+// * Identifies the provider account or tenant boundary used for a sync.
+message EldProviderAccount {
+  string provider_account_id = 1;
+  optional string carrier_id = 2;
+  optional EldAuthProfile auth_profile = 3;
+}
+
+// * Represents a provider-specific driver record from an ELD source.
+message EldDriverRecord {
+  string provider_driver_id = 1;
+  optional string first_name = 2;
+  optional string last_name = 3;
+  optional string full_name = 4;
+  optional string license_number = 5;
+  optional string status = 6;
+  optional string email = 7;
+  optional string phone = 8;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific vehicle record from an ELD source.
+message EldVehicleRecord {
+  string provider_vehicle_id = 1;
+  optional string vin = 2;
+  optional string name = 3;
+  optional string license_plate = 4;
+  optional string make = 5;
+  optional string model = 6;
+  optional int32 year = 7;
+  optional double odometer_meters = 8;
+  optional double engine_hours_seconds = 9;
+  optional string eld_device_id = 10;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific driver/vehicle assignment from an ELD source.
+message EldVehicleAssignmentRecord {
+  string provider_assignment_id = 1;
+  optional string provider_driver_id = 2;
+  optional string provider_vehicle_id = 3;
+  optional string provider_codriver_id = 4;
+  optional google.protobuf.Timestamp start_time = 5;
+  optional google.protobuf.Timestamp end_time = 6;
+  repeated string trailer_identifiers = 7;
+  optional string shipping_doc_number = 8;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific HOS event record from an ELD source.
+message EldHosEventRecord {
+  string provider_event_id = 1;
+  optional string provider_driver_id = 2;
+  optional string provider_vehicle_id = 3;
+  optional google.protobuf.Timestamp event_timestamp = 4;
+  optional string duty_status = 5;
+  optional string event_type = 6;
+  optional openeld.common.primitives.v1.GeoPoint position = 7;
+  optional string annotation = 8;
+  optional string origin = 9;
+  optional string record_status = 10;
+  optional double odometer_meters = 11;
+  optional double engine_hours_seconds = 12;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific HOS clock summary from an ELD source.
+message EldHosClockRecord {
+  string provider_clock_id = 1;
+  optional string provider_driver_id = 2;
+  optional string clock_type = 3;
+  optional double remaining_seconds = 4;
+  optional google.protobuf.Timestamp resets_at = 5;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific GPS location record from an ELD source.
+message EldGpsLocationRecord {
+  string provider_location_id = 1;
+  optional string provider_vehicle_id = 2;
+  optional string provider_driver_id = 3;
+  optional google.protobuf.Timestamp timestamp = 4;
+  optional openeld.common.primitives.v1.GeoPoint position = 5;
+  optional double speed_kilometers_per_hour = 6;
+  optional double heading_degrees = 7;
+  optional double odometer_meters = 8;
+  optional double engine_hours_seconds = 9;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific malfunction or diagnostic record.
+message EldDiagnosticRecord {
+  string provider_diagnostic_id = 1;
+  optional string provider_driver_id = 2;
+  optional string provider_vehicle_id = 3;
+  optional google.protobuf.Timestamp event_timestamp = 4;
+  optional string diagnostic_type = 5;
+  optional string diagnostic_code = 6;
+  optional string description = 7;
+  optional bool is_active = 8;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific DVIR record from an ELD source.
+message EldDvirRecord {
+  string provider_dvir_id = 1;
+  optional string provider_driver_id = 2;
+  optional string provider_vehicle_id = 3;
+  optional google.protobuf.Timestamp inspection_time = 4;
+  optional string inspection_type = 5;
+  optional bool is_safe_to_drive = 6;
+  repeated string defect_descriptions = 7;
+  optional string mechanic_notes = 8;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Tracks incremental sync state for an ELD provider.
+message EldSyncCheckpoint {
+  optional string provider_account_id = 1;
+  optional string resource_name = 2;
+  optional string cursor = 3;
+  optional string page_token = 4;
+  optional string version_token = 5;
+  optional google.protobuf.Timestamp window_start = 6;
+  optional google.protobuf.Timestamp synced_through = 7;
+}
+
+// * Captures the operational characteristics of a provider sync flow.
+message EldSyncProfile {
+  string sync_model = 1;
+  bool supports_webhooks = 2;
+  bool supports_cursor = 3;
+  bool supports_page_polling = 4;
+  bool supports_version_token = 5;
+  bool requires_time_windowing = 6;
+  optional string rate_limit_notes = 7;
+}
+
+// * Declares which domains a provider payload currently carries.
+message EldSupportedDomains {
+  bool drivers = 1;
+  bool vehicles = 2;
+  bool assignments = 3;
+  bool hos_events = 4;
+  bool hos_clocks = 5;
+  bool gps_locations = 6;
+  bool dvirs = 7;
+  bool diagnostics = 8;
+}
+
+// * Provides payload-level metadata for a provider sync batch.
+message EldPayloadMetadata {
+  optional EldProviderAccount account = 1;
+  optional EldSyncProfile sync_profile = 2;
+  optional EldSupportedDomains supported_domains = 3;
+  optional string cursor = 4;
+  optional string provider_api_version = 5;
+  optional google.protobuf.Timestamp pulled_at = 6;
+}

package/proto/providers/telematics/fleet_complete/contracts.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+
+package openeld.providers.telematics.fleet_complete.v1;
+
+import "providers/telematics/shared/common.proto";
+
+// * Groups the stable subset of Fleet Complete records used by the normalization layer.
+message FleetCompletePayload {
+  repeated openeld.providers.telematics.shared.v1.TelematicsAssetRecord assets = 1;
+  repeated openeld.providers.telematics.shared.v1.TelematicsPositionRecord positions = 2;
+  repeated openeld.providers.telematics.shared.v1.TelematicsTripRecord trips = 3;
+  optional openeld.providers.telematics.shared.v1.TelematicsSyncCheckpoint checkpoint = 4;
+}

package/proto/providers/telematics/fourkites/contracts.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+
+package openeld.providers.telematics.fourkites.v1;
+
+import "providers/telematics/shared/common.proto";
+
+// * Groups the stable subset of FourKites records used by the normalization layer.
+message FourKitesPayload {
+  repeated openeld.providers.telematics.shared.v1.TelematicsAssetRecord assets = 1;
+  repeated openeld.providers.telematics.shared.v1.TelematicsPositionRecord positions = 2;
+  repeated openeld.providers.telematics.shared.v1.TelematicsTripRecord trips = 3;
+  optional openeld.providers.telematics.shared.v1.TelematicsSyncCheckpoint checkpoint = 4;
+}

package/proto/providers/telematics/project44/contracts.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+
+package openeld.providers.telematics.project44.v1;
+
+import "providers/telematics/shared/common.proto";
+
+// * Groups the stable subset of Project44 records used by the normalization layer.
+message Project44Payload {
+  repeated openeld.providers.telematics.shared.v1.TelematicsAssetRecord assets = 1;
+  repeated openeld.providers.telematics.shared.v1.TelematicsPositionRecord positions = 2;
+  repeated openeld.providers.telematics.shared.v1.TelematicsTripRecord trips = 3;
+  optional openeld.providers.telematics.shared.v1.TelematicsSyncCheckpoint checkpoint = 4;
+}

package/proto/providers/telematics/shared/common.proto

@@ -0,0 +1,48 @@
+syntax = "proto3";
+
+package openeld.providers.telematics.shared.v1;
+
+import "common/metadata/source.proto";
+import "common/primitives/location.proto";
+import "google/protobuf/timestamp.proto";
+
+// * Represents a provider-specific asset record from a telematics source.
+message TelematicsAssetRecord {
+  string provider_asset_id = 1;
+  optional string vin = 2;
+  optional string name = 3;
+  optional string license_plate = 4;
+  optional string device_id = 5;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific position record from a telematics source.
+message TelematicsPositionRecord {
+  string provider_position_id = 1;
+  optional string provider_asset_id = 2;
+  optional google.protobuf.Timestamp timestamp = 3;
+  optional openeld.common.primitives.v1.GeoPoint position = 4;
+  optional double speed_kilometers_per_hour = 5;
+  optional double heading_degrees = 6;
+  optional double odometer_meters = 7;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Represents a provider-specific trip or stop update from a telematics source.
+message TelematicsTripRecord {
+  string provider_trip_id = 1;
+  optional string provider_asset_id = 2;
+  optional string shipment_id = 3;
+  optional string status = 4;
+  optional google.protobuf.Timestamp start_time = 5;
+  optional google.protobuf.Timestamp end_time = 6;
+  optional openeld.common.metadata.v1.SourceRecord source = 20;
+}
+
+// * Tracks incremental sync state for a telematics provider.
+message TelematicsSyncCheckpoint {
+  optional string cursor = 1;
+  optional string page_token = 2;
+  optional string version_token = 3;
+  optional google.protobuf.Timestamp synced_through = 4;
+}

package/proto/providers/telematics/verizon_connect/contracts.proto

@@ -0,0 +1,13 @@
+syntax = "proto3";
+
+package openeld.providers.telematics.verizon_connect.v1;
+
+import "providers/telematics/shared/common.proto";
+
+// * Groups the stable subset of Verizon Connect records used by the normalization layer.
+message VerizonConnectPayload {
+  repeated openeld.providers.telematics.shared.v1.TelematicsAssetRecord assets = 1;
+  repeated openeld.providers.telematics.shared.v1.TelematicsPositionRecord positions = 2;
+  repeated openeld.providers.telematics.shared.v1.TelematicsTripRecord trips = 3;
+  optional openeld.providers.telematics.shared.v1.TelematicsSyncCheckpoint checkpoint = 4;
+}

package/proto/services/ingestion/service.proto

@@ -0,0 +1,37 @@
+syntax = "proto3";
+
+package openeld.services.ingestion.v1;
+
+import "providers/eld/geotab/contracts.proto";
+import "providers/eld/keeptruckin/contracts.proto";
+import "providers/eld/motive/contracts.proto";
+import "providers/eld/samsara/contracts.proto";
+import "providers/telematics/fleet_complete/contracts.proto";
+import "providers/telematics/fourkites/contracts.proto";
+import "providers/telematics/project44/contracts.proto";
+import "providers/telematics/verizon_connect/contracts.proto";
+
+// * Accepts provider-native payloads for persistence and downstream normalization.
+message IngestProviderPayloadRequest {
+  optional string tenant_id = 1;
+  oneof provider_payload {
+    openeld.providers.eld.samsara.v1.SamsaraPayload samsara = 10;
+    openeld.providers.eld.motive.v1.MotivePayload motive = 11;
+    openeld.providers.eld.geotab.v1.GeotabPayload geotab = 12;
+    openeld.providers.eld.keeptruckin.v1.KeeptruckinPayload keeptruckin = 13;
+    openeld.providers.telematics.project44.v1.Project44Payload project44 = 14;
+    openeld.providers.telematics.fourkites.v1.FourKitesPayload four_kites = 15;
+    openeld.providers.telematics.verizon_connect.v1.VerizonConnectPayload verizon_connect = 16;
+    openeld.providers.telematics.fleet_complete.v1.FleetCompletePayload fleet_complete = 17;
+  }
+}
+
+// * Returns ingestion acceptance counts and non-fatal warnings.
+message IngestProviderPayloadResponse {
+  uint32 accepted_record_count = 1;
+  repeated string warnings = 2;
+}
+
+service IngestionService {
+  rpc IngestProviderPayload(IngestProviderPayloadRequest) returns (IngestProviderPayloadResponse);
+}