@updraft-solutions/mcrit-sdk 0.20.5 → 0.21.0

package/src/schemas/models.ts

@@ -162,6 +162,17 @@ export const feeSchema = BaseModel.extend({
   valid_from: z.string(),
 });
 
+export const provisionRuleSchema = z.object({
+  type: z.literal("provisionRule"),
+  id: z.number(),
+  company_id: z.number(),
+  crew_role: z.string(),
+  fee_id: z.number(),
+  fee: feeSchema.optional(),
+  created_at: z.string().nullable().optional(),
+  updated_at: z.string().nullable().optional(),
+});
+
 export const feeCategoryOptionsSchema = z.object({
   categories: z.array(z.string()),
   subcategories: z.record(z.string(), z.array(z.string())),
@@ -964,6 +975,9 @@ export const billingProfileSchema = z.object({
   updated_at: z.string(),
 });
 
+/** Which draft an expense item may join; provision = a company charging its instructors. */
+export const invoiceKindSchema = z.enum(["standard", "provision"]);
+
 export const flightLogSchema = z.object({
   type: z.literal("flightLog"),
   id: z.number(),
@@ -1011,6 +1025,9 @@ export const flightLogSchema = z.object({
   to: z.string().nullable().optional(),
   costs: zMoneyObject.nullable().optional(),
   charge: zMoneyObject.nullable().optional(),
+  // Which invoice kinds among this log's items are released (single payload only;
+  // absent on list rows and on rows cached before the field existed).
+  released_invoice_kinds: z.array(invoiceKindSchema).optional(),
   remarks: z.string().nullable().optional(),
   created_at: z.string(),
   updated_at: z.string(),
@@ -1025,6 +1042,8 @@ export const flightLogSchema = z.object({
 export const invoiceSchema = z.object({
   type: z.literal("invoice"),
   id: z.number(),
+  // Optional: rows cached offline before this field existed must still parse.
+  kind: invoiceKindSchema.optional(),
   title: z.string(),
   membership_id: z.number(),
   // List rows (InvoiceListResource) carry the identity-only membership; the
@@ -1571,6 +1590,7 @@ export const expenseItemSchema = z.object({
   model_id: z.number(),
   model_type: z.string(),
   identifier: z.string().nullable(),
+  kind: invoiceKindSchema.optional(),
   // Provenance: the `prices` row this item was generated from. `price_id` is
   // always present (nullable FK); `price` only when the relation is
   // eager-loaded.

package/src/schemas/provisionRule.spec.ts

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import { expenseItemSchema, flightLogSchema, invoiceSchema, provisionRuleSchema } from "./models";
+
+describe("invoice kinds", () => {
+  it("accepts the two kinds and tolerates a missing kind on cached rows", () => {
+    const base = {
+      type: "invoice",
+      id: 1,
+      title: "INVOICE",
+      membership_id: 2,
+      billing_profile_id: null,
+      created_at: "2026-10-13T10:00:00Z",
+      updated_at: "2026-10-13T10:00:00Z",
+    };
+    expect(invoiceSchema.safeParse({ ...base, kind: "provision" }).success).toBe(true);
+    expect(invoiceSchema.safeParse({ ...base }).success).toBe(true);
+    expect(invoiceSchema.safeParse({ ...base, kind: "other" }).success).toBe(false);
+  });
+
+  it("parses a provision rule with its embedded fee", () => {
+    const parsed = provisionRuleSchema.parse({
+      type: "provisionRule",
+      id: 1,
+      company_id: 3,
+      crew_role: "instructor",
+      fee_id: 9,
+      created_at: "2026-10-13T10:00:00Z",
+      updated_at: "2026-10-13T10:00:00Z",
+    });
+    expect(parsed.crew_role).toBe("instructor");
+  });
+
+  it("carries kind on expense items", () => {
+    const item = expenseItemSchema.shape.kind;
+    expect(item.safeParse("provision").success).toBe(true);
+    expect(item.safeParse(undefined).success).toBe(true);
+  });
+});
+
+describe("flight log released_invoice_kinds", () => {
+  it("accepts kinds and undefined, rejects unknown kinds", () => {
+    const f = flightLogSchema.shape.released_invoice_kinds;
+    expect(f.safeParse(["provision"]).success).toBe(true);
+    expect(f.safeParse(undefined).success).toBe(true);
+    expect(f.safeParse(["other"]).success).toBe(false);
+  });
+});

package/src/types/models.ts

@@ -120,6 +120,8 @@ export type ApproachType = z.infer<typeof ModelSchemas.approachTypeSchema>;
 export type Waypoint = z.infer<typeof ModelSchemas.waypointSchema>;
 
 // Financial Types
+export type InvoiceKind = z.infer<typeof ModelSchemas.invoiceKindSchema>;
+export type ProvisionRule = z.infer<typeof ModelSchemas.provisionRuleSchema>;
 export type Invoice = z.infer<typeof ModelSchemas.invoiceSchema>;
 export type Expense = z.infer<typeof ModelSchemas.expenseSchema>;
 export type ExpenseItem = z.infer<typeof ModelSchemas.expenseItemSchema>;