@updraft-solutions/mcrit-sdk 0.4.0 → 0.6.0

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { a as addressSchema, b as aircraftRatingSchema, g as airplaneSchema, f as airplanePermissionSchema, h as airplaneShareInviteSchema, i as airportSchema, j as alertSchema, k as allowedDocumentTypeSchema, l as approachTypeSchema, m as availSchema, n as baseMembershipSchema, o as bookingSchema, q as commentSchema, r as companySchema, x as courseSchema, v as courseEnrollmentSchema, w as courseFeeSchema, D as documentSchema, y as documentComplianceStatus, z as documentRequirement, A as documentRequirementGroup, C as documentRequirementGroupAssignment, E as documentShareSchema, F as documentType, G as eventSchema, I as expenseSchema, H as expenseItemSchema, J as extendedAirplaneSchema, L as flightLogSchema, M as invoiceSchema, O as landingSchema, N as landingFeeSchema, Q as maintenanceEventSchema, P as maintenanceEventEstimationSchema, R as maintenanceStatusSchema, S as mediaCollection, U as membershipSchema, V as postSchema, W as prePaidPackageSchema, X as priceSchema, Y as qualificationSchema, Z as recurringFlightSchema, _ as roleSchema, $ as runwaySchema, a0 as scheduledFlightSchema, a1 as settingSchema, a2 as specialFlightSchema, a4 as ticketSchema, a7 as userSchema, a5 as userAircraftRatingSchema, a6 as userQualificationSchema, a8 as waypointSchema, c as airplaneIssueSchema, d as airplaneIssueSeverityEnum, e as airplaneIssueStatusEnum, B as BaseModel$1, t as courseCheckSyllabusSchema, u as courseEnrollmentMetricsSchema, K as feeSchema, T as mediaSchema, a3 as tagSchema } from '../models-Bc5BKYuI.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>;
@@ -20,12 +20,16 @@ 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>;
@@ -57,6 +61,37 @@ type AirplaneIssueStatus = z.infer<typeof airplaneIssueStatusEnum>;
 type Event = z.infer<typeof eventSchema>;
 type Ticket = z.infer<typeof ticketSchema>;
 type Post = z.infer<typeof postSchema>;
+interface CreatePostInput {
+    title?: string | null;
+    content: string;
+    sticky?: boolean;
+    public?: boolean;
+}
+interface UpdatePostInput {
+    title?: string | null;
+    content: string;
+    sticky?: boolean;
+    public?: boolean;
+}
+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;
@@ -81,7 +116,8 @@ interface DataWrappedResponse<T, M = undefined> {
     data: T;
     meta?: M;
 }
