@nitrostack/cli 1.0.0

package/templates/typescript-oauth/src/services/duffel.service.ts

@@ -0,0 +1,285 @@
+import { Duffel } from '@duffel/api';
+import { Injectable } from 'nitrostack';
+
+/**
+ * Duffel API Service
+ * 
+ * Handles all interactions with the Duffel API for flight search and booking.
+ * Implements best practices from Duffel documentation.
+ */
+@Injectable()
+export class DuffelService {
+    private duffel: Duffel;
+
+    constructor() {
+        const apiKey = process.env.DUFFEL_API_KEY;
+        if (!apiKey) {
+            throw new Error('DUFFEL_API_KEY environment variable is required');
+        }
+
+        this.duffel = new Duffel({
+            token: apiKey
+        });
+    }
+
+    /**
+     * Search for flights using offer requests
+     * 
+     * @param params Search parameters
+     * @returns Flight offers
+     */
+    async searchFlights(params: {
+        origin: string;
+        destination: string;
+        departureDate: string;
+        returnDate?: string;
+        passengers: Array<{ type: 'adult' } | { type: 'child'; age: number } | { type: 'infant_without_seat' }>;
+        cabinClass?: 'economy' | 'premium_economy' | 'business' | 'first';
+        maxConnections?: number;
+        departureTime?: { from: string; to: string };
+        arrivalTime?: { from: string; to: string };
+    }) {
+        try {
+            const slices: any[] = [
+                {
+                    origin: params.origin,
+                    destination: params.destination,
+                    departure_date: params.departureDate,
+                    ...(params.departureTime && { departure_time: params.departureTime }),
+                    ...(params.arrivalTime && { arrival_time: params.arrivalTime })
+                }
+            ];
+
+            // Add return slice if round trip
+            if (params.returnDate) {
+                slices.push({
+                    origin: params.destination,
+                    destination: params.origin,
+                    departure_date: params.returnDate
+                });
+            }
+
+            const offerRequest = await this.duffel.offerRequests.create({
+                slices,
+                passengers: params.passengers as any,
+                cabin_class: params.cabinClass,
+                max_connections: params.maxConnections as 0 | 1 | 2 | undefined,
+                return_offers: true
+            });
+
+            return {
+                id: offerRequest.data.id,
+                offers: offerRequest.data.offers || [],
+                passengers: offerRequest.data.passengers,
+                slices: offerRequest.data.slices
+            };
+        } catch (error: any) {
+            throw new Error(`Flight search failed: ${error.message || JSON.stringify(error.errors || error)}`);
+        }
+    }
+
+    /**
+     * Get a specific offer by ID
+     */
+    async getOffer(offerId: string) {
+        try {
+            const offer = await this.duffel.offers.get(offerId);
+            return offer.data;
+        } catch (error: any) {
+            throw new Error(`Failed to get offer: ${error.message}`);
+        }
+    }
+
+    /**
+     * Get available seats for an offer
+     */
+    async getAvailableSeats(offerId: string) {
+        try {
+            const seatMaps = await this.duffel.seatMaps.get({ offer_id: offerId });
+            return seatMaps.data;
+        } catch (error: any) {
+            throw new Error(`Failed to get seat maps: ${error.message}`);
+        }
+    }
+
+
+    /**
+     * Generate a simple UUID-like identifier
+     */
+    private generateId(): string {
+        return 'pas_' + Date.now().toString(36) + Math.random().toString(36).substr(2, 9);
+    }
+
+    /**
+     * Create an order (book a flight) with optional hold
+     * This creates a new offer request with passenger details to get passenger IDs,
+     * then uses those IDs to create the order
+     */
+    async createOrder(params: {
+        selectedOffers: string[];
+        passengers: Array<{
+            title: 'mr' | 'ms' | 'mrs' | 'miss' | 'dr';
+            given_name: string;
+            family_name: string;
+            gender: 'M' | 'F';
+            born_on: string;
+            email: string;
+            phone_number: string;
+        }>;
+    }) {
+        try {
+            // Step 1: Get the offer to extract flight details
+            const offer = await this.duffel.offers.get(params.selectedOffers[0]);
+            const offerData = offer.data;
+
+            // Step 2: Create a new offer request with passenger details to get passenger IDs
+            const offerRequest = await this.duffel.offerRequests.create({
+                slices: offerData.slices.map((slice: any) => ({
+                    origin: slice.origin.iata_code,
+                    destination: slice.destination.iata_code,
+                    departure_date: slice.segments[0].departing_at.split('T')[0]
+                })),
+                passengers: params.passengers.map(p => ({
+                    type: 'adult', // Simplified - you can enhance this based on age
+                    given_name: p.given_name,
+                    family_name: p.family_name,
+                    title: p.title,
+                    gender: p.gender.toLowerCase() as 'm' | 'f',
+                    born_on: p.born_on,
+                    email: p.email,
+                    phone_number: p.phone_number
+                })),
+                cabin_class: (offerData as any).cabin_class || 'economy',
+                return_offers: true  // We need offers to be returned!
+            } as any);
+
+            const passengerIds = offerRequest.data.passengers.map((p: any) => p.id);
+
+            // Step 3: Create order using passenger IDs from the NEW offer request
+            // We need to use an offer from THIS offer request, not the original one
+            const newOfferId = (offerRequest.data as any).offers?.[0]?.id;
+
+            if (!newOfferId) {
+                throw new Error('No offers returned from offer request with passenger details');
+            }
+
+            const orderData: any = {
+                selected_offers: [newOfferId],  // Use offer from the NEW request
+                passengers: passengerIds.map((id: string, index: number) => ({
+                    id: id,
+                    ...params.passengers[index],
+                    gender: params.passengers[index].gender.toLowerCase()
+                })),
+                type: 'hold'  // Always create hold orders
+            };
+
+            const order = await this.duffel.orders.create(orderData);
+            return order.data;
+        } catch (error: any) {
+            // Log detailed error information
+            const errorDetails = {
+                message: error.message,
+                errors: error.errors,
+                response: error.response?.data,
+                status: error.response?.status
+            };
+            console.error('Duffel order creation failed:', JSON.stringify(errorDetails, null, 2));
+
+            throw new Error(`Failed to create order: ${error.message || JSON.stringify(error.errors || error.response?.data || error)}`);
+        }
+    }
+
+
+
+    /**
+     * Get available seats for an offer
+     */
+    async getSeatsForOffer(offerId: string) {
+        try {
+            const seatMaps = await this.duffel.seatMaps.get({ offer_id: offerId });
+            return seatMaps.data;
+        } catch (error: any) {
+            throw new Error(`Failed to get seats: ${error.message || JSON.stringify(error.errors || error)}`);
+        }
+    }
+
+    /**
+     * Create order change request for seats
+     */
+    async createOrderChangeForSeats(orderId: string) {
+        try {
+            const changeRequest = await this.duffel.orderChangeRequests.create({
+                order_id: orderId
+            } as any);
+            return changeRequest.data;
+        } catch (error: any) {
+            throw new Error(`Failed to create order change: ${error.message || JSON.stringify(error.errors || error)}`);
+        }
+    }
+
+    /**
+     * Get available services (baggage, seats) for an order
+     */
+    async getAvailableServices(orderId: string) {
+        try {
+            const services = await this.duffel.orderChangeRequests.create({
+                order_id: orderId
+            } as any);
+            return services.data;
+        } catch (error: any) {
+            throw new Error(`Failed to get available services: ${error.message || JSON.stringify(error.errors || error)}`);
+        }
+    }
+
+    /**
+     * Get order details
+     */
+    async getOrder(orderId: string) {
+        try {
+            const order = await this.duffel.orders.get(orderId);
+            return order.data;
+        } catch (error: any) {
+            throw new Error(`Failed to get order: ${error.message}`);
+        }
+    }
+
+    /**
+     * Cancel an order
+     */
+    async cancelOrder(orderId: string) {
+        try {
+            const cancellation = await this.duffel.orderCancellations.create({
+                order_id: orderId
+            });
+            return cancellation.data;
+        } catch (error: any) {
+            throw new Error(`Failed to cancel order: ${error.message}`);
+        }
+    }
+
+    /**
+     * Search for airports by query
+     */
+    async searchAirports(query: string) {
+        try {
+            const suggestions = await this.duffel.suggestions.list({
+                query: query
+            });
+            return suggestions.data;
+        } catch (error: any) {
+            throw new Error(`Failed to search airports: ${error.message}`);
+        }
+    }
+
+    /**
+     * Get airlines list
+     */
+    async getAirlines() {
+        try {
+            const airlines = await this.duffel.airlines.list();
+            return airlines.data;
+        } catch (error: any) {
+            throw new Error(`Failed to get airlines: ${error.message}`);
+        }
+    }
+}

