@updraft-solutions/mcrit-sdk 0.5.0 → 0.6.0

package/dist/types/index.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { aA as addressSchema, aB as aircraftRatingSchema, aG as airplaneSchema, aF as airplanePermissionSchema, aH as airplaneShareInviteSchema, aI as airportSchema, aJ as alertSchema, aK as allowedDocumentTypeSchema, aL as approachTypeSchema, aM as availSchema, aN as baseMembershipSchema, aO as bookingSchema, aQ as commentSchema, aR as companySchema, aX as courseSchema, aV as courseEnrollmentSchema, aW as courseFeeSchema, aD as airplaneIssueSeverityEnum, b1 as documentSchema, aZ as documentComplianceStatus, a_ as documentRequirement, a$ as documentRequirementGroup, b0 as documentRequirementGroupAssignment, b2 as documentShareSchema, b3 as documentType, b5 as eventSchema, b7 as expenseSchema, b6 as expenseItemSchema, b8 as extendedAirplaneSchema, ba as feeSchema, b9 as feeCategoryOptionsSchema, bb as flightLogSchema, bh as invoiceSchema, bj as landingSchema, bi as landingFeeSchema, bl as maintenanceEventSchema, bk as maintenanceEventEstimationSchema, bm as maintenanceStatusSchema, bn as mediaCollection, bp as membershipSchema, bq as postSchema, 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, bG as tagSchema, bH as ticketSchema, bR as userSchema, bP as userAircraftRatingSchema, bQ as userQualificationSchema, bS as waypointSchema, aC as airplaneIssueSchema, aE as airplaneIssueStatusEnum, B as BaseModel$1, aT as courseCheckSyllabusSchema, aU as courseEnrollmentMetricsSchema, bo as mediaSchema, l as FormSubmission } from '../training-Der1DPU-.cjs';
+import { aA as activitySchema, aB as addressSchema, aC as aircraftPositionSchema, aD as aircraftRatingSchema, aI as airplaneSchema, aH as airplanePermissionSchema, aJ as airplaneShareInviteSchema, aK as airportSchema, aL as alertSchema, aM as allowedDocumentTypeSchema, aN as approachTypeSchema, aO as availSchema, aP as baseMembershipSchema, aQ as bookingSchema, aS as commentSchema, aT as companySchema, aZ as courseSchema, aX as courseEnrollmentSchema, aY as courseFeeSchema, aF as airplaneIssueSeverityEnum, b3 as documentSchema, a$ as documentComplianceStatus, b0 as documentRequirement, b1 as documentRequirementGroup, b2 as documentRequirementGroupAssignment, b4 as documentShareSchema, b5 as documentType, b7 as eventSchema, b9 as expenseSchema, b8 as expenseItemSchema, ba as extendedAirplaneSchema, bc as feeSchema, bb as feeCategoryOptionsSchema, bd as flightLogSchema, bj as invoiceSchema, bl as landingSchema, bk as landingFeeSchema, bn as maintenanceEventSchema, bm as maintenanceEventEstimationSchema, bo as maintenanceStatusSchema, bp as mediaCollection, br as membershipSchema, bs as membershipSignupSchema, bt as postSchema, bu as prePaidPackageSchema, bv as priceSchema, bw as qualificationSchema, bx as recurringFlightSchema, by as roleSchema, bz as runwaySchema, bA as scheduledFlightSchema, bB as settingSchema, bC as specialFlightSchema, bJ as tagSchema, bK as ticketSchema, bU as userSchema, bS as userAircraftRatingSchema, bT as userQualificationSchema, bV as waypointSchema, aE as airplaneIssueSchema, aG as airplaneIssueStatusEnum, B as BaseModel$1, aV as courseCheckSyllabusSchema, aW as courseEnrollmentMetricsSchema, bq as mediaSchema, l as FormSubmission } from '../training-C9rIBUeV.cjs';
 
 type BaseModel = z.infer<typeof BaseModel$1>;
 type User = z.infer<typeof userSchema>;
@@ -27,6 +27,9 @@ 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>;
@@ -416,4 +419,4 @@ interface LandingFeeInvoiceApplyResult {
     issues: string[];
 }
 
