@updraft-solutions/mcrit-sdk 0.11.2 → 0.12.0

package/dist/types/index.d.cts

@@ -1,5 +1,5 @@
 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, aW as companySchema, b0 as courseSchema, a_ as courseEnrollmentSchema, a$ as courseFeeSchema, aH as airplaneIssueSeverityEnum, b6 as documentSchema, b2 as documentComplianceStatus, b3 as documentRequirement, b4 as documentRequirementGroup, b5 as documentRequirementGroupAssignment, b7 as documentShareSchema, b8 as documentType, ba as eventSchema, bc as expenseSchema, bb as expenseItemSchema, bd as extendedAirplaneSchema, bf as feeSchema, be as feeCategoryOptionsSchema, bg as flightLogSchema, bo as invoiceSchema, bq as landingSchema, bp as landingFeeSchema, bs as maintenanceEventSchema, br as maintenanceEventEstimationSchema, bt as maintenanceStatusSchema, bu as mediaCollection, bw as membershipSchema, bx as membershipSignupSchema, by as postSchema, bz as postSubjectSchema, bB as prePaidPackageSchema, bC as priceSchema, bD as qualificationSchema, bE as recurringFlightSchema, bF as roleSchema, bG as runwaySchema, bH as scheduledFlightSchema, bI as settingSchema, bJ as specialFlightSchema, bQ as tagSchema, bR as ticketSchema, b$ as userSchema, bZ as userAircraftRatingSchema, b_ as userQualificationSchema, c0 as waypointSchema, aG as airplaneIssueSchema, aI as airplaneIssueStatusEnum, B as BaseModel$1, aY as courseCheckSyllabusSchema, aZ as courseEnrollmentMetricsSchema, bv as mediaSchema, l as FormSubmission } from '../training-D3dneyB8.cjs';
+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, bg as feeSchema, bf as feeCategoryOptionsSchema, bh as flightLogSchema, bp as invoiceSchema, br as landingSchema, bq as landingFeeSchema, bt as maintenanceEventSchema, bs as maintenanceEventEstimationSchema, bu as maintenanceStatusSchema, bv as mediaCollection, by as membershipSchema, bz as membershipSignupSchema, bB as postSchema, bC as postSubjectSchema, bE as prePaidPackageSchema, bF as priceSchema, bG as qualificationSchema, bH as recurringFlightSchema, bI as roleSchema, bJ as runwaySchema, bK as scheduledFlightSchema, bL as settingSchema, bM as specialFlightSchema, bT as tagSchema, bU as ticketSchema, c2 as userSchema, c0 as userAircraftRatingSchema, c1 as userQualificationSchema, c3 as waypointSchema, aG as airplaneIssueSchema, aI as airplaneIssueStatusEnum, B as BaseModel$1, aZ as courseCheckSyllabusSchema, a_ as courseEnrollmentMetricsSchema, bw as mediaSchema, l as FormSubmission } from '../training-B5bsRTKy.cjs';
 
 type BaseModel = z.infer<typeof BaseModel$1>;
 type User = z.infer<typeof userSchema>;

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 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, aW as companySchema, b0 as courseSchema, a_ as courseEnrollmentSchema, a$ as courseFeeSchema, aH as airplaneIssueSeverityEnum, b6 as documentSchema, b2 as documentComplianceStatus, b3 as documentRequirement, b4 as documentRequirementGroup, b5 as documentRequirementGroupAssignment, b7 as documentShareSchema, b8 as documentType, ba as eventSchema, bc as expenseSchema, bb as expenseItemSchema, bd as extendedAirplaneSchema, bf as feeSchema, be as feeCategoryOptionsSchema, bg as flightLogSchema, bo as invoiceSchema, bq as landingSchema, bp as landingFeeSchema, bs as maintenanceEventSchema, br as maintenanceEventEstimationSchema, bt as maintenanceStatusSchema, bu as mediaCollection, bw as membershipSchema, bx as membershipSignupSchema, by as postSchema, bz as postSubjectSchema, bB as prePaidPackageSchema, bC as priceSchema, bD as qualificationSchema, bE as recurringFlightSchema, bF as roleSchema, bG as runwaySchema, bH as scheduledFlightSchema, bI as settingSchema, bJ as specialFlightSchema, bQ as tagSchema, bR as ticketSchema, b$ as userSchema, bZ as userAircraftRatingSchema, b_ as userQualificationSchema, c0 as waypointSchema, aG as airplaneIssueSchema, aI as airplaneIssueStatusEnum, B as BaseModel$1, aY as courseCheckSyllabusSchema, aZ as courseEnrollmentMetricsSchema, bv as mediaSchema, l as FormSubmission } from '../training-D3dneyB8.js';
+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, bg as feeSchema, bf as feeCategoryOptionsSchema, bh as flightLogSchema, bp as invoiceSchema, br as landingSchema, bq as landingFeeSchema, bt as maintenanceEventSchema, bs as maintenanceEventEstimationSchema, bu as maintenanceStatusSchema, bv as mediaCollection, by as membershipSchema, bz as membershipSignupSchema, bB as postSchema, bC as postSubjectSchema, bE as prePaidPackageSchema, bF as priceSchema, bG as qualificationSchema, bH as recurringFlightSchema, bI as roleSchema, bJ as runwaySchema, bK as scheduledFlightSchema, bL as settingSchema, bM as specialFlightSchema, bT as tagSchema, bU as ticketSchema, c2 as userSchema, c0 as userAircraftRatingSchema, c1 as userQualificationSchema, c3 as waypointSchema, aG as airplaneIssueSchema, aI as airplaneIssueStatusEnum, B as BaseModel$1, aZ as courseCheckSyllabusSchema, a_ as courseEnrollmentMetricsSchema, bw as mediaSchema, l as FormSubmission } from '../training-B5bsRTKy.js';
 
 type BaseModel = z.infer<typeof BaseModel$1>;
 type User = z.infer<typeof userSchema>;