package/templates/typescript-oauth/src/widgets/app/airport-search/page.tsx

@@ -0,0 +1,270 @@
+'use client';
+
+import { useWidgetSDK, useTheme } from '@nitrostack/widgets';
+
+/**
+ * Airport Search Widget
+ * 
+ * Compact display of airport search results with IATA codes and locations.
+ */
+
+interface AirportResult {
+    id: string;
+    name: string;
+    iataCode: string;
+    icaoCode?: string;
+    cityName?: string;
+    type: string;
+    latitude?: number;
+    longitude?: number;
+    timeZone?: string;
+}
+
+interface AirportSearchData {
+    query: string;
+    results: AirportResult[];
+}
+
+export default function AirportSearch() {
+    const { getToolOutput } = useWidgetSDK();
+    const theme = useTheme();
+    const data = getToolOutput<AirportSearchData>();
+
+    const isDark = theme === 'dark';
+
+    const getTypeIcon = (type: string) => {
+        const icons: Record<string, string> = {
+            'airport': '✈️',
+            'city': '🏙️',
+            'station': '🚉',
+            'bus_station': '🚌',
+            'heliport': '🚁'
+        };
+        return icons[type] || '📍';
+    };
+
+    if (!data) {
+        return (
+            <div style={{ padding: '24px', textAlign: 'center', color: isDark ? '#F8FAFC' : '#020617' }}>
+                Loading...
+            </div>
+        );
+    }
+
+    return (
+        <div className={isDark ? 'dark' : ''} style={{
+            padding: '16px',
+            background: isDark ? '#020617' : '#FFFFFF',
+            color: isDark ? '#F8FAFC' : '#020617'
+        }}>
+            {/* Header */}
+            <div style={{
+                background: isDark ? '#0F172A' : '#F8FAFC',
+                borderRadius: '12px',
+                padding: '16px',
+                marginBottom: '16px',
+                border: `1px solid ${isDark ? '#334155' : '#E2E8F0'}`
+            }}>
+                <div style={{
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '10px',
+                    marginBottom: '8px'
+                }}>
+                    <span style={{ fontSize: '24px' }}>🔍</span>
+                    <h2 style={{
+                        margin: 0,
+                        fontSize: '18px',
+                        fontWeight: 700
+                    }}>
+                        Airport Search
+                    </h2>
+                </div>
+                <p style={{
+                    margin: '8px 0 0 34px',
+                    fontSize: '14px',
+                    color: isDark ? '#94A3B8' : '#64748B'
+                }}>
+                    Searching: <strong>"{data.query}"</strong>
+                </p>
+                <div style={{
+                    marginTop: '8px',
+                    marginLeft: '34px',
+                    fontSize: '12px',
+                    color: isDark ? '#94A3B8' : '#64748B'
+                }}>
+                    {data.results.length} result{data.results.length !== 1 ? 's' : ''}
+                </div>
+            </div>
+
+            {/* Results */}
+            {data.results.length > 0 ? (
+                <div style={{
+                    display: 'flex',
+                    gap: '12px',
+                    overflowX: 'auto',
+                    paddingBottom: '12px',
+                    scrollbarWidth: 'thin',
+                    scrollbarColor: isDark ? '#334155 #0F172A' : '#CBD5E1 #F1F5F9'
+                }}>
+                    {data.results.map((airport) => (
+                        <div key={airport.id} style={{
+                            minWidth: '300px',
+                            maxWidth: '300px',
+                            background: isDark ? '#1a1a1a' : '#ffffff',
+                            border: `1px solid ${isDark ? '#333' : '#e5e7eb'}`,
+                            borderRadius: '12px',
+                            padding: '16px',
+                            boxShadow: isDark ? '0 2px 8px rgba(0,0,0,0.3)' : '0 2px 8px rgba(0,0,0,0.1)',
+                            transition: 'all 0.2s ease',
+                            cursor: 'pointer'
+                        }}
+                            onMouseEnter={(e) => {
+                                e.currentTarget.style.transform = 'translateY(-2px)';
+                                e.currentTarget.style.boxShadow = isDark
+                                    ? '0 4px 12px rgba(59, 159, 255, 0.2)'
+                                    : '0 4px 12px rgba(59, 159, 255, 0.15)';
+                            }}
+                            onMouseLeave={(e) => {
+                                e.currentTarget.style.transform = 'translateY(0)';
+                                e.currentTarget.style.boxShadow = isDark
+                                    ? '0 2px 8px rgba(0,0,0,0.3)'
+                                    : '0 4px 12px rgba(0,0,0,0.1)';
+                            }}>
+                            <div style={{
+                                display: 'flex',
+                                justifyContent: 'space-between',
+                                alignItems: 'flex-start',
+                                gap: '12px'
+                            }}>
+                                {/* Left side */}
+                                <div style={{ flex: 1 }}>
+                                    <div style={{
+                                        display: 'flex',
+                                        alignItems: 'center',
+                                        gap: '10px',
+                                        marginBottom: '6px'
+                                    }}>
+                                        <span style={{ fontSize: '20px' }}>
+                                            {getTypeIcon(airport.type)}
+                                        </span>
+                                        <div>
+                                            <h3 style={{
+                                                margin: 0,
+                                                fontSize: '16px',
+                                                fontWeight: 600
+                                            }}>
+                                                {airport.name}
+                                            </h3>
+                                            {airport.cityName && (
+                                                <p style={{
+                                                    margin: '2px 0 0 0',
+                                                    fontSize: '12px',
+                                                    color: isDark ? '#94A3B8' : '#64748B'
+                                                }}>
+                                                    📍 {airport.cityName}
+                                                </p>
+                                            )}
+                                        </div>
+                                    </div>
+
+                                    {/* Additional details */}
+                                    <div style={{
+                                        display: 'flex',
+                                        gap: '12px',
+                                        marginTop: '8px',
+                                        flexWrap: 'wrap',
+                                        fontSize: '11px',
+                                        color: isDark ? '#94A3B8' : '#64748B'
+                                    }}>
+                                        {airport.timeZone && (
+                                            <div style={{ display: 'flex', alignItems: 'center', gap: '4px' }}>
+                                                <span>🕐</span>
+                                                <span>{airport.timeZone}</span>
+                                            </div>
+                                        )}
+                                        {airport.latitude && airport.longitude && (
+                                            <div style={{ display: 'flex', alignItems: 'center', gap: '4px' }}>
+                                                <span>🌍</span>
+                                                <span>{airport.latitude.toFixed(2)}, {airport.longitude.toFixed(2)}</span>
+                                            </div>
+                                        )}
+                                    </div>
+                                </div>
+
+                                {/* Right side - Codes */}
+                                <div style={{
+                                    display: 'flex',
+                                    flexDirection: 'column',
+                                    gap: '6px',
+                                    alignItems: 'flex-end'
+                                }}>
+                                    {/* IATA Code */}
+                                    <div style={{
+                                        background: 'var(--primary)',
+                                        color: 'white',
+                                        padding: '6px 12px',
+                                        borderRadius: '8px',
+                                        fontWeight: 700,
+                                        fontSize: '16px',
+                                        letterSpacing: '0.5px'
+                                    }}>
+                                        {airport.iataCode || 'N/A'}
+                                    </div>
+
+                                    {/* ICAO Code */}
+                                    {airport.icaoCode && (
+                                        <div style={{
+                                            background: isDark ? '#1E293B' : '#F1F5F9',
+                                            color: isDark ? '#CBD5E1' : '#475569',
+                                            padding: '3px 10px',
+                                            borderRadius: '6px',
+                                            fontSize: '10px',
+                                            fontWeight: 600
+                                        }}>
+                                            ICAO: {airport.icaoCode}
+                                        </div>
+                                    )}
+
+                                    {/* Type badge */}
+                                    <div className="badge badge-info" style={{ fontSize: '10px' }}>
+                                        {airport.type.replace('_', ' ')}
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    ))}
+                </div>
+            ) : (
+                <div style={{
+                    background: isDark ? '#0F172A' : '#F8FAFC',
+                    borderRadius: '12px',
+                    padding: '32px',
+                    textAlign: 'center'
+                }}>
+                    <div style={{ fontSize: '48px', marginBottom: '12px' }}>🔍</div>
+                    <div style={{ fontSize: '16px', marginBottom: '6px' }}>
+                        No airports found
+                    </div>
+                    <div style={{ fontSize: '12px', color: isDark ? '#94A3B8' : '#64748B' }}>
+                        Try a different city or airport code
+                    </div>
+                </div>
+            )}
+
+            {/* Help text */}
+            <div style={{
+                background: isDark ? '#0F172A' : '#F8FAFC',
+                borderRadius: '8px',
+                padding: '12px',
+                marginTop: '12px',
+                fontSize: '11px',
+                color: isDark ? '#94A3B8' : '#64748B',
+                textAlign: 'center',
+                border: `1px solid ${isDark ? '#334155' : '#E2E8F0'}`
+            }}>
+                💡 <strong>Tip:</strong> Use the IATA code (3-letter) for flight searches
+            </div>
+        </div>
+    );
+}