@updraft-solutions/mcrit-sdk 0.4.0 → 0.5.0

package/src/types/compliance.ts

@@ -1,10 +1,24 @@
+import type { FormSubmission } from "../schemas/form-template";
+
 export 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;
+  // True when the member has already signed the satisfying submission and
+  // only the company's counter-signature is outstanding (e.g. the INflight
+  // Chartervertrag). The requirement is still unsatisfied, but the member
+  // isn't the blocker — consumers refine this into an `awaiting_countersign`
+  // display state.
+  awaiting_countersignature?: boolean;
+  // The submission to display for this requirement: the satisfying (final,
+  // non-expired) one when present, otherwise the latest expired /
+  // awaiting-signatures submission so the UI can explain *why* an unmet
+  // requirement is unmet (abgelaufen / wartet auf Unterschriften) instead of
+  // just "missing". Null only when no relevant submission exists at all.
+  // Satisfaction is decided by `is_satisfied`, never by this field's presence.
+  submission: FormSubmission | null;
 }
 
 export interface ComplianceRequirementGroup {
@@ -14,11 +28,21 @@ export interface ComplianceRequirementGroup {
   requirements: ComplianceRequirement[];
 }
 
+// Where a requirement group's applicability comes from (annotated per group
+// by the backend's HasFormRequirementGroups::getComplianceStatus()):
+// direct assignment, a company role mapping, or a compliance-enforcing
+// airplane the member has access to.
+export type ComplianceGroupSource =
+  | { type: "direct" }
+  | { type: "role"; role: string }
+  | { type: "airplane"; airplane_id: number; registration: string };
+
 export interface ComplianceGroup {
   group_id: number;
   group_name: string;
   overall_satisfied: boolean;
   requirement_groups: ComplianceRequirementGroup[];
+  sources?: ComplianceGroupSource[];
 }
 
 export interface ComplianceSummary {

package/src/types/index.ts

@@ -1,3 +1,8 @@
 export * from "./models";
 export * from "./api";
 export * from "./compliance";
+export * from "./aircraft-block";
+export * from "./background-task";
+export * from "./ai";
+export * from "./roles";
+export * from "./landing-fee";

package/src/types/landing-fee.ts

@@ -0,0 +1,92 @@
+// Landing-fee bulk import (template upload + AI invoice import) contracts.
+
+export interface LandingFeeTemplateParams {
+  landing_type: "FULLSTOP" | "TOUCHANDGO" | "LOWAPPROACH";
+  net_gross: "net" | "gross";
+  valid_from: string; // Y-m-d
+  tax_percentage?: number;
+  approach_type_id?: number;
+}
+
+export 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;
+  };
+}
+
+export 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";
+}
+
+export 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 }>;
+}
+
+export 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;
+  }>;
+}
+
+export interface LandingFeeInvoiceApplyResult {
+  created: number;
+  updated: number;
+  unchanged: number;
+  prices_added: number;
+  issues: string[];
+}

package/src/types/models.ts

@@ -1,6 +1,7 @@
 import type { z } from "zod";
 import type * as Common from "../schemas/common";
 import type * as ModelSchemas from "../schemas/models";
+import type { courseCheckSyllabusSchema } from "../schemas/training";
 
 // Common types
 export type BaseModel = z.infer<typeof Common.BaseModel>;
@@ -42,10 +43,11 @@ 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 FeeCategoryOptions = z.infer<
+  typeof ModelSchemas.feeCategoryOptionsSchema
 >;
+export type Tag = z.infer<typeof ModelSchemas.tagSchema>;
+export type CourseCheckSyllabus = z.infer<typeof courseCheckSyllabusSchema>;
 export type Price = z.infer<typeof ModelSchemas.priceSchema>;
 
 // Maintenance types
@@ -123,6 +125,44 @@ export type AirplaneIssueStatus = z.infer<
 export type Event = z.infer<typeof ModelSchemas.eventSchema>;
 export type Ticket = z.infer<typeof ModelSchemas.ticketSchema>;
 export type Post = z.infer<typeof ModelSchemas.postSchema>;
+
+export interface CreatePostInput {
+  title?: string | null;
+  content: string;
+  sticky?: boolean;
+  public?: boolean;
+}
+
+export interface UpdatePostInput {
+  title?: string | null;
+  content: string;
+  sticky?: boolean;
+  public?: boolean;
+}
+
+export interface CreateAirplaneIssueInput {
+  title?: string | null;
+  body: string;
+  severity?: AirplaneIssueSeverity;
+  ata_chapter?: string | null;
+}
+
+export interface UpdateAirplaneIssueInput {
+  title?: string | null;
+  body?: string;
+  severity?: AirplaneIssueSeverity;
+  ata_chapter?: string | null;
+}
+
+export interface ResolveAirplaneIssueInput {
+  resolution_notes?: string | null;
+}
+
+export interface DeferAirplaneIssueInput {
+  deferred_until?: string | null;
+  deferral_notes?: string | null;
+}
+
 export type Comment = z.infer<typeof ModelSchemas.commentSchema>;
 
 export interface CreateCommentInput {

package/src/types/roles.ts

@@ -0,0 +1,26 @@
+// Roles & permissions admin shapes (company role editor + permission matrix).
+
+export interface RoleListItem {
+  id: number;
+  name: string;
+  description: string | null;
+  is_system: boolean;
+  has_duties: boolean;
+  company_id: number | null;
+  permissions_count: number;
+}
+
+export interface PermissionItem {
+  id: number;
+  name: string;
+  description: string | null;
+  group: string;
+}
+
+export interface RoleDetail extends Omit<RoleListItem, "permissions_count"> {
+  permissions: PermissionItem[];
+}
+
+export interface GroupedPermissions {
+  [group: string]: PermissionItem[];
+}