sgerp-frontend-lib 0.1.1 → 0.1.3

package/dist/sgerp/utils/bookingPayload.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Utility functions for constructing booking payloads
+ * Used by both single booking creation and bulk CSV import
+ */
+export interface BookingPayloadInput {
+    user_id: string | number;
+    pickup_location_lat: number;
+    pickup_location_lon: number;
+    dropoff_location_lat: number;
+    dropoff_location_lon: number;
+    service_template_id?: number | string;
+    service_session_ids?: string[];
+    requested_departure_time?: string;
+    requested_destination_time?: string;
+    pickup_location_name?: string;
+    dropoff_location_name?: string;
+    preferred_pickup_stop_id?: number;
+    preferred_dropoff_stop_id?: number;
+    tickets?: Array<{
+        ticket_type: string;
+        demand: number;
+    }>;
+    demand?: Record<string, number>;
+    pickup_service_time?: number;
+    dropoff_service_time?: number;
+    data?: Record<string, unknown>;
+    remarks?: string;
+    offer_should_be_auto_accepted?: boolean;
+    estimate_allow_vehicle_late?: boolean;
+    offer_estimation_api_more_details?: boolean;
+    lifo_order_check?: boolean;
+    lifo_order_penalty?: number;
+    passenger_payment_method_id?: number | null;
+    payment_method_type?: string;
+    groups?: string[];
+    id?: string;
+    created_at?: string;
+}
+export interface BookingPayload {
+    id: string;
+    user_id: string | number;
+    service_template_id?: number | string;
+    service_session_ids: string[];
+    pickup_location_lat: number;
+    pickup_location_lon: number;
+    pickup_location_name?: string;
+    preferred_pickup_stop_id?: number;
+    dropoff_location_lat: number;
+    dropoff_location_lon: number;
+    dropoff_location_name?: string;
+    preferred_dropoff_stop_id?: number;
+    demand: Record<string, number>;
+    tickets?: Array<{
+        ticket_type: string;
+        demand: number;
+    }>;
+    data?: Record<string, unknown>;
+    requested_departure_time?: string;
+    requested_destination_time?: string;
+    pickup_service_time: number;
+    dropoff_service_time: number;
+    offer_should_be_auto_accepted: boolean;
+    passenger_payment_method_id?: number | null;
+    payment_method_type?: string;
+    created_at: string;
+    operator?: true;
+    estimate_allow_vehicle_late?: boolean;
+    offer_estimation_api_more_details?: boolean;
+    lifo_order_check?: boolean;
+    lifo_order_penalty?: number;
+    groups?: string[];
+}
+/**
+ * Build a booking payload for the /api/v2/microservices/bookings endpoint
+ * Handles both single booking creation and bulk import scenarios
+ * @param input - Booking input data
+ * @param includeOperatorFlag - Whether to include operator: true flag (default: true for backward compatibility)
+ */
+export declare function buildBookingPayload(input: BookingPayloadInput, includeOperatorFlag?: boolean): BookingPayload;
+//# sourceMappingURL=bookingPayload.d.ts.map

package/dist/sgerp/utils/bookingPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookingPayload.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/utils/bookingPayload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAElC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,oBAAoB,EAAE,MAAM,CAAA;IAG5B,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAG9B,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IAGnC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAGlC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAG/B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAG7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,6BAA6B,CAAC,EAAE,OAAO,CAAA;IACvC,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,iCAAiC,CAAC,EAAE,OAAO,CAAA;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAG3B,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAG5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IAGjB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrC,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,oBAAoB,EAAE,MAAM,CAAA;IAC5B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,oBAAoB,EAAE,MAAM,CAAA;IAC5B,6BAA6B,EAAE,OAAO,CAAA;IACtC,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,iCAAiC,CAAC,EAAE,OAAO,CAAA;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAC1B,mBAAmB,GAAE,OAAc,GAClC,cAAc,CAgEhB"}

