@almatar/smart-booking-dashboard 0.0.2-alpha.2 → 0.0.2-alpha.3

package/lib/models/reissue.types.d.ts

@@ -0,0 +1,147 @@
+/** Services that end in a web search redirect. */
+export type ReissueSearchService = 'change_date' | 'change_route';
+export type ReissueServiceKey = ReissueSearchService | 'upgrade_class';
+export type ReissueTripType = 'OneWay' | 'RoundTrip' | 'MultiCity';
+export interface ReissueAirport {
+    id: string;
+    name: string;
+    city_name: string;
+    country_name: string;
+    type: 'airport' | 'city';
+}
+/** One leg of the original booking, normalized from `booking_info.leg_info`. */
+export interface ReissueLeg {
+    legId: string;
+    direction: string;
+    originCode: string;
+    originName: string;
+    originCityName: string;
+    originCountryName: string;
+    destinationCode: string;
+    destinationName: string;
+    destinationCityName: string;
+    destinationCountryName: string;
+    /** Original departure, ISO-like string as the backend returns it. */
+    departure: string;
+    arrival: string;
+    airline: string;
+    /** Number of stops (layovers) on the leg. */
+    stops: number;
+    flightNo: string;
+}
+/** Everything the web search URL needs from the original booking. */
+export interface ReissueBookingContext {
+    bookingId: string;
+    tripType: ReissueTripType;
+    legs: ReissueLeg[];
+    adults: number;
+    children: number;
+    infants: number;
+    cabinName: string;
+    cabinCode: string;
+    currency: string;
+    airlineCode: string;
+    flightNumber: string;
+    airlineName: string;
+    totalStops: number;
+}
+export interface ReissueLegAvailability {
+    legId: string;
+    available: boolean;
+    isWhatsapp?: boolean;
+}
+export interface ReissueAvailabilityResponse {
+    data?: {
+        legs?: ReissueLegAvailability[];
+        /** `false` = a round trip must be upgraded as a whole (the web's `allowCustomerToSelectSingleLeg`). Missing = allowed. */
+        allowCustomerToSelectSingleLeg?: boolean;
+    };
+}
+/** What the agent picked on the edit step. */
+export interface ReissueSelection {
+    service: ReissueSearchService;
+    legs: ReissueLegChange[];
+}
+export interface ReissueLegChange {
+    legId: string;
+    /** change_date: new departure date, `YYYY-MM-DD`. */
+    departDate?: string;
+    /** change_route: new airports. */
+    origin?: ReissueAirport;
+    destination?: ReissueAirport;
+}
+export interface ReissueUpgradeOption {
+    /** Sent back to choose-flight (`ItineraryId` for booking scope, `legId` for leg scope). */
+    referenceKey: string;
+    code: string;
+    name: string;
+    providerType: string;
+    type?: string;
+    fareDetails?: {
+        totalAdditionalFare?: number;
+    };
+    priceDifference?: number;
+}
+export interface ReissueUpgradeExistingLeg {
+    legIndex?: number;
+    origin: string;
+    destination: string;
+    departureDateTime?: string;
+    airlineCode?: string;
+    flightNumber?: string;
+    class?: string;
+    bookingClass?: string;
+    fareBrand?: {
+        code?: string;
+        name?: string;
+    };
+}
+export interface ReissueUpgradeLeg {
+    legIndex: number;
+    origin?: string;
+    destination?: string;
+    options?: ReissueUpgradeOption[];
+    existingLeg: ReissueUpgradeExistingLeg;
+}
+export interface ReissueUpgradeOptionsResponse {
+    fareOptionScope?: 'leg' | 'booking';
+    /** scope `leg`: options per leg. */
+    legs?: ReissueUpgradeLeg[];
+    /** scope `booking`: options for the whole booking. */
+    options?: ReissueUpgradeOption[];
+    existingLegs?: ReissueUpgradeExistingLeg[];
+    originalLegs?: ReissueUpgradeExistingLeg[];
+}
+/** Body of `POST .../reissue/choose-flight/{bookingId}/{postBookingId}` (same shape the web sends for Upgrade Class). */
+export interface ReissueChooseFlightRequest {
+    fareOptionScope: 'leg' | 'booking';
+    /** scope `booking`: the chosen itinerary. */
+    ItineraryId?: string;
+    /** scope `leg`: the chosen option per leg. */
+    onwardLeg?: {
+        legId: string;
+        providerType: string;
+    };
+    returnLeg?: {
+        legId: string;
+        providerType: string;
+    };
+}
+/** `data` of the choose-flight response (fields the web reads). */
+export interface ReissueChooseFlightResponse {
+    itineraryAvailable?: boolean;
+    priceChanged?: boolean;
+    price?: number;
+    currency?: string;
+}
+/**
+ * Payment link of a reissue. There is no separate API: it comes from the cart of the post-booking
+ * (`GET /v2/manage-booking/flight/cart/{postBookingId}`), see `ReissueService.getPaymentLink`. The agent copies it and
+ * sends it to the customer; the dialog does not follow the payment afterwards.
+ */
+export interface ReissuePaymentLink {
+    url: string;
+    amount: number;
+    currency: string;
+    expiresAt?: string;
+}