-export type { Address, AiSuggestedMilestone, AiSuggestion, AiSuggestionStatus, AircraftBlock, AircraftBlockReason, AircraftRating, Airplane, AirplaneIssue, AirplaneIssueSeverity, AirplaneIssueStatus, AirplanePermission, AirplaneShareInvite, Airport, Alert, AllowedDocumentType, ApiResponse, ApproachType, Avail, BackgroundTask, BackgroundTaskStatus, BaseMembership, BaseModel, Booking, Comment, Company, ComplianceData, ComplianceGroup, ComplianceGroupSource, ComplianceRequirement, ComplianceRequirementGroup, ComplianceResponse, ComplianceSummary, Course, CourseCheckSyllabus, CourseDescriptionSuggestionPayload, CourseEnrollment, CourseEnrollmentMetrics, CourseFee, CreateAirplaneIssueInput, CreateCommentInput, CreatePostInput, DataWrappedResponse, DeferAirplaneIssueInput, DiscardedRow, Document, DocumentComplianceStatus, DocumentRequirement, DocumentRequirementGroup, DocumentRequirementGroupAssignment, DocumentShare, DocumentType, Event, Expense, ExpenseItem, ExtendedAirplane, Fee, FeeCategoryOptions, FlightLog, GroupedPermissions, Invoice, Landing, LandingFee, LandingFeeImportResult, LandingFeeInvoiceApplyPayload, LandingFeeInvoiceApplyResult, LandingFeeInvoicePreview, LandingFeeInvoicePreviewRow, LandingFeeTemplateParams, LogbookFlightLogPayload, LogbookStageResult, LogbookSuggestion, LogbookSuggestionMeta, MaintenanceEvent, MaintenanceEventEstimation, MaintenanceStatus, Media, MediaCollection, Membership, PaginatedResponse, PermissionItem, Post, PrePaidPackage, Price, Qualification, RecurringFlight, ResolveAirplaneIssueInput, Resource, Role, RoleDetail, RoleListItem, Runway, ScheduledFlight, Setting, SpecialFlight, Tag, Ticket, ToggleFavoriteResponse, UpdateAirplaneIssueInput, UpdateCommentInput, UpdatePostInput, User, UserAircraftRating, UserQualification, Waypoint };
+export type { Activity, Address, AiSuggestedMilestone, AiSuggestion, AiSuggestionStatus, AircraftBlock, AircraftBlockReason, AircraftPosition, AircraftRating, Airplane, AirplaneIssue, AirplaneIssueSeverity, AirplaneIssueStatus, AirplanePermission, AirplaneShareInvite, Airport, Alert, AllowedDocumentType, ApiResponse, ApproachType, Avail, BackgroundTask, BackgroundTaskStatus, BaseMembership, BaseModel, Booking, Comment, Company, ComplianceData, ComplianceGroup, ComplianceGroupSource, ComplianceRequirement, ComplianceRequirementGroup, ComplianceResponse, ComplianceSummary, Course, CourseCheckSyllabus, CourseDescriptionSuggestionPayload, CourseEnrollment, CourseEnrollmentMetrics, CourseFee, CreateAirplaneIssueInput, CreateCommentInput, CreatePostInput, DataWrappedResponse, DeferAirplaneIssueInput, DiscardedRow, Document, DocumentComplianceStatus, DocumentRequirement, DocumentRequirementGroup, DocumentRequirementGroupAssignment, DocumentShare, DocumentType, Event, Expense, ExpenseItem, ExtendedAirplane, Fee, FeeCategoryOptions, FlightLog, GroupedPermissions, Invoice, Landing, LandingFee, LandingFeeImportResult, LandingFeeInvoiceApplyPayload, LandingFeeInvoiceApplyResult, LandingFeeInvoicePreview, LandingFeeInvoicePreviewRow, LandingFeeTemplateParams, LogbookFlightLogPayload, LogbookStageResult, LogbookSuggestion, LogbookSuggestionMeta, MaintenanceEvent, MaintenanceEventEstimation, MaintenanceStatus, Media, MediaCollection, Membership, MembershipSignup, PaginatedResponse, PermissionItem, Post, PrePaidPackage, Price, Qualification, RecurringFlight, ResolveAirplaneIssueInput, Resource, Role, RoleDetail, RoleListItem, Runway, ScheduledFlight, Setting, SpecialFlight, Tag, Ticket, ToggleFavoriteResponse, UpdateAirplaneIssueInput, UpdateCommentInput, UpdatePostInput, User, UserAircraftRating, UserQualification, Waypoint };

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { aA as addressSchema, aB as aircraftRatingSchema, aG as airplaneSchema, aF as airplanePermissionSchema, aH as airplaneShareInviteSchema, aI as airportSchema, aJ as alertSchema, aK as allowedDocumentTypeSchema, aL as approachTypeSchema, aM as availSchema, aN as baseMembershipSchema, aO as bookingSchema, aQ as commentSchema, aR as companySchema, aX as courseSchema, aV as courseEnrollmentSchema, aW as courseFeeSchema, aD as airplaneIssueSeverityEnum, b1 as documentSchema, aZ as documentComplianceStatus, a_ as documentRequirement, a$ as documentRequirementGroup, b0 as documentRequirementGroupAssignment, b2 as documentShareSchema, b3 as documentType, b5 as eventSchema, b7 as expenseSchema, b6 as expenseItemSchema, b8 as extendedAirplaneSchema, ba as feeSchema, b9 as feeCategoryOptionsSchema, bb as flightLogSchema, bh as invoiceSchema, bj as landingSchema, bi as landingFeeSchema, bl as maintenanceEventSchema, bk as maintenanceEventEstimationSchema, bm as maintenanceStatusSchema, bn as mediaCollection, bp as membershipSchema, bq as postSchema, 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, bG as tagSchema, bH as ticketSchema, bR as userSchema, bP as userAircraftRatingSchema, bQ as userQualificationSchema, bS as waypointSchema, aC as airplaneIssueSchema, aE as airplaneIssueStatusEnum, B as BaseModel$1, aT as courseCheckSyllabusSchema, aU as courseEnrollmentMetricsSchema, bo as mediaSchema, l as FormSubmission } from '../training-Der1DPU-.js';
+import { aA as activitySchema, aB as addressSchema, aC as aircraftPositionSchema, aD as aircraftRatingSchema, aI as airplaneSchema, aH as airplanePermissionSchema, aJ as airplaneShareInviteSchema, aK as airportSchema, aL as alertSchema, aM as allowedDocumentTypeSchema, aN as approachTypeSchema, aO as availSchema, aP as baseMembershipSchema, aQ as bookingSchema, aS as commentSchema, aT as companySchema, aZ as courseSchema, aX as courseEnrollmentSchema, aY as courseFeeSchema, aF as airplaneIssueSeverityEnum, b3 as documentSchema, a$ as documentComplianceStatus, b0 as documentRequirement, b1 as documentRequirementGroup, b2 as documentRequirementGroupAssignment, b4 as documentShareSchema, b5 as documentType, b7 as eventSchema, b9 as expenseSchema, b8 as expenseItemSchema, ba as extendedAirplaneSchema, bc as feeSchema, bb as feeCategoryOptionsSchema, bd as flightLogSchema, bj as invoiceSchema, bl as landingSchema, bk as landingFeeSchema, bn as maintenanceEventSchema, bm as maintenanceEventEstimationSchema, bo as maintenanceStatusSchema, bp as mediaCollection, br as membershipSchema, bs as membershipSignupSchema, bt as postSchema, bu as prePaidPackageSchema, bv as priceSchema, bw as qualificationSchema, bx as recurringFlightSchema, by as roleSchema, bz as runwaySchema, bA as scheduledFlightSchema, bB as settingSchema, bC as specialFlightSchema, bJ as tagSchema, bK as ticketSchema, bU as userSchema, bS as userAircraftRatingSchema, bT as userQualificationSchema, bV as waypointSchema, aE as airplaneIssueSchema, aG as airplaneIssueStatusEnum, B as BaseModel$1, aV as courseCheckSyllabusSchema, aW as courseEnrollmentMetricsSchema, bq as mediaSchema, l as FormSubmission } from '../training-C9rIBUeV.js';
 
 type BaseModel = z.infer<typeof BaseModel$1>;
 type User = z.infer<typeof userSchema>;