package/dist/sgerp/utils/bookingPayload.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Utility functions for constructing booking payloads
+ * Used by both single booking creation and bulk CSV import
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBookingPayload = buildBookingPayload;
+/**
+ * Build a booking payload for the /api/v2/microservices/bookings endpoint
+ * Handles both single booking creation and bulk import scenarios
+ * @param input - Booking input data
+ * @param includeOperatorFlag - Whether to include operator: true flag (default: true for backward compatibility)
+ */
+function buildBookingPayload(input, includeOperatorFlag = true) {
+    var _a, _b, _c;
+    // Generate ID if not provided
+    const id = input.id || crypto.randomUUID();
+    // Build demand object from tickets array or use provided demand
+    let demand = {};
+    let tickets;
+    if (input.tickets && input.tickets.length > 0) {
+        // If tickets are provided, use them and create empty demand
+        tickets = input.tickets;
+        demand = {};
+    }
+    else if (input.demand && Object.keys(input.demand).length > 0) {
+        // If demand is provided, use it (no tickets array)
+        demand = input.demand;
+        tickets = undefined;
+    }
+    else {
+        // Default: empty demand, no tickets
+        demand = {};
+        tickets = undefined;
+    }
+    // Build data object
+    const data = Object.assign({}, input.data);
+    if (input.remarks) {
+        data.remarks = input.remarks;
+    }
+    // Construct the payload
+    const payload = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ id, user_id: input.user_id, service_session_ids: input.service_session_ids || [], pickup_location_lat: input.pickup_location_lat, pickup_location_lon: input.pickup_location_lon, dropoff_location_lat: input.dropoff_location_lat, dropoff_location_lon: input.dropoff_location_lon, demand, pickup_service_time: (_a = input.pickup_service_time) !== null && _a !== void 0 ? _a : 0, dropoff_service_time: (_b = input.dropoff_service_time) !== null && _b !== void 0 ? _b : 0, offer_should_be_auto_accepted: (_c = input.offer_should_be_auto_accepted) !== null && _c !== void 0 ? _c : true, created_at: input.created_at || new Date().toISOString() }, (includeOperatorFlag && { operator: true })), (input.service_template_id && { service_template_id: input.service_template_id })), (input.pickup_location_name && { pickup_location_name: input.pickup_location_name })), (input.dropoff_location_name && { dropoff_location_name: input.dropoff_location_name })), (input.preferred_pickup_stop_id && { preferred_pickup_stop_id: input.preferred_pickup_stop_id })), (input.preferred_dropoff_stop_id && { preferred_dropoff_stop_id: input.preferred_dropoff_stop_id })), (tickets && tickets.length > 0 && { tickets })), (Object.keys(data).length > 0 && { data })), (input.requested_departure_time && { requested_departure_time: input.requested_departure_time })), (input.requested_destination_time && { requested_destination_time: input.requested_destination_time })), (input.passenger_payment_method_id !== undefined && { passenger_payment_method_id: input.passenger_payment_method_id })), (input.payment_method_type && { payment_method_type: input.payment_method_type })), (input.estimate_allow_vehicle_late !== undefined && { estimate_allow_vehicle_late: input.estimate_allow_vehicle_late })), (input.offer_estimation_api_more_details !== undefined && { offer_estimation_api_more_details: input.offer_estimation_api_more_details })), (input.lifo_order_check !== undefined && { lifo_order_check: input.lifo_order_check })), (input.lifo_order_penalty !== undefined && { lifo_order_penalty: input.lifo_order_penalty })), (input.groups && input.groups.length > 0 && { groups: input.groups }));
+    return payload;
+}

package/dist/sgerp/utils/color.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Convert HSL color values to RGB hex string
+ * @param h Hue (0-360)
+ * @param s Saturation (0-100)
+ * @param l Lightness (0-100)
+ * @returns RGB hex color string (e.g., "#ff0000")
+ */
+export declare function getHSLToRGB(h: number, s: number, l: number): string;
+/**
+ * Generate a color from an agent ID string
+ * @param agent_id Agent identifier
+ * @returns RGB hex color string
+ */
+export declare function getColorFromAgentId(agent_id?: string | number | null): string;
+/**
+ * Normalize vehicle color - returns vehicle color or generates one from agent_id if missing
+ * @param vehicle Vehicle object with color and agent_id properties
+ * @returns Normalized RGB hex color string
+ */
+export declare function normalizeVehicleColor(vehicle: {
+    color?: string | null;
+    agent_id?: string | number | null;
+}): string;
+/**
+ * Determine if a background color is light or dark and return appropriate text color
+ * @param backgroundColor RGB hex color string
+ * @returns '#000000' for light backgrounds, '#ffffff' for dark backgrounds
+ */
+export declare function getContrastTextColor(backgroundColor: string): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/sgerp/utils/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/utils/color.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAyCnE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAe7E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,MAAM,CASnH;AAyBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAIpE"}