package/package.json

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

@@ -108,11 +108,34 @@ export const userSchema = z.object({
   impersonation: impersonationStateSchema.optional(),
 });
 
+/**
+ * Identity-only company — the shape a *nested* company gets: enough to name it
+ * and draw its avatar. No `permissions[]`, no `can{}`, no banking details.
+ *
+ * Server: `CompanyIdentityResource`. The authorization-bearing company travels
+ * only where a caller asked for it — `GET /users/{id}/memberships` (mobile's
+ * permission source) and a single-booking payload (a shared aircraft can put a
+ * booking in a partner company, so the client's active company is not the
+ * gate subject).
+ */
+export const companyIdentitySchema = z.object({
+  type: z.literal("company"),
+  id: z.number(),
+  name: z.string(),
+  icao: z.string().nullable().optional(),
+  airport_id: z.number().nullable().optional(),
+  media: mediaCollection,
+});
+
 export const companySchema = z.object({
   type: z.literal("company"),
   id: z.number(),
   name: z.string(),
   media: mediaCollection,
+  // Server-evaluated policy decisions for this instance. Only the gates the
+  // request asked for (`permissions[<model>]=…`, or every gate on a
+  // POST/PATCH) are present — an absent key means "not evaluated", which
+  // callers must treat exactly like an explicit null.
   can: z.record(z.string(), z.boolean().nullable()).optional(),
   permissions: z.array(z.string()).optional(),
   // Company display timezone (companies.timezone, default Europe/Berlin

package/src/schemas/models.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import {
   BaseModel,
+  companyIdentitySchema,
   companySchema,
   contactAttributeSchema,
   mediaCollection,
@@ -14,14 +15,32 @@ import {
 import { equipmentSchema } from "./equipment";
 import { courseCheckSyllabusSchema } from "./training";
 
-export const baseMembershipSchema = z.object({
+/**
+ * Identity-only membership — the shape nested in list rows (server:
+ * `MembershipIdentityResource`). It answers "who is this" and nothing else:
+ * the full nesting carries the company payload, i.e. the requesting user's
+ * whole permission list, repeated on every row.
+ */
+export const membershipIdentitySchema = z.object({
   type: z.literal("membership"),
   id: z.number(),
   user_id: z.number(),
   user: userSchema.optional(),
   company_id: z.number(),
-  company: companySchema.nullable().optional(),
   name: z.string(),
+});
+
+/**
+ * The membership as nested in another model's payload: identity, plus the
+ * identity-only company for the surfaces that list rows across companies
+ * (pre-paid packages, course enrollments).
+ */
+export const nestedMembershipSchema = membershipIdentitySchema.extend({
+  company: companyIdentitySchema.nullable().optional(),
+});
+
+export const baseMembershipSchema = membershipIdentitySchema.extend({
+  company: companyIdentitySchema.nullable().optional(),
   phone: z.string().nullable().optional(),
   status: z.string(),
   instructor: z.boolean(),
@@ -92,7 +111,7 @@ export const feeSchema = BaseModel.extend({
   prices: z.array(priceSchema).optional(),
   provider: z.string().nullable().optional(),
   company_id: z.number().optional(),
-  company: companySchema.optional(),
+  company: companyIdentitySchema.optional(),
   ident: z.string().optional(),
   category: z.string().optional(),
   subcategory: z.string().nullable().optional(),
@@ -273,7 +292,7 @@ export const airplanePermissionSchema = z.object({
   airplane_id: z.number(),
   airplane: airplaneSchema.optional(),
   membership_id: z.number(),
-  membership: baseMembershipSchema.optional(),
+  membership: nestedMembershipSchema.optional(),
   notes: z.string().nullable().optional(),
   conditions: z.string().nullable().optional(),
   expires_at: z.string().nullable().optional(),
@@ -404,7 +423,7 @@ export const extendedAirplaneSchema = airplaneSchema.extend({
     })
     .optional(),
   foreflight_profile_url: z.string().optional(),
-  company: companySchema.optional(),
+  company: companyIdentitySchema.optional(),
   latestPosition: aircraftPositionSchema.nullable().optional(),
   total_flight_time_minutes: z.number().nullable().optional(),
   elapsed_time: z.number().nullable().optional(),
@@ -476,6 +495,9 @@ export const bookingSchema = BaseModel.extend({
   author: userSchema.optional(),
   company_id: z.number(),
   company_name: z.string().nullable().optional(),
+  // Single-booking payloads only (BookingDetailResource): the dialog gates
+  // on this company, which a shared aircraft can make a partner company.
+  // List rows never carry it.
   company: companySchema.optional(),
   airplane: airplaneSchema.optional(),
   etdZ: z.string(),
@@ -494,6 +516,9 @@ export const bookingSchema = BaseModel.extend({
     .enum(["draft", "awaiting_signatures", "signed"])
     .nullable()
     .optional(),
+  // Single-booking payloads only (BookingDetailResource): neighbour lookups
+  // cost two queries per booking and only the dialog's prev/next navigation
+  // uses them.
   next_booking_id: z.number().nullable().optional(),
   previous_booking_id: z.number().nullable().optional(),
   maintenance: z.number().optional(),
@@ -793,7 +818,7 @@ export const flightLogSchema = z.object({
   ac_call: z.string().nullable().optional(),
   booking_id: z.number().nullable().optional(),
   membership_id: z.number().nullable().optional(),
-  membership: baseMembershipSchema.optional(),
+  membership: nestedMembershipSchema.optional(),
   billing_profile_id: z.number().nullable().optional(),
   author_id: z.number(),
   author: userSchema.optional(),
@@ -843,7 +868,10 @@ export const invoiceSchema = z.object({
   id: z.number(),
   title: z.string(),
   membership_id: z.number(),
-  membership: baseMembershipSchema.optional(),
+  // List rows (InvoiceListResource) carry the identity-only membership; the
+  // single-invoice payload carries the full one. Typed as the identity shape —
+  // the guaranteed part — with the rest passed through.
+  membership: nestedMembershipSchema.optional(),
   // InvoiceResource always emits `billing_profile_id` (non-optional key,
   // nullable FK value). `billingProfile` is a `whenLoaded('billingProfile')`
   // relation, so it stays optional. (Fix round 1: as of the original Task 16
@@ -854,7 +882,12 @@ export const invoiceSchema = z.object({
   billingProfile: billingProfileSchema.optional(),
   company_id: z.number().optional(),
   company: companySchema.optional(),
+  // Numbering: invoices are numbered in `sequence_number`, receipts in
+  // `receipt_number`. `document_number` is whichever applies — render that.
+  document_type: z.string().nullable().optional(),
   sequence_number: z.string().nullable().optional(),
+  receipt_number: z.string().nullable().optional(),
+  document_number: z.string().nullable().optional(),
   order_number: z.string().nullable().optional(),
   invoice_date: z.string().nullable().optional(),
   due_date: z.string().nullable().optional(),
@@ -1054,7 +1087,7 @@ export const courseEnrollmentSchema = z.object({
   created_at: z.string(),
   updated_at: z.string(),
   course: courseSchema.optional(),
-  membership: membershipSchema.optional(),
+  membership: nestedMembershipSchema.optional(),
   mentor: userSchema.optional(),
   // Present when eager-loaded (BaseCourseEnrollmentResource). Lazy: both
   // schemas are declared later in this file; there is no true cycle.
@@ -1098,7 +1131,7 @@ export const eventSchema = z.object({
   type: z.literal("event"),
   id: z.number(),
   company_id: z.number(),
-  company: companySchema.optional(),
+  company: companyIdentitySchema.optional(),
   title: z.string(),
   description: z.string().nullable().optional(),
   media: mediaCollection,
@@ -1427,7 +1460,7 @@ export const expenseItemSchema = z.object({
   // maximum length"). No true cycle: invoiceSchema does not reference
   // expenseItemSchema back.
   invoice: z.lazy((): z.ZodTypeAny => invoiceSchema).optional(),
-  membership: baseMembershipSchema.optional(),
+  membership: nestedMembershipSchema.optional(),
   prePaidPackageAssignments: z
     .array(prePaidPackageAssignmentSchema)
     .optional(),