@updraft-solutions/mcrit-sdk 0.3.1 → 0.4.0

package/src/schemas/models.ts

@@ -265,11 +265,19 @@ export const userQualificationSchema = z.object({
 });
 
 export const airportSchema = z.object({
-  type: z.literal("airport"),
+  // Aligned with what AirportResource actually serializes: `type` and
+  // `country` are absent on minified payloads (e.g. booking waypoint
+  // airports); coordinates + municipality/iso_country ride along on the
+  // full shape.
+  type: z.literal("airport").optional(),
   id: z.number(),
   ident: z.string(),
   name: z.string(),
-  country: z.string(),
+  country: z.string().optional(),
+  municipality: z.string().nullable().optional(),
+  iso_country: z.string().nullable().optional(),
+  latitude_deg: z.number().nullable().optional(),
+  longitude_deg: z.number().nullable().optional(),
 });
 
 export const recurringFlightSchema = z.object({
@@ -387,6 +395,26 @@ export const availSchema = z.object({
     .optional(),
 });
 
+// Ordered via-airport on a booking's route (BookingResource `waypoints`).
+// Airports arrive minified (no `type` literal), hence the dedicated shape.
+// Distinct from the nav-fix `waypointSchema` further down — do not merge.
+export const bookingWaypointSchema = z.object({
+  sequence: z.number(),
+  airport_id: z.number(),
+  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(),
+});
+
 export const bookingSchema = BaseModel.extend({
   type: z.literal("booking"),
   ifr: z.boolean().default(false),
@@ -403,6 +431,15 @@ export const bookingSchema = BaseModel.extend({
   destination_airport_id: z.number().optional(),
   departure_airport: airportSchema.optional(),
   destination_airport: airportSchema.optional(),
+  waypoints: z.array(bookingWaypointSchema).optional(),
+  // Flat, always-present home timezone on BookingResource.
+  company_timezone: z.string().nullable().optional(),
+  // Slim per-booking training-record status, present when the backend
+  // eager-loaded `trainingRecord` (enrollment bookings surfaces).
+  training_record_status: z
+    .enum(["draft", "awaiting_signatures", "signed"])
+    .nullable()
+    .optional(),
   next_booking_id: z.number().nullable().optional(),
   previous_booking_id: z.number().nullable().optional(),
   maintenance: z.number().optional(),
@@ -797,6 +834,24 @@ export const expenseSchema = z.object({
     .optional(),
 });
 
+// Company-scoped tag (shared pool across taggable models — see
+// m-crit-api docs/features/tags.md).
+export const tagSchema = z.object({
+  type: z.literal("tag").optional(),
+  id: z.number(),
+  name: z.string(),
+  color: z.string().nullable().optional(),
+});
+
+// Slim attached progress-check sheet (course_check_syllabi pivot),
+// serialized on course show/update payloads.
+export const courseCheckSyllabusSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  version: z.number(),
+  kind: z.enum(["regular", "progress_check"]).default("regular"),
+});
+
 export const courseSchema = z.object({
   type: z.literal("course"),
   id: z.number(),
@@ -813,15 +868,25 @@ export const courseSchema = z.object({
   aircraft_required: z.boolean().default(false),
   qualification_id: z.number().nullable().optional(),
   qualification: qualificationSchema.optional(),
+  is_archived: z.boolean().optional(),
+  archived_at: z.string().nullable().optional(),
+  category: z.string().nullable().optional(),
+  title: z.string().nullable().optional(),
+  subtitle: z.string().nullable().optional(),
+  content: z.string().nullable().optional(),
+  footer: z.string().nullable().optional(),
+  // Syllabus assignment pointers: `syllabus_id` drives the Übersicht,
+  // `booking_form_syllabus_id` the per-flight Ausbildungsnachweis.
+  syllabus_id: z.number().nullable().optional(),
+  booking_form_syllabus_id: z.number().nullable().optional(),
+  // Present only when the backend eager-loaded `checkSyllabi`.
+  check_syllabi: z.array(courseCheckSyllabusSchema).optional(),
+  tags: z.array(tagSchema).optional(),
   created_at: z.string(),
   updated_at: z.string(),
-  can: z
-    .object({
-      update: zNullableBool,
-      delete: zNullableBool,
-      enroll: zNullableBool,
-    })
-    .optional(),
+  // 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(),
 });
 
 /**
@@ -854,20 +919,19 @@ export const courseEnrollmentSchema = z.object({
   comments: z.string().nullable().optional(),
   initial_payment_generated: z.boolean().optional(),
   initial_payment_removable: z.boolean().optional(),
+  // Element-driven training progress (see m-crit-api
+  // docs/features/training-tracking.md).
+  tracked_training_elements_count: z.number().optional(),
+  progress_source: z.enum(["training_elements", "milestones"]).optional(),
   metrics: courseEnrollmentMetricsSchema.optional(),
   created_at: z.string(),
   updated_at: z.string(),
   course: courseSchema.optional(),
   membership: membershipSchema.optional(),
   mentor: userSchema.optional(),
-  can: z
-    .object({
-      view: zNullableBool,
-      update: zNullableBool,
-      delete: zNullableBool,
-      complete: zNullableBool,
-    })
-    .optional(),
+  // Loose record on purpose: gates are policy-reflected server-side and
+  // grow over time (updateTraining, manageInitialPayment, …).
+  can: z.record(z.string(), zNullableBool).optional(),
 });
 
 export const eventSchema = z.object({

package/src/types/models.ts

@@ -42,6 +42,10 @@ export type RecurringFlight = z.infer<
 // Fee types
 export type Fee = z.infer<typeof ModelSchemas.feeSchema>;
 export type CourseFee = z.infer<typeof ModelSchemas.courseFeeSchema>;
+export type Tag = z.infer<typeof ModelSchemas.tagSchema>;
+export type CourseCheckSyllabus = z.infer<
+  typeof ModelSchemas.courseCheckSyllabusSchema
+>;
 export type Price = z.infer<typeof ModelSchemas.priceSchema>;
 
 // Maintenance types