package/lib/pages/smart-booking-dashboard/smart-booking-dashboard.component.d.ts

@@ -3,14 +3,17 @@ import * as i0 from "@angular/core";
 export declare class SmartBookingDashboardComponent {
     private bookingService;
     private toast;
+    /** The Reissue button is shown for flights only, and only when the host enabled the feature. */
+    protected readonly reissueEnabled: boolean;
     product: import("@angular/core").WritableSignal<ProductType>;
     bookingId: import("@angular/core").WritableSignal<string>;
-    bookingStatus: import("@angular/core").WritableSignal<"error" | "idle" | "loading" | "success">;
+    bookingStatus: import("@angular/core").WritableSignal<"error" | "success" | "idle" | "loading">;
     bookingData: import("@angular/core").WritableSignal<any>;
     cancelDialogOpen: import("@angular/core").WritableSignal<boolean>;
     hotelAutoCancelDialogOpen: import("@angular/core").WritableSignal<boolean>;
     actionDialogOpen: import("@angular/core").WritableSignal<boolean>;
     addNoteDialogOpen: import("@angular/core").WritableSignal<boolean>;
+    reissueDialogOpen: import("@angular/core").WritableSignal<boolean>;
     selectedActionKey: import("@angular/core").WritableSignal<string>;
     activeContextTab: import("@angular/core").WritableSignal<"notes" | "changes">;
     availableActions: import("@angular/core").Signal<import("../../models/action.types").ActionConfig[]>;

package/lib/services/reissue.service.d.ts

@@ -0,0 +1,45 @@
+import { Observable } from 'rxjs';
+import { ReissueAirport, ReissueAvailabilityResponse, ReissueBookingContext, ReissueChooseFlightRequest, ReissueChooseFlightResponse, ReissuePaymentLink, ReissueUpgradeOptionsResponse } from '../models/reissue.types';
+import * as i0 from "@angular/core";
+/**
+ * Reissue APIs — the same endpoints the consumer web uses (the backend opens them for BO).
+ */
+export declare class SbdReissueService {
+    private http;
+    private config;
+    private base;
+    private get headers();
+    /** `POST /v2/manage-booking/flight/create-post-booking/{bookingId}` -> `postBookingId`. */
+    createPostBooking(bookingId: string): Observable<string>;
+    /** `GET /v3/manage-booking/flight/reissue/availability/{bookingId}/{postBookingId}` -> `data.legs[]`. */
+    getAvailability(bookingId: string, postBookingId: string, ctx?: ReissueBookingContext): Observable<ReissueAvailabilityResponse>;
+    /**
+     * `POST /v3/manage-booking/flight/reissue/upgrade-class/{bookingId}/{postBookingId}` — same call (and body) the
+     * web makes to decide whether the "Upgrade Class" option is shown. Returns the unwrapped `data`.
+     */
+    getUpgradeClassOptions(bookingId: string, postBookingId: string, ctx: ReissueBookingContext): Observable<ReissueUpgradeOptionsResponse | null>;
+    /** Same rule as the web's `hasUpgradeOptions()`: at least one option in any section. */
+    hasUpgradeOptions(data: ReissueUpgradeOptionsResponse | null): boolean;
+    /**
+     * Airport picker for Change Route. Same typeahead endpoint the web and the backoffice already use
+     * (`StaticDataService.getAirports`) — no extra backend work needed. Response: `data[].items[].items[]`.
+     * An empty term makes no request (the dialog lists the booking's own airports meanwhile).
+     */
+    searchAirports(term: string): Observable<ReissueAirport[]>;
+    /**
+     * `POST /v3/manage-booking/flight/reissue/choose-flight/{bookingId}/{postBookingId}` — prices the chosen upgrade
+     * option. Same endpoint/body the web uses; response `data` carries `itineraryAvailable`, `priceChanged`, `price`, `currency`.
+     */
+    chooseFlight(bookingId: string, postBookingId: string, body: ReissueChooseFlightRequest): Observable<ReissueChooseFlightResponse>;
+    /** `POST /v2/manage-booking/flight/book-now` — places a zero-total reissue (no payment needed). */
+    bookNow(postBookingId: string): Observable<unknown>;
+    /**
+     * Payment link of a reissue with an amount to pay. There is no separate API: the backend puts the link in the
+     * cart of the post-booking (`GET /v2/manage-booking/flight/cart/{postBookingId}`, the call the web checkout reads).
+     * The name of the field is not final yet: the first of the names below that exists is used, and the call fails
+     * with a clear message when the cart has none.
+     */
+    getPaymentLink(postBookingId: string, amount?: number, currency?: string): Observable<ReissuePaymentLink>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SbdReissueService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SbdReissueService>;
+}

package/lib/services/toast.service.d.ts

@@ -1,10 +1,23 @@
+import { InjectionToken } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * How the dashboard shows messages. The backoffice uses ngx-toastr (the default); a host that has its own toast
+ * system (e.g. Helix with PrimeNG's `MessageService`) provides this token and the dashboard uses it instead.
+ */
+export interface SbdToastHandler {
+    success(message: string): void;
+    error(message: string): void;
+    info(message: string): void;
+    warning(message: string): void;
+}
+export declare const SBD_TOAST_HANDLER: InjectionToken<SbdToastHandler>;
 export declare class SbdToastService {
-    private toastr;
+    private handler;
     success(msg: string): void;
     error(msg: string): void;
     info(msg: string): void;
     warning(msg: string): void;
+    private show;
     static ɵfac: i0.ɵɵFactoryDeclaration<SbdToastService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SbdToastService>;
 }

package/lib/utils/reissue-format.d.ts

@@ -0,0 +1,28 @@
+import { ReissueAirport, ReissueLeg } from '../models/reissue.types';
+/** Today as `YYYY-MM-DD` in the agent's timezone (what `<input type="date">` compares against). */
+export declare function todayIso(): string;
+export declare function formatReissueDate(value: string): string;
+/**
+ * Expiry of the payment link as epoch ms. The backend sends `YYYY-MM-DD HH:mm:ss` with no timezone, read as UTC (to
+ * be confirmed with the backend); a value that carries `Z` or an offset is read as it is. `null` when missing/invalid.
+ */
+export declare function parseLinkExpiry(value?: string | null): number | null;
+/** `mm:ss` (or `h:mm:ss` from one hour up) for a countdown. */
+export declare function formatCountdown(ms: number): string;
+export declare function legTitle(leg: ReissueLeg): string;
+export declare function airportOf(id: string, name: string, city: string, country: string): ReissueAirport;
+export declare const originAirport: (l: ReissueLeg) => ReissueAirport;
+export declare const destinationAirport: (l: ReissueLeg) => ReissueAirport;
+export declare const compareAirports: (a: ReissueAirport, b: ReissueAirport) => boolean;
+export declare function formatMoney(amount: number, currency: string): string;
+/** `21 Oct` — same short date the cancel dialog shows on a leg card. */
+export declare function formatShortDate(value: string): string;
+/** `01:55` straight from the `YYYY-MM-DDTHH:mm:ss` string (no timezone conversion). */
+export declare function formatTime(value: string): string;
+/**
+ * The leg already departed. The booking gives no timezone for `LegDepartureDateTime` (airport local time), so this
+ * compares with the agent's clock: it can be off by a few hours on the day of the flight, never by a day.
+ */
+export declare function isLegFlown(leg: {
+    departure: string;
+}): boolean;

package/lib/utils/reissue-url.builder.d.ts

@@ -0,0 +1,24 @@
+import { ReissueBookingContext, ReissueSelection } from '../models/reissue.types';
+/**
+ * Port of the web's `FlightManageBookingService.navigateToOnlineBooking()`
+ * (almatar-consumer-apps) — builds the query params of
+ * `/flights/manage-booking/list`, where the web continues the reissue
+ * (search -> view-price -> choose-flight -> payment).
+ * Keep the param names/values identical to the web.
+ */
+export declare const REISSUE_WEB_PATH = "/flights/manage-booking/list/";
+type Raw = any;
+/**
+ * Normalizes the dashboard's `booking_info` (from `/v1/fcr/booking/information`)
+ * into what the URL builder needs. Reads defensively: any field missing in the
+ * BO response falls back to an empty value.
+ */
+export declare function buildReissueBookingContext(bookingData: Raw, bookingId: string): ReissueBookingContext | null;
+export declare function buildReissueSearchParams(rawCtx: ReissueBookingContext, selection: ReissueSelection, postBookingId: string): Record<string, string>;
+export declare function buildReissueSearchUrl(webBaseUrl: string, ctx: ReissueBookingContext, selection: ReissueSelection, postBookingId: string): string;
+/**
+ * Adds the host's auth parameters (for example its token) to the web link: in the query string, or in the `#fragment`
+ * (which browsers do not send to servers or in the Referer). Empty values are skipped.
+ */
+export declare function appendAuthParams(url: string, params: Record<string, string>, where?: 'query' | 'hash'): string;
+export {};

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "@almatar/smart-booking-dashboard",
-  "version": "0.0.2-alpha.2",
+  "version": "0.0.2-alpha.3",
   "description": "Almatar Smart Booking Dashboard (Angular library)",
   "peerDependencies": {
-    "@angular/animations": "^18.0.0",
-    "@angular/common": "^18.0.0",
-    "@angular/core": "^18.0.0",
-    "@angular/forms": "^18.0.0",
-    "@angular/router": "^18.0.0",
+    "@angular/animations": "^18.0.0 || ^21.0.0",
+    "@angular/common": "^18.0.0 || ^21.0.0",
+    "@angular/core": "^18.0.0 || ^21.0.0",
+    "@angular/forms": "^18.0.0 || ^21.0.0",
+    "@angular/router": "^18.0.0 || ^21.0.0",
     "@ng-select/ng-select": "^13.7.0",
+    "@ngrx/store": "^18.0.0 || ^21.0.0",
+    "moment": "^2.29.0",
     "ngx-toastr": "^17.0.2",
-    "primeng": "^14.1.2",
+    "primeng": "^14.1.2 || ^21.0.0",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/public-api.d.ts

@@ -2,4 +2,8 @@ export { SmartBookingDashboardComponent } from './lib/pages/smart-booking-dashbo
 export { smartBookingDashboardRoutes } from './lib/smart-booking-dashboard.routes';
 export { SmartBookingDashboardModule } from './lib/smart-booking-dashboard.module';
 export { SBD_CONFIG, SBD_DEFAULT_CONFIG, provideSmartBookingDashboard } from './lib/config/dashboard.config';
-export type { SbdConfig } from './lib/config/dashboard.config';
+export type { SbdConfig, SbdRedirectAuthParams } from './lib/config/dashboard.config';
+export { buildReissueSearchUrl, buildReissueSearchParams, buildReissueBookingContext, appendAuthParams } from './lib/utils/reissue-url.builder';
+export type * from './lib/models/reissue.types';
+export { SBD_TOAST_HANDLER } from './lib/services/toast.service';
+export type { SbdToastHandler } from './lib/services/toast.service';