package/dist/sgerp/utils/color.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHSLToRGB = getHSLToRGB;
+exports.getColorFromAgentId = getColorFromAgentId;
+exports.normalizeVehicleColor = normalizeVehicleColor;
+exports.getContrastTextColor = getContrastTextColor;
+/**
+ * Convert HSL color values to RGB hex string
+ * @param h Hue (0-360)
+ * @param s Saturation (0-100)
+ * @param l Lightness (0-100)
+ * @returns RGB hex color string (e.g., "#ff0000")
+ */
+function getHSLToRGB(h, s, l) {
+    s /= 100;
+    l /= 100;
+    const c = (1 - Math.abs(2 * l - 1)) * s;
+    const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
+    const m = l - c / 2;
+    let r = 0;
+    let g = 0;
+    let b = 0;
+    if (0 <= h && h < 60) {
+        r = c;
+        g = x;
+        b = 0;
+    }
+    else if (60 <= h && h < 120) {
+        r = x;
+        g = c;
+        b = 0;
+    }
+    else if (120 <= h && h < 180) {
+        r = 0;
+        g = c;
+        b = x;
+    }
+    else if (180 <= h && h < 240) {
+        r = 0;
+        g = x;
+        b = c;
+    }
+    else if (240 <= h && h < 300) {
+        r = x;
+        g = 0;
+        b = c;
+    }
+    else if (300 <= h && h < 360) {
+        r = c;
+        g = 0;
+        b = x;
+    }
+    r = Math.round((r + m) * 255);
+    g = Math.round((g + m) * 255);
+    b = Math.round((b + m) * 255);
+    return `#${r.toString(16).padStart(2, "0")}${g.toString(16).padStart(2, "0")}${b.toString(16).padStart(2, "0")}`;
+}
+/**
+ * Generate a color from an agent ID string
+ * @param agent_id Agent identifier
+ * @returns RGB hex color string
+ */
+function getColorFromAgentId(agent_id) {
+    if (!agent_id) {
+        agent_id = "";
+    }
+    const DIVIDER = 360;
+    const LIGHTNESS = 60; // Lightness in percentage
+    const SATURATION = 100; // Saturation in percentage
+    const agentIdStr = String(agent_id);
+    const hue = Array.from(agentIdStr).reduce((acc, char) => {
+        return (acc + char.charCodeAt(0)) % DIVIDER;
+    }, 0);
+    return getHSLToRGB(hue, SATURATION, LIGHTNESS);
+}
+/**
+ * Normalize vehicle color - returns vehicle color or generates one from agent_id if missing
+ * @param vehicle Vehicle object with color and agent_id properties
+ * @returns Normalized RGB hex color string
+ */
+function normalizeVehicleColor(vehicle) {
+    if (vehicle.color === undefined ||
+        vehicle.color === null ||
+        vehicle.color === "#000000") {
+        return getColorFromAgentId(vehicle.agent_id);
+    }
+    return vehicle.color;
+}
+/**
+ * Calculate relative luminance of a color
+ * @param hex RGB hex color string
+ * @returns Luminance value between 0 and 1
+ */
+function getRelativeLuminance(hex) {
+    // Remove # if present
+    hex = hex.replace('#', '');
+    // Parse RGB values
+    const r = parseInt(hex.substring(0, 2), 16) / 255;
+    const g = parseInt(hex.substring(2, 4), 16) / 255;
+    const b = parseInt(hex.substring(4, 6), 16) / 255;
+    // Apply gamma correction
+    const rLinear = r <= 0.03928 ? r / 12.92 : Math.pow((r + 0.055) / 1.055, 2.4);
+    const gLinear = g <= 0.03928 ? g / 12.92 : Math.pow((g + 0.055) / 1.055, 2.4);
+    const bLinear = b <= 0.03928 ? b / 12.92 : Math.pow((b + 0.055) / 1.055, 2.4);
+    // Calculate relative luminance
+    return 0.2126 * rLinear + 0.7152 * gLinear + 0.0722 * bLinear;
+}
+/**
+ * Determine if a background color is light or dark and return appropriate text color
+ * @param backgroundColor RGB hex color string
+ * @returns '#000000' for light backgrounds, '#ffffff' for dark backgrounds
+ */
+function getContrastTextColor(backgroundColor) {
+    const luminance = getRelativeLuminance(backgroundColor);
+    // WCAG threshold: luminance > 0.5 is considered light
+    return luminance > 0.5 ? '#000000' : '#ffffff';
+}

