@updraft-solutions/mcrit-sdk 0.11.2 → 0.13.0

package/dist/operating-hours-CRZMz4E5.d.cts

@@ -0,0 +1,574 @@
+import { z } from 'zod';
+import { aC as activitySchema, aD as addressSchema, aE as aircraftPositionSchema, aF as aircraftRatingSchema, aK as airplaneSchema, aJ as airplanePermissionSchema, aL as airplaneShareInviteSchema, aM as airportSchema, aN as alertSchema, aO as allowedDocumentTypeSchema, aP as approachTypeSchema, aQ as availSchema, aR as baseMembershipSchema, aT as bookingSchema, aV as commentSchema, aX as companySchema, b1 as courseSchema, a$ as courseEnrollmentSchema, b0 as courseFeeSchema, aH as airplaneIssueSeverityEnum, b7 as documentSchema, b3 as documentComplianceStatus, b4 as documentRequirement, b5 as documentRequirementGroup, b6 as documentRequirementGroupAssignment, b8 as documentShareSchema, b9 as documentType, bb as eventSchema, bd as expenseSchema, bc as expenseItemSchema, be as extendedAirplaneSchema, bt as feeSchema, bs as feeCategoryOptionsSchema, bu as flightLogSchema, bC as invoiceSchema, bE as landingSchema, bD as landingFeeSchema, bG as maintenanceEventSchema, bF as maintenanceEventEstimationSchema, bH as maintenanceStatusSchema, bI as mediaCollection, bL as membershipSchema, bM as membershipSignupSchema, bO as postSchema, bP as postSubjectSchema, bR as prePaidPackageSchema, bS as priceSchema, bT as qualificationSchema, bU as recurringFlightSchema, bV as roleSchema, bW as runwaySchema, bX as scheduledFlightSchema, bY as settingSchema, bZ as specialFlightSchema, c4 as tagSchema, c5 as ticketSchema, cf as userSchema, cd as userAircraftRatingSchema, ce as userQualificationSchema, cg as waypointSchema, aG as airplaneIssueSchema, aI as airplaneIssueStatusEnum, B as BaseModel$1, aZ as courseCheckSyllabusSchema, a_ as courseEnrollmentMetricsSchema, bJ as mediaSchema, l as FormSubmission } from './fbo-yr7LUerk.cjs';
+
+type BaseModel = z.infer<typeof BaseModel$1>;
+type User = z.infer<typeof userSchema>;
+type Company = z.infer<typeof companySchema>;
+type Media = z.infer<typeof mediaSchema>;
+type MediaCollection = z.infer<typeof mediaCollection>;
+type BaseMembership = z.infer<typeof baseMembershipSchema>;
+type Membership = z.infer<typeof membershipSchema>;
+type Airplane = z.infer<typeof airplaneSchema>;
+type ExtendedAirplane = z.infer<typeof extendedAirplaneSchema>;
+type AirplanePermission = z.infer<typeof airplanePermissionSchema>;
+type AirplaneShareInvite = z.infer<typeof airplaneShareInviteSchema>;
+type LandingFee = z.infer<typeof landingFeeSchema>;
+type AircraftRating = z.infer<typeof aircraftRatingSchema>;
+type UserAircraftRating = z.infer<typeof userAircraftRatingSchema>;
+type UserQualification = z.infer<typeof userQualificationSchema>;
+type Airport = z.infer<typeof airportSchema>;
+type RecurringFlight = z.infer<typeof recurringFlightSchema>;
+type Fee = z.infer<typeof feeSchema>;
+type CourseFee = z.infer<typeof courseFeeSchema>;
+type FeeCategoryOptions = z.infer<typeof feeCategoryOptionsSchema>;
+type Tag = z.infer<typeof tagSchema>;
+type CourseCheckSyllabus = z.infer<typeof courseCheckSyllabusSchema>;
+type Price = z.infer<typeof priceSchema>;
+type MaintenanceEvent = z.infer<typeof maintenanceEventSchema>;
+type MaintenanceStatus = z.infer<typeof maintenanceStatusSchema>;
+type MaintenanceEventEstimation = z.infer<typeof maintenanceEventEstimationSchema>;
+type Activity = z.infer<typeof activitySchema>;
+type MembershipSignup = z.infer<typeof membershipSignupSchema>;
+type AircraftPosition = z.infer<typeof aircraftPositionSchema>;
+type Avail = z.infer<typeof availSchema>;
+type Alert = z.infer<typeof alertSchema>;
+type Booking = z.infer<typeof bookingSchema>;
+type Document = z.infer<typeof documentSchema>;
+type DocumentType = z.infer<typeof documentType>;
+type DocumentRequirement = z.infer<typeof documentRequirement>;
+type DocumentRequirementGroup = z.infer<typeof documentRequirementGroup>;
+type DocumentRequirementGroupAssignment = z.infer<typeof documentRequirementGroupAssignment>;
+type DocumentComplianceStatus = z.infer<typeof documentComplianceStatus>;
+type DocumentShare = z.infer<typeof documentShareSchema>;
+type AllowedDocumentType = z.infer<typeof allowedDocumentTypeSchema>;
+type FlightLog = z.infer<typeof flightLogSchema>;
+type ScheduledFlight = z.infer<typeof scheduledFlightSchema>;
+type Landing = z.infer<typeof landingSchema>;
+type ApproachType = z.infer<typeof approachTypeSchema>;
+type Waypoint = z.infer<typeof waypointSchema>;
+type Invoice = z.infer<typeof invoiceSchema>;
+type Expense = z.infer<typeof expenseSchema>;
+type ExpenseItem = z.infer<typeof expenseItemSchema>;
+type SpecialFlight = z.infer<typeof specialFlightSchema>;
+type PrePaidPackage = z.infer<typeof prePaidPackageSchema>;
+type Qualification = z.infer<typeof qualificationSchema>;
+type Course = z.infer<typeof courseSchema>;
+type CourseEnrollment = z.infer<typeof courseEnrollmentSchema>;
+type CourseEnrollmentMetrics = z.infer<typeof courseEnrollmentMetricsSchema>;
+type AirplaneIssue = z.infer<typeof airplaneIssueSchema>;
+type AirplaneIssueSeverity = z.infer<typeof airplaneIssueSeverityEnum>;
+type AirplaneIssueStatus = z.infer<typeof airplaneIssueStatusEnum>;
+type Event = z.infer<typeof eventSchema>;
+type Ticket = z.infer<typeof ticketSchema>;
+type Post = z.infer<typeof postSchema>;
+type PostSubject = z.infer<typeof postSubjectSchema>;
+/**
+ * Full-replacement tag sync entry — `id` marks an existing tag (wins over
+ * name matching), fresh tags carry only name (+ optional color) and are
+ * created server-side on save.
+ */
+interface TagSyncEntry {
+    id?: number | null;
+    name: string;
+    color?: string | null;
+}
+interface CreatePostInput {
+    title?: string | null;
+    content: string;
+    sticky?: boolean;
+    public?: boolean;
+    comments_disabled?: boolean;
+    tags?: TagSyncEntry[];
+    /** Action flag, not persisted: notify company members on publish. */
+    notify?: boolean;
+}
+interface UpdatePostInput {
+    title?: string | null;
+    content: string;
+    sticky?: boolean;
+    public?: boolean;
+    comments_disabled?: boolean;
+    tags?: TagSyncEntry[];
+}
+interface CreateAirplaneIssueInput {
+    title?: string | null;
+    body: string;
+    severity?: AirplaneIssueSeverity;
+    ata_chapter?: string | null;
+}
+interface UpdateAirplaneIssueInput {
+    title?: string | null;
+    body?: string;
+    severity?: AirplaneIssueSeverity;
+    ata_chapter?: string | null;
+}
+interface ResolveAirplaneIssueInput {
+    resolution_notes?: string | null;
+}
+interface DeferAirplaneIssueInput {
+    deferred_until?: string | null;
+    deferral_notes?: string | null;
+}
+type Comment = z.infer<typeof commentSchema>;
+interface CreateCommentInput {
+    body: string;
+    parent_id?: number;
+    title?: string;
+}
+interface UpdateCommentInput {
+    body?: string;
+    title?: string;
+}
+type Address = z.infer<typeof addressSchema>;
+type Runway = z.infer<typeof runwaySchema>;
+type Role = z.infer<typeof roleSchema>;
+type Setting = z.infer<typeof settingSchema>;
+
+/**
+ * Generic response wrapper for data with optional metadata
+ * @template T - The data type
+ * @template M - The metadata type (optional)
+ */
+interface DataWrappedResponse<T, M = undefined> {
+    data: T;
+    meta?: M;
+}
+type ApiResponse<T> = DataWrappedResponse<T>;
+interface PaginatedResponse<T = unknown> {
+    data: T[];
+    meta: {
+        current_page: number;
+        from: number;
+        last_page: number;
+        per_page: number;
+        to: number;
+        total: number;
+    };
+    links?: {
+        first?: string | null;
+        last?: string | null;
+        prev?: string | null;
+        next?: string | null;
+    };
+}
+interface Resource {
+    id: number;
+    type: string;
+}
+interface ToggleFavoriteResponse {
+    id: number;
+    hasFavorited: boolean;
+}
+
+interface ComplianceRequirement {
+    requirement_id: number;
+    form_template_id: number;
+    form_template_name: string;
+    logical_group: string;
+    is_satisfied: boolean;
+    awaiting_countersignature?: boolean;
+    submission: FormSubmission | null;
+}
+interface ComplianceRequirementGroup {
+    group_name: string;
+    group_operator: "AND" | "OR";
+    group_satisfied: boolean;
+    requirements: ComplianceRequirement[];
+}
+type ComplianceGroupSource = {
+    type: "direct";
+} | {
+    type: "role";
+    role: string;
+} | {
+    type: "airplane";
+    airplane_id: number;
+    registration: string;
+};
+interface ComplianceGroup {
+    group_id: number;
+    group_name: string;
+    overall_satisfied: boolean;
+    requirement_groups: ComplianceRequirementGroup[];
+    sources?: ComplianceGroupSource[];
+}
+interface ComplianceSummary {
+    total_groups: number;
+    satisfied_groups: number;
+    failed_groups: number;
+}
+interface ComplianceData {
+    overall_satisfied: boolean;
+    requirement_groups: ComplianceGroup[];
+    summary: ComplianceSummary;
+}
+interface ComplianceResponse {
+    data: ComplianceData;
+    meta: {
+        model_id: string;
+        model_type: string;
+        target_model_id: string;
+        target_model_type: string;
+    };
+}
+
+type AircraftBlockReason = "general" | "ferry" | "weather" | "private" | "aog" | "other";
+interface AircraftBlock {
+    type: "aircraftBlock";
+    id: number;
+    airplane_id: number;
+    company_id: number;
+    starts_at: string;
+    ends_at: string;
+    reason: AircraftBlockReason;
+    note: string | null;
+    is_maintenance: boolean;
+    maintenance_event_id: number | null;
+    created_at: string;
+    updated_at: string;
+    can?: Record<string, boolean | null>;
+}
+
+type BackgroundTaskStatus = "queued" | "processing" | "completed" | "failed" | "canceled";
+interface BackgroundTask<TResult = unknown> {
+    type: "background_task";
+    /** Store key — mirrors `uuid` (the API has no client-facing integer id). */
+    id: string;
+    uuid: string;
+    task_type: string;
+    status: BackgroundTaskStatus;
+    progress: number | null;
+    progress_label: string | null;
+    company_id: number | null;
+    user_id: number | null;
+    result: TResult | null;
+    error: string | null;
+    started_at: string | null;
+    finished_at: string | null;
+    created_at: string | null;
+}
+
+type AiSuggestionStatus = "pending" | "ready" | "applied" | "dismissed" | "failed";
+interface AiSuggestion<TPayload = unknown> {
+    type: "ai_suggestion";
+    id: number;
+    subject_type: string;
+    subject_id: number;
+    company_id: number | null;
+    suggestion_type: string;
+    locale: string;
+    payload: TPayload;
+    meta?: unknown;
+    status: AiSuggestionStatus;
+    requested_by: number | null;
+    applied_at: string | null;
+    dismissed_at: string | null;
+    created_at: string;
+}
+interface AiSuggestedMilestone {
+    name: string;
+    description?: string | null;
+    kind: "progress" | "prerequisite" | "solo" | "cross_country";
+    is_prerequisite: boolean;
+    sort_order: number;
+}
+interface CourseDescriptionSuggestionPayload {
+    title: string;
+    subtitle: string;
+    summary: string;
+    html: string;
+    milestones: AiSuggestedMilestone[];
+}
+interface LogbookFlightLogPayload {
+    etdZ: string | null;
+    etaZ: string | null;
+    departure_airport_id: number | null;
+    destination_airport_id: number | null;
+    departure_airport_icao: string | null;
+    destination_airport_icao: string | null;
+    full_stop_landings: number;
+    touch_and_gos: number;
+    low_approaches: number;
+    crew_assignments: {
+        membership_id: number;
+        role: string;
+    }[];
+    membership_id: number | null;
+    billing_profile_id?: number | null;
+}
+interface LogbookSuggestionMeta {
+    flags?: string[];
+    match?: {
+        confidence: string;
+        reasoning: string;
+    };
+    extraction?: {
+        valid: boolean | null;
+        discrepancy_minutes: number | null;
+    };
+    crew_text?: string | null;
+}
+type LogbookSuggestion = AiSuggestion<LogbookFlightLogPayload> & {
+    meta?: LogbookSuggestionMeta;
+};
+interface DiscardedRow {
+    reason: string;
+    flight: Record<string, unknown>;
+}
+interface LogbookStageResult {
+    booking_id: number;
+    suggestion_ids: number[];
+    staged: number;
+    routed: Record<string, number> | number[];
+    discarded: DiscardedRow[];
+}
+
+interface RoleListItem {
+    id: number;
+    name: string;
+    description: string | null;
+    is_system: boolean;
+    has_duties: boolean;
+    company_id: number | null;
+    permissions_count: number;
+}
+interface PermissionItem {
+    id: number;
+    name: string;
+    description: string | null;
+    group: string;
+}
+interface RoleDetail extends Omit<RoleListItem, "permissions_count"> {
+    permissions: PermissionItem[];
+}
+interface GroupedPermissions {
+    [group: string]: PermissionItem[];
+}
+
+interface LandingFeeTemplateParams {
+    landing_type: "FULLSTOP" | "TOUCHANDGO" | "LOWAPPROACH";
+    net_gross: "net" | "gross";
+    valid_from: string;
+    tax_percentage?: number;
+    approach_type_id?: number;
+}
+interface LandingFeeImportResult {
+    created: number;
+    updated: number;
+    unchanged: number;
+    prices_added: number;
+    skipped: number;
+    issues: string[];
+    preview: Array<[
+        string,
+        string,
+        string,
+        string,
+        string,
+        "new" | "update" | "unchanged"
+    ]>;
+    meta: {
+        landing_type: string;
+        approach_type_id: number;
+        net_gross: string;
+        tax_percentage: number;
+        valid_from: string;
+    };
+}
+interface LandingFeeInvoicePreviewRow {
+    registration: string;
+    airplane_id: number | null;
+    fee_type: string;
+    landing_type: string | null;
+    unit_price: number;
+    price_basis: "net" | "gross";
+    vat_rate: number | null;
+    net_total: number | null;
+    gross_total: number | null;
+    current_price: number | null;
+    current_net_total: number | null;
+    current_gross_total: number | null;
+    date: string | null;
+    start_time: string | null;
+    landing_time: string | null;
+    status: "new" | "changed" | "unchanged" | "unmatched-aircraft" | "unmapped-fee-type" | "airport-unknown";
+}
+interface LandingFeeInvoicePreview {
+    rejected: boolean;
+    message: string | null;
+    company_id: number;
+    airport: {
+        id: number;
+        ident: string;
+        name: string;
+    } | null;
+    invoice: {
+        number: string | null;
+        date: string | null;
+        currency: string | null;
+        issuing_airport_name: string | null;
+        suggested_airport_icao_ident: string | null;
+    };
+    landing_fee_rows: LandingFeeInvoicePreviewRow[];
+    other_fees: Array<Record<string, unknown>>;
+    warnings: Array<{
+        type: string;
+        message: string;
+    }>;
+}
+interface LandingFeeInvoiceApplyPayload {
+    airport_id: number;
+    valid_from: string;
+    tax_percentage: number;
+    approach_type_id: number;
+    rows: Array<{
+        airplane_id: number;
+        landing_type: string;
+        unit_price: number;
+        price_basis: "net" | "gross";
+        vat_rate: number | null;
+    }>;
+}
+interface LandingFeeInvoiceApplyResult {
+    created: number;
+    updated: number;
+    unchanged: number;
+    prices_added: number;
+    issues: string[];
+}
+
+/**
+ * Operating hours — an organization defines several independent groups (its
+ * own office hours, a military field it flies from, the tower, an FBO). Each
+ * group is self-contained (own IANA timezone + optional airport) and is
+ * materialised server-side into merged, half-open UTC windows; status is
+ * answered per group as open / partial / closed / unknown.
+ */
+type OperatingHourKind = "company" | "airport" | "atc" | "fbo" | "military" | "fuel" | "customs" | "handling" | "maintenance" | "other";
+type TimeAnchor = "fixed" | "sunrise" | "sunset";
+type OperatingStatusValue = "open" | "partial" | "closed" | "unknown";
+/**
+ * One open block. Each bound is a fixed local time, or sunrise/sunset with a
+ * signed offset and an optional cap ("SR-30 aber nicht vor 07:00"). An end at
+ * or before its start crosses midnight.
+ */
+type OperatingHourInterval = {
+    id?: number;
+    sort: number;
+    start_kind: TimeAnchor;
+    start_time: string | null;
+    start_offset_minutes: number | null;
+    start_not_before: string | null;
+    end_kind: TimeAnchor;
+    end_time: string | null;
+    end_offset_minutes: number | null;
+    end_not_after: string | null;
+};
+/** One weekday. ISO: 1 = Monday .. 7 = Sunday. */
+type OperatingHourDay = {
+    id?: number;
+    schedule_id?: number;
+    day_of_week: number;
+    is_closed: boolean;
+    is_24_hours: boolean;
+    notes: string | null;
+    intervals: OperatingHourInterval[];
+};
+/** A hand-entered override for a date range. No recurrence, by design. */
+type OperatingHourException = {
+    id: number;
+    schedule_id: number;
+    starts_on: string;
+    ends_on: string;
+    is_closed: boolean;
+    is_24_hours: boolean;
+    reason: string;
+    intervals: OperatingHourInterval[];
+};
+/**
+ * What the client composes before an exception exists — no id, no owner yet.
+ * The read type above is what comes back; keeping the two apart lets the
+ * dialog's `createItem` seed a blank without lying about an id.
+ */
+type OperatingHourExceptionInput = Omit<OperatingHourException, "id" | "schedule_id">;
+/** A concrete, merged, half-open UTC window. Derived — read-only. */
+type OperatingHourWindow = {
+    starts_at: string;
+    ends_at: string;
+};
+/**
+ * A group. Self-contained: carries its own timezone and airport, resolved
+ * from nowhere else. `materialized_from`/`materialized_through` bound the
+ * range in which "no window" genuinely means closed rather than unknown.
+ */
+type OperatingHourSchedule = {
+    id: number;
+    company_id: number;
+    airport_id: number | null;
+    airport?: {
+        id: number;
+        ident: string;
+        name: string;
+    } | null;
+    kind: OperatingHourKind;
+    name: string;
+    description: string | null;
+    timezone: string;
+    valid_from: string;
+    valid_until: string | null;
+    is_active: boolean;
+    sort_order: number;
+    source: string | null;
+    verified_at: string | null;
+    materialized_from: string | null;
+    materialized_through: string | null;
+    days: OperatingHourDay[];
+    exceptions: OperatingHourException[];
+    created_at?: string;
+    updated_at?: string;
+};
+/** The fields a client may send when creating a group. */
+type OperatingHourScheduleInput = Partial<Omit<OperatingHourSchedule, "id" | "company_id" | "airport" | "materialized_from" | "materialized_through" | "days" | "exceptions" | "created_at" | "updated_at">>;
+/**
+ * What the saved rules resolve to on ONE named calendar date — used for the
+ * solstice hints. Carries its own date and status precisely so the extremes
+ * can never be merged into a weekday bucket alongside the current week, and
+ * so an `unknown` date is reported as unknown rather than as closed.
+ */
+type OperatingHourResolvedDate = {
+    /** `Y-m-d` in the group's timezone. */
+    date: string;
+    status: OperatingStatusValue;
+    windows: OperatingHourWindow[];
+};
+type OperatingHourStatusEntry = {
+    schedule_id: number;
+    kind: OperatingHourKind;
+    name: string;
+    timezone: string;
+    status: OperatingStatusValue;
+    windows: OperatingHourWindow[];
+};
+type OperatingHoursStatusResponse = {
+    from: string;
+    to: string;
+    data: OperatingHourStatusEntry[];
+};
+type OperatingHoursNextOpenEntry = {
+    schedule_id: number;
+    kind: OperatingHourKind;
+    name: string;
+    next_opening: string | null;
+};
+type OperatingHoursNextOpenResponse = {
+    after: string;
+    data: OperatingHoursNextOpenEntry[];
+};
+type OperatingHoursMeta = {
+    kinds: OperatingHourKind[];
+    anchors: TimeAnchor[];
+    statuses: OperatingStatusValue[];
+    max_status_range_days: number;
+};
+
+export type { FeeCategoryOptions as $, Activity as A, BackgroundTask as B, Comment as C, ComplianceResponse as D, ComplianceSummary as E, Course as F, CourseDescriptionSuggestionPayload as G, CourseEnrollment as H, CourseFee as I, CreateAirplaneIssueInput as J, CreateCommentInput as K, CreatePostInput as L, DataWrappedResponse as M, DeferAirplaneIssueInput as N, DiscardedRow as O, Document as P, DocumentComplianceStatus as Q, DocumentRequirement as R, DocumentRequirementGroup as S, DocumentRequirementGroupAssignment as T, DocumentShare as U, DocumentType as V, Event as W, Expense as X, ExpenseItem as Y, ExtendedAirplane as Z, Fee as _, Address as a, Waypoint as a$, FlightLog as a0, GroupedPermissions as a1, Invoice as a2, Landing as a3, LandingFee as a4, LandingFeeImportResult as a5, LandingFeeInvoiceApplyPayload as a6, LandingFeeInvoiceApplyResult as a7, LandingFeeInvoicePreview as a8, LandingFeeInvoicePreviewRow as a9, PaginatedResponse as aA, PermissionItem as aB, Post as aC, PostSubject as aD, PrePaidPackage as aE, Price as aF, Qualification as aG, RecurringFlight as aH, ResolveAirplaneIssueInput as aI, Resource as aJ, Role as aK, RoleDetail as aL, RoleListItem as aM, Runway as aN, ScheduledFlight as aO, Setting as aP, SpecialFlight as aQ, Tag as aR, Ticket as aS, TimeAnchor as aT, ToggleFavoriteResponse as aU, UpdateAirplaneIssueInput as aV, UpdateCommentInput as aW, UpdatePostInput as aX, User as aY, UserAircraftRating as aZ, UserQualification as a_, LandingFeeTemplateParams as aa, LogbookFlightLogPayload as ab, LogbookStageResult as ac, LogbookSuggestion as ad, LogbookSuggestionMeta as ae, MaintenanceEvent as af, MaintenanceEventEstimation as ag, MaintenanceStatus as ah, MediaCollection as ai, Membership as aj, MembershipSignup as ak, OperatingHourDay as al, OperatingHourException as am, OperatingHourExceptionInput as an, OperatingHourInterval as ao, OperatingHourKind as ap, OperatingHourResolvedDate as aq, OperatingHourSchedule as ar, OperatingHourScheduleInput as as, OperatingHourStatusEntry as at, OperatingHourWindow as au, OperatingHoursMeta as av, OperatingHoursNextOpenEntry as aw, OperatingHoursNextOpenResponse as ax, OperatingHoursStatusResponse as ay, OperatingStatusValue as az, AiSuggestedMilestone as b, AirplaneIssue as b0, AirplaneIssueSeverity as b1, AirplaneIssueStatus as b2, BaseModel as b3, CourseCheckSyllabus as b4, CourseEnrollmentMetrics as b5, Media as b6, TagSyncEntry as b7, AiSuggestion as c, AiSuggestionStatus as d, AircraftBlock as e, AircraftBlockReason as f, AircraftPosition as g, AircraftRating as h, Airplane as i, AirplanePermission as j, AirplaneShareInvite as k, Airport as l, Alert as m, AllowedDocumentType as n, ApiResponse as o, ApproachType as p, Avail as q, BackgroundTaskStatus as r, BaseMembership as s, Booking as t, Company as u, ComplianceData as v, ComplianceGroup as w, ComplianceGroupSource as x, ComplianceRequirement as y, ComplianceRequirementGroup as z };