@@ -27,6 +27,9 @@ 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>;
@@ -416,4 +419,4 @@ interface LandingFeeInvoiceApplyResult {
     issues: string[];
 }
 
-export type { Address, AiSuggestedMilestone, AiSuggestion, AiSuggestionStatus, AircraftBlock, AircraftBlockReason, AircraftRating, Airplane, AirplaneIssue, AirplaneIssueSeverity, AirplaneIssueStatus, AirplanePermission, AirplaneShareInvite, Airport, Alert, AllowedDocumentType, ApiResponse, ApproachType, Avail, BackgroundTask, BackgroundTaskStatus, BaseMembership, BaseModel, Booking, Comment, Company, ComplianceData, ComplianceGroup, ComplianceGroupSource, ComplianceRequirement, ComplianceRequirementGroup, ComplianceResponse, ComplianceSummary, Course, CourseCheckSyllabus, CourseDescriptionSuggestionPayload, CourseEnrollment, CourseEnrollmentMetrics, CourseFee, CreateAirplaneIssueInput, CreateCommentInput, CreatePostInput, DataWrappedResponse, DeferAirplaneIssueInput, DiscardedRow, Document, DocumentComplianceStatus, DocumentRequirement, DocumentRequirementGroup, DocumentRequirementGroupAssignment, DocumentShare, DocumentType, Event, Expense, ExpenseItem, ExtendedAirplane, Fee, FeeCategoryOptions, FlightLog, GroupedPermissions, Invoice, Landing, LandingFee, LandingFeeImportResult, LandingFeeInvoiceApplyPayload, LandingFeeInvoiceApplyResult, LandingFeeInvoicePreview, LandingFeeInvoicePreviewRow, LandingFeeTemplateParams, LogbookFlightLogPayload, LogbookStageResult, LogbookSuggestion, LogbookSuggestionMeta, MaintenanceEvent, MaintenanceEventEstimation, MaintenanceStatus, Media, MediaCollection, Membership, PaginatedResponse, PermissionItem, Post, PrePaidPackage, Price, Qualification, RecurringFlight, ResolveAirplaneIssueInput, Resource, Role, RoleDetail, RoleListItem, Runway, ScheduledFlight, Setting, SpecialFlight, Tag, Ticket, ToggleFavoriteResponse, UpdateAirplaneIssueInput, UpdateCommentInput, UpdatePostInput, User, UserAircraftRating, UserQualification, Waypoint };
+export type { Activity, Address, AiSuggestedMilestone, AiSuggestion, AiSuggestionStatus, AircraftBlock, AircraftBlockReason, AircraftPosition, AircraftRating, Airplane, AirplaneIssue, AirplaneIssueSeverity, AirplaneIssueStatus, AirplanePermission, AirplaneShareInvite, Airport, Alert, AllowedDocumentType, ApiResponse, ApproachType, Avail, BackgroundTask, BackgroundTaskStatus, BaseMembership, BaseModel, Booking, Comment, Company, ComplianceData, ComplianceGroup, ComplianceGroupSource, ComplianceRequirement, ComplianceRequirementGroup, ComplianceResponse, ComplianceSummary, Course, CourseCheckSyllabus, CourseDescriptionSuggestionPayload, CourseEnrollment, CourseEnrollmentMetrics, CourseFee, CreateAirplaneIssueInput, CreateCommentInput, CreatePostInput, DataWrappedResponse, DeferAirplaneIssueInput, DiscardedRow, Document, DocumentComplianceStatus, DocumentRequirement, DocumentRequirementGroup, DocumentRequirementGroupAssignment, DocumentShare, DocumentType, Event, Expense, ExpenseItem, ExtendedAirplane, Fee, FeeCategoryOptions, FlightLog, GroupedPermissions, Invoice, Landing, LandingFee, LandingFeeImportResult, LandingFeeInvoiceApplyPayload, LandingFeeInvoiceApplyResult, LandingFeeInvoicePreview, LandingFeeInvoicePreviewRow, LandingFeeTemplateParams, LogbookFlightLogPayload, LogbookStageResult, LogbookSuggestion, LogbookSuggestionMeta, MaintenanceEvent, MaintenanceEventEstimation, MaintenanceStatus, Media, MediaCollection, Membership, MembershipSignup, PaginatedResponse, PermissionItem, Post, PrePaidPackage, Price, Qualification, RecurringFlight, ResolveAirplaneIssueInput, Resource, Role, RoleDetail, RoleListItem, Runway, ScheduledFlight, Setting, SpecialFlight, Tag, Ticket, ToggleFavoriteResponse, UpdateAirplaneIssueInput, UpdateCommentInput, UpdatePostInput, User, UserAircraftRating, UserQualification, Waypoint };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@updraft-solutions/mcrit-sdk",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Shared TypeScript types, Zod schemas, and pure helpers for the MCRIT aviation fleet management platform",
   "homepage": "https://github.com/updraft-solutions/mcrit-sdk#readme",
   "bugs": {

package/src/courses/index.ts

@@ -20,12 +20,12 @@ export interface CourseFeeLike extends FeeLike {
     count?: number;
     variant?: string | null;
     is_optional?: boolean;
-    sort_order?: number;
+    sort_order?: number | null;
   };
   count?: number;
   variant?: string | null;
   is_optional?: boolean;
-  sort_order?: number;
+  sort_order?: number | null;
   fee?: FeeLike;
 }
 