package/dist/sgerp/utils/enum-helpers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Enum Helper Utilities
+ * Provides utilities for working with enums and localization
+ */
+/**
+ * Gets localized options array from an enum and its labels
+ * Useful for populating Select/Multiselect components
+ *
+ * @example
+ * const options = getEnumOptions(AlgoType, AlgoTypeLabels, getText);
+ * // Returns: [{ value: 'static', label: 'Static' }, ...]
+ */
+export declare function getEnumOptions<T extends string>(enumObject: Record<string, T>, labelsMap: Record<T, string>, getText: (key: string) => string): Array<{
+    value: T;
+    label: string;
+}>;
+/**
+ * Gets the localized label for a specific enum value
+ *
+ * @example
+ * const label = getEnumLabel(AlgoType.STATIC, AlgoTypeLabels, getText);
+ * // Returns: 'Static'
+ */
+export declare function getEnumLabel<T extends string>(value: T, labelsMap: Record<T, string>, getText: (key: string) => string): string;
+/**
+ * Gets all enum values as an array
+ *
+ * @example
+ * const values = getEnumValues(AlgoType);
+ * // Returns: ['static', 'dynamic', 'dynamic_2_stages', ...]
+ */
+export declare function getEnumValues<T extends string>(enumObject: Record<string, T>): T[];
+/**
+ * Checks if a value is a valid enum value
+ *
+ * @example
+ * const isValid = isValidEnumValue('static', AlgoType);
+ * // Returns: true
+ */
+export declare function isValidEnumValue<T extends string>(value: unknown, enumObject: Record<string, T>): value is T;
+//# sourceMappingURL=enum-helpers.d.ts.map

package/dist/sgerp/utils/enum-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-helpers.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/utils/enum-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAC7B,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAC/B,KAAK,CAAC;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAKpC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAC/B,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAC5B,CAAC,EAAE,CAEL;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAC5B,KAAK,IAAI,CAAC,CAEZ"}

package/dist/sgerp/utils/enum-helpers.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Enum Helper Utilities
+ * Provides utilities for working with enums and localization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnumOptions = getEnumOptions;
+exports.getEnumLabel = getEnumLabel;
+exports.getEnumValues = getEnumValues;
+exports.isValidEnumValue = isValidEnumValue;
+/**
+ * Gets localized options array from an enum and its labels
+ * Useful for populating Select/Multiselect components
+ *
+ * @example
+ * const options = getEnumOptions(AlgoType, AlgoTypeLabels, getText);
+ * // Returns: [{ value: 'static', label: 'Static' }, ...]
+ */
+function getEnumOptions(enumObject, labelsMap, getText) {
+    return Object.values(enumObject).map(value => ({
+        value,
+        label: getText(labelsMap[value]),
+    }));
+}
+/**
+ * Gets the localized label for a specific enum value
+ *
+ * @example
+ * const label = getEnumLabel(AlgoType.STATIC, AlgoTypeLabels, getText);
+ * // Returns: 'Static'
+ */
+function getEnumLabel(value, labelsMap, getText) {
+    return getText(labelsMap[value]);
+}
+/**
+ * Gets all enum values as an array
+ *
+ * @example
+ * const values = getEnumValues(AlgoType);
+ * // Returns: ['static', 'dynamic', 'dynamic_2_stages', ...]
+ */
+function getEnumValues(enumObject) {
+    return Object.values(enumObject);
+}
+/**
+ * Checks if a value is a valid enum value
+ *
+ * @example
+ * const isValid = isValidEnumValue('static', AlgoType);
+ * // Returns: true
+ */
+function isValidEnumValue(value, enumObject) {
+    return typeof value === 'string' && Object.values(enumObject).includes(value);
+}

