@cloudnux/core-cloud-provider 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -144,6 +144,11 @@ interface Coordinates {
     lat: number;
     lng: number;
 }
+interface RoutePoint {
+    lat: number;
+    lng: number;
+    distanceFromStartKm: number;
+}
 interface SuggestionParams {
     query: string;
     maxResults?: number;
@@ -152,6 +157,11 @@ interface SuggestionParams {
     biasPosition?: Coordinates;
     placeTypes?: string[];
 }
+interface ReverseGeocodeParams {
+    coordinates: Coordinates;
+    language?: string;
+    maxResults?: number;
+}
 interface LocationSuggestion {
     title: string;
     subtitle?: string;
@@ -163,11 +173,6 @@ interface LocationSuggestion {
     provider: string;
     rawData?: any;
 }
-interface ReverseGeocodeParams {
-    coordinates: Coordinates;
-    language?: string;
-    maxResults?: number;
-}
 interface LocationAddress {
     fullAddress: string;
     street?: string;
@@ -184,6 +189,26 @@ interface LocationAddress {
     provider: string;
     rawData?: any;
 }
+interface RouteResult {
+    totalDistanceKm: number;
+    totalDurationMinutes: number;
+    /** Route coordinates as [lng, lat] pairs for GeoJSON */
+    /** TODO: convert array to coordinates */
+    coordinates: Coordinates[];
+    /** Sampled points along route for corridor search */
+    sampledPoints: RoutePoint[];
+    /** Bounding box [minLng, minLat, maxLng, maxLat] */
+    bbox: [number, number, number, number];
+    /** Individual leg data */
+    legs: Array<{
+        distanceKm: number;
+        durationMinutes: number;
+        /** TODO: convert array to coordinates */
+        coordinates: Coordinates[];
+        startPosition: Coordinates;
+        endPosition: Coordinates;
+    }>;
+}
 interface LocationService {
     /**
    * Get autocomplete suggestions for search box
@@ -195,6 +220,11 @@ interface LocationService {
      * Use case: User clicks "Get my location" → Show "Drottninggatan 10, Stockholm"
      */
     reverseGeocode(params: ReverseGeocodeParams): Promise<LocationAddress>;
+    /**
+     * Calculate route between origin and destination with optional waypoints
+     * Use case: User plans trip → Show route on map + details
+     */
+    calculateRoute(origin: Coordinates, destination: Coordinates, waypoints?: Coordinates[], avoidTolls?: boolean): Promise<RouteResult>;
     /**
      * Optional: Get detailed location info if suggestion doesn't have coordinates
      * Use case: User selects suggestion → Need full coordinates
@@ -379,4 +409,4 @@ interface CloudProvider {
     createFunctionsService(): FunctionsService;
 }
 
-export { type BaseEntry, type CloudProvider, type Coordinates, type Entry, type Entrypoint, ErrorCode, type EventBrokerService, type EventEntry, type EventFunctionContext, type EventMessage, type EventRequest, type EventResponse, type EventTrigger, type FunctionContext, type FunctionsService, type HTTPAuth, type HTTPRequest, type HTTPResponse, type HandlerType, type HttpEntry, type HttpFunctionContext, type HttpMethod, type HttpTrigger, type LocationAddress, type LocationProviderConfig, type LocationService, type LocationSuggestion, type MessageFilter, type PeekOptions, type PublishOptions, type ReadOptions, type ReverseGeocodeParams, type ScheduleEntry, type ScheduleFunctionContext, type ScheduleRequest, type ScheduleResponse, type ScheduleTrigger, type StorageService, type StorageWriteOptions, type StorageWriteResult, type SuggestionParams };
+export { type BaseEntry, type CloudProvider, type Coordinates, type Entry, type Entrypoint, ErrorCode, type EventBrokerService, type EventEntry, type EventFunctionContext, type EventMessage, type EventRequest, type EventResponse, type EventTrigger, type FunctionContext, type FunctionsService, type HTTPAuth, type HTTPRequest, type HTTPResponse, type HandlerType, type HttpEntry, type HttpFunctionContext, type HttpMethod, type HttpTrigger, type LocationAddress, type LocationProviderConfig, type LocationService, type LocationSuggestion, type MessageFilter, type PeekOptions, type PublishOptions, type ReadOptions, type ReverseGeocodeParams, type RoutePoint, type RouteResult, type ScheduleEntry, type ScheduleFunctionContext, type ScheduleRequest, type ScheduleResponse, type ScheduleTrigger, type StorageService, type StorageWriteOptions, type StorageWriteResult, type SuggestionParams };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudnux/core-cloud-provider",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "CloudNux core interfaces and types for multi-cloud abstraction",
   "license": "MIT",
   "type": "module",