package/src/index.ts

@@ -24,6 +24,9 @@ export {
   type MaintenanceEvent,
   type MaintenanceStatus,
   type MaintenanceEventEstimation,
+  type Activity,
+  type MembershipSignup,
+  type AircraftPosition,
   type Avail,
   type Alert,
   type Booking,

package/src/schemas/common.ts

@@ -3,10 +3,13 @@ import { z } from "zod";
 // Shared helpers
 export const zNullableBool = z.boolean().nullable().optional();
 export const zNetGross = z.enum(["net", "gross"]).optional();
+// Mirrors backend ContactData (all members null|string|Optional).
 export const zContactDTO = z.object({
-  name: z.string().optional(),
-  email: z.string().email().optional(),
-  phone: z.string().optional(),
+  name: z.string().nullable().optional(),
+  email: z.string().nullable().optional(),
+  phone: z.string().nullable().optional(),
+  company: z.string().nullable().optional(),
+  fax: z.string().nullable().optional(),
 });
 export const zPhpMoneyObject = z.object({
   amount: z.number(),
@@ -87,8 +90,19 @@ export const userSchema = z.object({
   type: z.literal("user"),
   id: z.number(),
   name: z.string(),
-  email: z.string().optional(),
-  mobile: z.string().optional(),
+  firstname: z.string().nullable().optional(),
+  lastname: z.string().nullable().optional(),
+  // email/mobile are gate-guarded server-side (viewMail/viewMobile) and come
+  // back null when denied.
+  email: z.string().nullable().optional(),
+  mobile: z.string().nullable().optional(),
+  // UserResource media envelope (avatar/header, present when loaded).
+  media: z
+    .object({
+      avatar: mediaSchema.nullable().optional(),
+      header: mediaSchema.nullable().optional(),
+    })
+    .optional(),
   // Present only on the authenticated-user payload while an admin
   // impersonation session is active.
   impersonation: impersonationStateSchema.optional(),
@@ -110,4 +124,21 @@ export const companySchema = z.object({
   // e.g. "ai.logbook_import"). Serialized by CompanyResource alongside
   // `permissions[]`; slim payloads may omit it.
   entitlements: z.array(z.string()).optional(),
+  // BaseCompanyResource extras: cached-minified home airport + the
+  // distance computed on radius-filtered public listings.
+  airport_id: z.number().nullable().optional(),
+  airport: z
+    .object({
+      id: z.number(),
+      ident: z.string(),
+      name: z.string(),
+      municipality: z.string().nullable().optional(),
+      iso_country: z.string().nullable().optional(),
+      latitude_deg: z.number().nullable().optional(),
+      longitude_deg: z.number().nullable().optional(),
+    })
+    .nullable()
+    .optional(),
+  icao: z.string().nullable().optional(),
+  distance_in_km: z.number().optional(),
 });

package/src/schemas/form-template.ts

@@ -179,6 +179,9 @@ export const SignatureSchema = z.object({
   status: z.enum(["pending", "signed", "revoked"]),
   required_signer_membership_id: z.number().nullable(),
   required_signer_name: z.string().nullable().optional(),
+  // Group designation: any member holding this permission at the template's
+  // company may sign (e.g. "formSubmission.signAsCompany").
+  required_signer_permission: z.string().nullable().optional(),
   signed_by_user_id: z.number().nullable(),
   signed_by_membership_id: z.number().nullable(),
   signed_by_name: z.string().nullable().optional(),

package/src/schemas/models.ts

@@ -109,7 +109,7 @@ export const feeSchema = BaseModel.extend({
     .nullable()
     .optional(),
   payment_per: z.string().nullable().optional(),
-  can: z.record(z.string(), zNullableBool).optional(),
+  can: z.record(z.string(), z.boolean().nullable()).optional(),
   course_count: z.number().optional(),
   // feeables-pivot fields, present when the fee is serialized through an
   // attachment (course/enrollment listings).
@@ -202,14 +202,51 @@ export const airplaneSchema = BaseModel.extend({
   defaultFlightType: z.string().optional(),
   defaultFlightRule: z.string().optional(),
   status: z.string().optional(),
-  can: z.object({
-    view: zNullableBool,
-    update: zNullableBool,
-    viewMaintenanceEvents: zNullableBool,
-    createMaintenanceEvents: zNullableBool,
-    createBooking: zNullableBool,
-    createAirplanePermissions: zNullableBool,
-  }),
+  // Physical/capability facts — serialized by BaseAirplaneResource on EVERY
+  // airplane payload (not just the extended show shape).
+  minimumCrewCount: z.number().optional(),
+  classRating: z.string().nullable().optional(),
+  typeRating: z.string().nullable().optional(),
+  VFR: z.boolean().optional(),
+  VFRNight: z.boolean().optional(),
+  IFR: z.boolean().optional(),
+  IFRKnownIcing: z.boolean().optional(),
+  power: z.string().optional(),
+  fuel_type: z.string().optional(),
+  oil_min: z.string().optional(),
+  oil_max: z.string().optional(),
+  oil_type_winter: z.string().optional(),
+  oil_type_summer: z.string().optional(),
+  empty_weight: z.string().optional(),
+  max_takeoff_mass: z.string().optional(),
+  max_speed: z.string().optional(),
+  max_range: z.string().optional(),
+  equipment: z.array(equipmentSchema).optional(),
+  has_pre_paid_package: z.boolean().optional(),
+  logging_required_from: z.string().optional(),
+  fee_id: z.number().nullable().optional(),
+  booking_fee_id: z.number().nullable().optional(),
+  homebase: z
+    .object({
+      id: z.number(),
+      ident: z.string().optional(),
+      name: z.string().optional(),
+    })
+    .nullable()
+    .optional(),
+  // Loose record on purpose: gates are policy-reflected server-side and
+  // grow over time — same convention as companySchema.
+  can: z.record(z.string(), z.boolean().nullable()).optional(),
+});
+
+/**
+ * Latest ADS-B position of the physical aircraft (eager-loaded relation on
+ * the company fleet-map payloads).
+ */
+export const aircraftPositionSchema = z.object({
+  lat: z.number().nullable().optional(),
+  lon: z.number().nullable().optional(),
+  timestamp: z.union([z.string(), z.number()]).nullable().optional(),
 });
 
 export const airplaneShareInviteSchema = z.object({
@@ -350,32 +387,8 @@ export const maintenanceStatusSchema = z.object({
     .optional(),
 });
 
+// AirplaneResource extras on top of the base shape (show payloads, fleet map).
 export const extendedAirplaneSchema = airplaneSchema.extend({
-  manufacturer: z.string().optional(),
-  capacity: z.number().optional(),
-  description: z.string().optional(),
-  homebase_id: z.number().optional(),
-  ato: z.boolean().optional(),
-  year_of_construction: z.string().optional(),
-  span: z.string().optional(),
-  height: z.string().optional(),
-  length: z.string().optional(),
-  empty_weight: z.string().optional(),
-  max_takeoff_mass: z.string().optional(),
-  max_speed: z.string().optional(),
-  max_range: z.string().optional(),
-  power: z.string().optional(),
-  fuel_type: z.string().optional(),
-  oil_min: z.string().optional(),
-  oil_max: z.string().optional(),
-  oil_type_winter: z.string().optional(),
-  oil_type_summer: z.string().optional(),
-  minimumCrewCount: z.number().optional(),
-  VFR: z.boolean().optional(),
-  VFRNight: z.boolean().optional(),
-  IFR: z.boolean().optional(),
-  IFRKnownIcing: z.boolean().optional(),
-  equipment: z.array(equipmentSchema).optional(),
   contact: contactAttributeSchema.optional(),
   hints: z
     .object({
@@ -386,26 +399,16 @@ export const extendedAirplaneSchema = airplaneSchema.extend({
         .optional(),
     })
     .optional(),
-  has_pre_paid_package: z.boolean().optional(),
-  fee_id: z.number().optional(),
-  booking_fee_id: z.number().optional(),
-  logging_required_from: z.string().optional(),
   foreflight_profile_url: z.string().optional(),
-  media: z
-    .object({
-      avatar: z.any().optional(),
-      header: z.any().optional(),
-      images: z.array(z.any()).optional(),
-      documents: z.array(z.any()).optional(),
-    })
-    .optional(),
+  company: companySchema.optional(),
+  latestPosition: aircraftPositionSchema.nullable().optional(),
+  total_flight_time_minutes: z.number().nullable().optional(),
+  elapsed_time: z.number().nullable().optional(),
+  remaining_time: z.number().nullable().optional(),
+  completed_at: z.string().nullable().optional(),
+  flight_log_enabled: z.boolean().optional(),
+  latest_maintenance_event: maintenanceEventSchema.nullable().optional(),
   master_media: mediaCollection.optional(),
-  can: z
-    .object({
-      update: zNullableBool,
-      viewMaintenanceEvents: zNullableBool,
-    })
-    .optional(),
 });
 
 export const availSchema = z.object({
@@ -442,6 +445,26 @@ export const bookingWaypointSchema = z.object({
     .optional(),
 });
 
+/**
+ * Spatie activity-log row (ActivityResource) — audit trail entries loaded on
+ * booking/invoice/event show payloads (`activities` relation).
+ */
+export const activitySchema = z.object({
+  id: z.number(),
+  log_name: z.string().nullable().optional(),
+  description: z.string().optional(),
+  event: z.string().nullable().optional(),
+  subject_type: z.string().nullable().optional(),
+  subject_id: z.number().nullable().optional(),
+  causer_type: z.string().nullable().optional(),
+  causer_id: z.number().nullable().optional(),
+  causer: userSchema.nullable().optional(),
+  properties: z.record(z.string(), z.unknown()).optional(),
+  batch_uuid: z.string().nullable().optional(),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional(),
+});
+
 export const bookingSchema = BaseModel.extend({
   type: z.literal("booking"),
   ifr: z.boolean().default(false),
@@ -494,11 +517,17 @@ export const bookingSchema = BaseModel.extend({
     .optional(),
   contact: zContactDTO.optional(),
   remarks: z.string().optional(),
-  can: z
-    .object({
-      update: zNullableBool,
-    })
-    .optional(),
+  ac_call: z.string().nullable().optional(),
+  ac_type: z.string().nullable().optional(),
+  // Audit trail (BookingResource `activities`, present when eager-loaded).
+  activities: z.array(activitySchema).optional(),
+  // Present when eager-loaded (BookingResource conditional appends). Lazy:
+  // both schemas are declared later in this file; there is no true cycle.
+  flight_logs: z.array(z.lazy(() => flightLogSchema)).optional(),
+  expense_items: z.array(z.lazy(() => expenseItemSchema)).optional(),
+  // Loose record on purpose: gates are policy-reflected server-side and
+  // grow over time — same convention as companySchema.
+  can: z.record(z.string(), z.boolean().nullable()).optional(),
 });
 
 export const alertSchema = z.object({
@@ -711,6 +740,9 @@ export const flightLogSchema = z.object({
   id: z.number(),
   airplane_id: z.number(),
   airplane: airplaneSchema.optional(),
+  // Present when eager-loaded (FlightLogResource, camelCase key). Lazy:
+  // expenseItemSchema is declared later in this file; there is no true cycle.
+  expenseItems: z.array(z.lazy(() => expenseItemSchema)).optional(),
   ac_type: z.string().nullable().optional(),
   ac_reg: z.string().nullable().optional(),
   ac_call: z.string().nullable().optional(),
@@ -799,16 +831,30 @@ export const invoiceSchema = z.object({
   issuer_city: z.string().nullable().optional(),
   issuer_zip: z.string().nullable().optional(),
   issuer_state: z.string().nullable().optional(),
-  created_at: z.string(),
-  updated_at: z.string(),
-  can: z
+  issuer_bank_name: z.string().nullable().optional(),
+  issuer_bic: z.string().nullable().optional(),
+  issuer_iban: z.string().nullable().optional(),
+  issuer_email: z.string().nullable().optional(),
+  issuer_phone: z.string().nullable().optional(),
+  issuer_vat_id: z.string().nullable().optional(),
+  issuer_register_court: z.string().nullable().optional(),
+  issuer_register_number: z.string().nullable().optional(),
+  gross_total: zPhpMoneyObject.nullable().optional(),
+  net_total: zPhpMoneyObject.nullable().optional(),
+  // InvoiceResource media envelope: only the generated PDF.
+  media: z
     .object({
-      update: zNullableBool,
-      delete: zNullableBool,
-      release: zNullableBool,
-      view: zNullableBool,
+      pdf: mediaSchema.nullable().optional(),
     })
     .optional(),
+  pdf: z.string().nullable().optional(),
+  // Audit trail (InvoiceResource `activities`, present when eager-loaded).
+  activities: z.array(activitySchema).optional(),
+  created_at: z.string(),
+  updated_at: z.string(),
+  // Loose record on purpose: gates are policy-reflected server-side and
+  // grow over time — same convention as companySchema.
+  can: z.record(z.string(), z.boolean().nullable()).optional(),
 });
 
 export const scheduledFlightSchema = z.object({
@@ -900,11 +946,19 @@ export const courseSchema = z.object({
   // Present only when the backend eager-loaded `checkSyllabi`.
   check_syllabi: z.array(courseCheckSyllabusSchema).optional(),
   tags: z.array(tagSchema).optional(),
+  // Attached fees (feeables pivot) + fees derived from them, when loaded.
+  fees: z.array(courseFeeSchema).optional(),
+  derived_fees: z.array(feeSchema).optional(),
+  fees_count: z.number().optional(),
+  is_public: z.boolean().optional(),
+  kind: z.string().optional(),
+  version: z.number().optional(),
+  media: mediaCollection,
   created_at: z.string(),
   updated_at: z.string(),
   // Loose record on purpose: gates are policy-reflected server-side and
   // grow over time (useAssistant, …) — same convention as companySchema.
-  can: z.record(z.string(), zNullableBool).optional(),
+  can: z.record(z.string(), z.boolean().nullable()).optional(),
 });
 
 /**
@@ -947,11 +1001,44 @@ export const courseEnrollmentSchema = z.object({
   course: courseSchema.optional(),
   membership: membershipSchema.optional(),
   mentor: userSchema.optional(),
+  // Present when eager-loaded (BaseCourseEnrollmentResource). Lazy: both
+  // schemas are declared later in this file; there is no true cycle.
+  expense_items: z.array(z.lazy(() => expenseItemSchema)).optional(),
+  bookings: z.array(bookingSchema).optional(),
   // Loose record on purpose: gates are policy-reflected server-side and
   // grow over time (updateTraining, manageInitialPayment, …).
-  can: z.record(z.string(), zNullableBool).optional(),
+  can: z.record(z.string(), z.boolean().nullable()).optional(),
+});
+
+/**
+ * Attendee row on an event (MembershipSignupResource — `event.signups`,
+ * present when the relation is eager-loaded).
+ */
+export const membershipSignupSchema = z.object({
+  id: z.number(),
+  membership_id: z.number(),
+  created_at: z.string().optional(),
+  membership: z
+    .object({
+      id: z.number(),
+      user_id: z.number().nullable().optional(),
+      name: z.string(),
+      user: z
+        .object({
+          name: z.string(),
+          firstname: z.string().nullable().optional(),
+          lastname: z.string().nullable().optional(),
+          email: z.string().nullable().optional(),
+        })
+        .nullable()
+        .optional(),
+    })
+    .nullable()
+    .optional(),
 });
 
+// Mirrors EventResource — company events with signups, media, and a contact
+// block; times render in the company timezone (UTC fallback).
 export const eventSchema = z.object({
   type: z.literal("event"),
   id: z.number(),
@@ -959,22 +1046,18 @@ export const eventSchema = z.object({
   company: companySchema.optional(),
   title: z.string(),
   description: z.string().nullable().optional(),
-  start_date: z.string(),
-  end_date: z.string().nullable().optional(),
-  all_day: z.boolean().default(false),
-  location: z.string().nullable().optional(),
-  category: z.string().nullable().optional(),
-  created_by: z.number(),
-  creator: userSchema.optional(),
-  created_at: z.string(),
-  updated_at: z.string(),
-  can: z
-    .object({
-      update: zNullableBool,
-      delete: zNullableBool,
-      attend: zNullableBool,
-    })
-    .optional(),
+  media: mediaCollection,
+  signups: z.array(membershipSignupSchema).optional(),
+  signups_count: z.number().optional(),
+  is_public: z.boolean(),
+  contact: zContactDTO.nullable().optional(),
+  start: z.string(),
+  end: z.string().nullable().optional(),
+  registrationDeadline: z.string().nullable().optional(),
+  registrationIsBinding: z.boolean(),
+  // Loose record on purpose: gates are policy-reflected server-side and
+  // grow over time — same convention as companySchema.
+  can: z.record(z.string(), z.boolean().nullable()).optional(),
 });
 
 export const addressSchema = z.object({

package/src/types/models.ts

@@ -62,6 +62,9 @@ export type MaintenanceEventEstimation = z.infer<
 >;
 
 // Booking types
+export type Activity = z.infer<typeof ModelSchemas.activitySchema>;
+export type MembershipSignup = z.infer<typeof ModelSchemas.membershipSignupSchema>;
+export type AircraftPosition = z.infer<typeof ModelSchemas.aircraftPositionSchema>;
 export type Avail = z.infer<typeof ModelSchemas.availSchema>;
 export type Alert = z.infer<typeof ModelSchemas.alertSchema>;
 export type Booking = z.infer<typeof ModelSchemas.bookingSchema>;