package/dist/sgerp/utils/routeUtils.d.ts

@@ -2,7 +2,7 @@
  * Route utility functions adapted from dashviewer
  * Generates waypoint routes from nodes without web workers
  */
-import type { Node } from '@/sgerplib/sgerp/types/simulation/node';
+import type { Node } from '../types/simulation/node';
 export type RouteNode = Node;
 export interface Waypoint {
     id: string;

package/dist/sgerp/utils/routeUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routeUtils.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/utils/routeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAA;AAElE,MAAM,MAAM,SAAS,GAAG,IAAI,CAAA;AAE5B,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG;IAClE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,CA6FA;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CA4B/E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,EAAE,EAClB,UAAU,EAAE,MAAM,EAAE,GACnB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAwC/B"}
+{"version":3,"file":"routeUtils.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/utils/routeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAEpD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAA;AAE5B,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG;IAClE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,CA6FA;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CA4B/E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,EAAE,EAClB,UAAU,EAAE,MAAM,EAAE,GACnB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAwC/B"}

package/dist/sgerp/utils/routeUtils.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * Route utility functions adapted from dashviewer
+ * Generates waypoint routes from nodes without web workers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateWaypointRouteFromNodes = generateWaypointRouteFromNodes;
+exports.validatePickupDropoffConstraint = validatePickupDropoffConstraint;
+exports.createVehicleRoutesFromNodes = createVehicleRoutesFromNodes;
+/**
+ * Generate waypoint route from nodes
+ * Groups consecutive nodes at the same location into waypoints
+ */
+function generateWaypointRouteFromNodes(nodes) {
+    const route = [];
+    let prev_loc = null;
+    let waypointIdParts = [];
+    // Filter out transit nodes for cleaner routes
+    const clearedNodes = nodes.filter((node) => node.node_type !== 'transit');
+    // Google Maps link generation
+    const baseUrl = 'https://www.google.com/maps/dir/?api=1';
+    let origin = null;
+    let destination = null;
+    const googleWaypoints = [];
+    clearedNodes.forEach((node) => {
+        const loc = `${node.lat}-${node.lon}`;
+        // New location - create new waypoint
+        if (prev_loc !== loc) {
+            // Finalize previous waypoint ID
+            if (waypointIdParts.length > 0) {
+                const waypointId = waypointIdParts.join('-');
+                route[route.length - 1].id = waypointId;
+                waypointIdParts = [];
+            }
+            // Create new waypoint
+            const waypoint = {
+                id: '', // Will be set after collecting all nodes
+                idx: route.length + 1,
+                sequence: route.length + 1,
+                lat: node.lat,
+                lon: node.lon,
+                location_name: node.display_name || node.location_name || `Location ${route.length + 1}`,
+                nodes: [],
+                pickup_nodes: [],
+                dropoff_nodes: [],
+                point_nodes: [],
+                transit_nodes: [],
+                scheduled_ts: node.scheduled_ts,
+            };
+            route.push(waypoint);
+            // Google Maps link logic
+            const coords = `${node.lat},${node.lon}`;
+            if (origin === null) {
+                origin = coords;
+            }
+            else if (route.length > 2) {
+                googleWaypoints.push(coords);
+            }
+            destination = coords;
+        }
+        // Add node to current waypoint
+        const currentWaypoint = route[route.length - 1];
+        currentWaypoint.nodes.push(node);
+        // Group by node type
+        if (node.node_type === 'pickup') {
+            currentWaypoint.pickup_nodes.push(node);
+        }
+        else if (node.node_type === 'dropoff') {
+            currentWaypoint.dropoff_nodes.push(node);
+        }
+        else if (node.node_type === 'point') {
+            currentWaypoint.point_nodes.push(node);
+        }
+        else if (node.node_type === 'transit') {
+            currentWaypoint.transit_nodes.push(node);
+        }
+        waypointIdParts.push(`${node.id}`);
+        prev_loc = loc;
+    });
+    // Finalize last waypoint ID
+    if (waypointIdParts.length > 0) {
+        const waypointId = waypointIdParts.join('-');
+        route[route.length - 1].id = waypointId;
+    }
+    // Finalize Google Maps link
+    let googleMapsLink = baseUrl;
+    if (origin !== null && destination !== null) {
+        const params = new URLSearchParams({
+            origin,
+            destination,
+            travelmode: 'driving',
+        });
+        if (googleWaypoints.length > 0) {
+            params.append('waypoints', googleWaypoints.slice(0, -1).join('|'));
+        }
+        googleMapsLink = `${baseUrl}&${params.toString()}`;
+    }
+    return { route, googleMapsLink };
+}
+/**
+ * Validate pickup-dropoff constraint
+ * Returns error messages if any dropoff happens before its corresponding pickup
+ *
+ * @param waypoints - Array of waypoints with nodes
+ * @returns Array of error messages (empty if valid)
+ */
+function validatePickupDropoffConstraint(waypoints) {
+    const errors = [];
+    const seen = {};
+    // Flatten waypoints to nodes while maintaining order
+    const allNodes = [];
+    waypoints.forEach((waypoint) => {
+        waypoint.nodes.forEach((node) => {
+            allNodes.push(node);
+        });
+    });
+    // PDP (Pickup-Dropoff Precedence) check
+    allNodes.forEach((node) => {
+        if (node.node_type === 'pickup') {
+            // Mark this booking ID as having been picked up
+            seen[node.booking_id] = true;
+        }
+        else if (node.node_type === 'dropoff') {
+            if (!(node.booking_id in seen)) {
+                // Error if we see a dropoff without a corresponding pickup
+                errors.push(`Dropoff before pickup for booking ID ${node.booking_id} at node ${node.id}`);
+            }
+        }
+    });
+    return errors;
+}
+/**
+ * Create vehicle route data from nodes
+ * Groups nodes by vehicle and generates waypoint routes
+ */
+function createVehicleRoutesFromNodes(nodes, vehicleIds) {
+    const vehicleRoutes = new Map();
+    // Group nodes by vehicle
+    const nodesByVehicle = new Map();
+    nodes.forEach((node) => {
+        if (node.assigned_vehicle_id && node.status === 'assigned') {
+            if (!nodesByVehicle.has(node.assigned_vehicle_id)) {
+                nodesByVehicle.set(node.assigned_vehicle_id, []);
+            }
+            nodesByVehicle.get(node.assigned_vehicle_id).push(node);
+        }
+    });
+    // Sort nodes by scheduled time for each vehicle
+    nodesByVehicle.forEach((vehicleNodes) => {
+        vehicleNodes.sort((a, b) => {
+            if (!a.scheduled_ts)
+                return 1;
+            if (!b.scheduled_ts)
+                return -1;
+            return new Date(a.scheduled_ts).getTime() - new Date(b.scheduled_ts).getTime();
+        });
+    });
+    // Generate waypoint routes for each vehicle
+    vehicleIds.forEach((vehicleId) => {
+        const vehicleNodes = nodesByVehicle.get(vehicleId) || [];
+        if (vehicleNodes.length > 0) {
+            const { route, googleMapsLink } = generateWaypointRouteFromNodes(vehicleNodes);
+            vehicleRoutes.set(vehicleId, {
+                vehicleId,
+                waypoints: route,
+                googleMapsLink,
+            });
+        }
+    });
+    return vehicleRoutes;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sgerp-frontend-lib",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "TypeScript/React library for interacting with the SGERP API, providing client SDK, Backbone.js-style Collections, and pre-built React components",
   "main": "./dist/index.js",
   "module": "./dist/index.js",