-interface PaginatedResponse<T = any> {
+type ApiResponse<T> = DataWrappedResponse<T>;
+interface PaginatedResponse<T = unknown> {
     data: T[];
     meta: {
         current_page: number;
@@ -109,11 +145,12 @@ interface ToggleFavoriteResponse {
 
 interface ComplianceRequirement {
     requirement_id: number;
-    document_type_class: string;
-    document_type_label: string;
+    form_template_id: number;
+    form_template_name: string;
     logical_group: string;
     is_satisfied: boolean;
-    document: any | null;
+    awaiting_countersignature?: boolean;
+    submission: FormSubmission | null;
 }
 interface ComplianceRequirementGroup {
     group_name: string;
@@ -121,11 +158,22 @@ interface ComplianceRequirementGroup {
     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;
@@ -147,4 +195,228 @@ interface ComplianceResponse {
     };
 }
 
-export type { Address, AircraftRating, Airplane, AirplaneIssue, AirplaneIssueSeverity, AirplaneIssueStatus, AirplanePermission, AirplaneShareInvite, Airport, Alert, AllowedDocumentType, ApproachType, Avail, BaseMembership, BaseModel, Booking, Comment, Company, ComplianceData, ComplianceGroup, ComplianceRequirement, ComplianceRequirementGroup, ComplianceResponse, ComplianceSummary, Course, CourseCheckSyllabus, CourseEnrollment, CourseEnrollmentMetrics, CourseFee, CreateCommentInput, DataWrappedResponse, Document, DocumentComplianceStatus, DocumentRequirement, DocumentRequirementGroup, DocumentRequirementGroupAssignment, DocumentShare, DocumentType, Event, Expense, ExpenseItem, ExtendedAirplane, Fee, FlightLog, Invoice, Landing, LandingFee, MaintenanceEvent, MaintenanceEventEstimation, MaintenanceStatus, Media, MediaCollection, Membership, PaginatedResponse, Post, PrePaidPackage, Price, Qualification, RecurringFlight, Resource, Role, Runway, ScheduledFlight, Setting, SpecialFlight, Tag, Ticket, ToggleFavoriteResponse, UpdateCommentInput, User, UserAircraftRating, UserQualification, Waypoint };
+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;
+}
+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[];
+}
+
+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.js

@@ -1 +1 @@
-import "../chunk-LXNCAKJZ.js";
+import "../chunk-2WJHTRIE.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@updraft-solutions/mcrit-sdk",
-  "version": "0.4.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

@@ -11,6 +11,9 @@ export {
   type AirplanePermission,
   type AirplaneShareInvite,
   type LandingFee,
+  type Fee,
+  type FeeCategoryOptions,
+  type Tag,
   type AircraftRating,
   type UserAircraftRating,
   type UserQualification,
@@ -21,6 +24,9 @@ export {
   type MaintenanceEvent,
   type MaintenanceStatus,
   type MaintenanceEventEstimation,
+  type Activity,
+  type MembershipSignup,
+  type AircraftPosition,
   type Avail,
   type Alert,
   type Booking,
@@ -48,6 +54,12 @@ export {
   type Event,
   type Ticket,
   type Post,
+  type CreatePostInput,
+  type UpdatePostInput,
+  type CreateAirplaneIssueInput,
+  type UpdateAirplaneIssueInput,
+  type ResolveAirplaneIssueInput,
+  type DeferAirplaneIssueInput,
   type Comment,
   type CreateCommentInput,
   type UpdateCommentInput,
@@ -57,6 +69,7 @@ export {
   type Setting,
   // types/api.ts
   type DataWrappedResponse,
+  type ApiResponse,
   type PaginatedResponse,
   type Resource,
   type ToggleFavoriteResponse,
@@ -64,9 +77,38 @@ export {
   type ComplianceRequirement,
   type ComplianceRequirementGroup,
   type ComplianceGroup,
+  type ComplianceGroupSource,
   type ComplianceSummary,
   type ComplianceData,
   type ComplianceResponse,
+  // types/aircraft-block.ts
+  type AircraftBlock,
+  type AircraftBlockReason,
+  // types/background-task.ts
+  type BackgroundTask,
+  type BackgroundTaskStatus,
+  // types/ai.ts
+  type AiSuggestion,
+  type AiSuggestionStatus,
+  type AiSuggestedMilestone,
+  type CourseDescriptionSuggestionPayload,
+  type LogbookFlightLogPayload,
+  type LogbookSuggestionMeta,
+  type LogbookSuggestion,
+  type DiscardedRow,
+  type LogbookStageResult,
+  // types/roles.ts
+  type RoleListItem,
+  type PermissionItem,
+  type RoleDetail,
+  type GroupedPermissions,
+  // types/landing-fee.ts
+  type LandingFeeTemplateParams,
+  type LandingFeeImportResult,
+  type LandingFeeInvoicePreviewRow,
+  type LandingFeeInvoicePreview,
+  type LandingFeeInvoiceApplyPayload,
+  type LandingFeeInvoiceApplyResult,
 } from "./types/index.js";
 
 export * from "./money/index.js";

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(),
@@ -57,12 +60,52 @@ export const mediaCollection = z
   .optional();
 
 // User & Company
+/** Minimal participant shape used in the impersonation payload. */
+export const impersonationParticipantSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  email: z.string(),
+});
+export type ImpersonationParticipant = z.infer<
+  typeof impersonationParticipantSchema
+>;
+
+/**
+ * Impersonation state. Rides along on the authenticated user payload
+ * (`/auth/user` → `user.impersonation`), so it is the single source of
+ * truth — no polling required. The backend's `HandleImpersonation`
+ * middleware also stamps an `X-Impersonating` header on every non-admin
+ * response, which clients use to detect a session that ended server-side.
+ */
+export const impersonationStateSchema = z.object({
+  is_impersonating: z.boolean(),
+  impersonator: impersonationParticipantSchema.optional(),
+  impersonated: impersonationParticipantSchema.optional(),
+  started_at: z.string().optional(),
+  expires_at: z.string().optional(),
+});
+export type ImpersonationState = z.infer<typeof impersonationStateSchema>;
+
 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(),
 });
 
 export const companySchema = z.object({
@@ -77,4 +120,25 @@ export const companySchema = z.object({
   // slim company payloads may omit it.
   timezone: z.string().optional(),
   ai_landing_fee_invoices_enabled: z.boolean().optional(),
+  // Active AI-feature entitlement keys (per-company subscription gating,
+  // 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/course-milestone.ts

@@ -0,0 +1,78 @@
+import { z } from "zod";
+
+export const CourseMilestoneKindEnum = z.enum([
+  "progress",
+  "solo",
+  "cross_country",
+  "theory",
+  "practical",
+  "prerequisite",
+  "custom",
+]);
+export type CourseMilestoneKind = z.infer<typeof CourseMilestoneKindEnum>;
+
+export const courseMilestoneSchema = z.object({
+  type: z.literal("courseMilestone").optional(),
+  id: z.number(),
+  course_id: z.number(),
+  name: z.string(),
+  description: z.string().nullable().optional(),
+  kind: z.string(),
+  is_prerequisite: z.boolean(),
+  requires_form_template_id: z.number().nullable().optional(),
+  required_form_template: z
+    .object({ id: z.number(), name: z.string().optional() })
+    .nullable()
+    .optional(),
+  completion_rule: z.record(z.string(), z.unknown()).nullable().optional(),
+  sort_order: z.number(),
+  created_at: z.string().optional(),
+  updated_at: z.string().optional(),
+  can: z
+    .object({
+      update: z.boolean().nullable().optional(),
+      delete: z.boolean().nullable().optional(),
+    })
+    .optional(),
+});
+export type CourseMilestone = z.infer<typeof courseMilestoneSchema>;
+
+export const CourseMilestoneFormSchema = z.object({
+  name: z.string().min(2).max(191),
+  description: z.string().nullable().optional(),
+  kind: z.string().max(64).default("progress"),
+  is_prerequisite: z.boolean().default(false),
+  requires_form_template_id: z.number().nullable().optional(),
+  completion_rule: z.record(z.string(), z.unknown()).nullable().optional(),
+  sort_order: z.number().int().min(0).optional(),
+});
+export type CourseMilestoneForm = z.infer<typeof CourseMilestoneFormSchema>;
+
+export const courseEnrollmentMilestoneSchema = z.object({
+  type: z.literal("courseEnrollmentMilestone").optional(),
+  id: z.number(),
+  course_enrollment_id: z.number(),
+  course_milestone_id: z.number(),
+  milestone: courseMilestoneSchema.optional(),
+  achieved_at: z.string().nullable().optional(),
+  achieved_by_membership_id: z.number().nullable().optional(),
+  achieved_by: z
+    .object({
+      id: z.number(),
+      user: z.object({ name: z.string().optional() }).optional(),
+    })
+    .nullable()
+    .optional(),
+  notes: z.string().nullable().optional(),
+  is_achieved: z.boolean(),
+  can_be_achieved: z.boolean(),
+  can: z
+    .object({
+      achieve: z.boolean().nullable().optional(),
+      revoke: z.boolean().nullable().optional(),
+    })
+    .optional(),
+});
+export type CourseEnrollmentMilestone = z.infer<
+  typeof courseEnrollmentMilestoneSchema
+>;

package/src/schemas/equipment.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+
+/**
+ * Company-scoped equipment catalog entry (m-crit-api
+ * docs/features/airplane-equipment.md). Assigned to airplanes via the
+ * airplane PATCH `equipment` array.
+ */
+export const equipmentSchema = z.object({
+  type: z.literal("equipment").optional(),
+  id: z.number(),
+  name: z.string(),
+  description: z.string().nullable().optional(),
+  manual_url: z.string().nullable().optional(),
+});
+export type Equipment = z.infer<typeof equipmentSchema>;
+
+/**
+ * Write shape for the airplane PATCH: existing entries carry their id
+ * (description/manual_url on an id entry UPDATE the catalog entry);
+ * id-less entries are created on the fly by name.
+ */
+export interface EquipmentEntry {
+  id?: number;
+  name: string;
+  description?: string | null;
+  manual_url?: string | null;
+}