@voyantjs/suppliers-contracts 0.95.0

package/README.md

@@ -0,0 +1,25 @@
+# @voyantjs/suppliers-contracts
+
+Pure suppliers validation schemas (suppliers, services, rates) and enums,
+zod-only, for consumers (admin SDK, Voyant Connect) that validate supplier
+payloads without the suppliers runtime. `@voyantjs/suppliers` re-exports these
+so existing import paths are unchanged.
+
+## Install
+
+```bash
+pnpm add @voyantjs/suppliers-contracts zod
+```
+
+## Usage
+
+```ts
+import {
+  insertSupplierSchema,
+  selectSupplierSchema,
+  type InsertSupplier,
+} from "@voyantjs/suppliers-contracts"
+```
+
+Existing `@voyantjs/suppliers/validation` imports remain available for
+applications that already depend on the full runtime package.

package/dist/contracts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.test.d.ts.map

package/dist/contracts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.test.d.ts","sourceRoot":"","sources":["../src/contracts.test.ts"],"names":[],"mappings":""}

package/dist/contracts.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { insertRateSchema, insertSupplierSchema } from "./index.js";
+describe("suppliers-contracts", () => {
+    it("accepts a valid supplier and rejects an unknown type", () => {
+        const parsed = insertSupplierSchema.parse({ name: "Acme Tours", type: "guide" });
+        expect(parsed.status).toBe("active");
+        expect(insertSupplierSchema.safeParse({ name: "Acme Tours", type: "spaceship" }).success).toBe(false);
+    });
+    it("accepts a valid rate and rejects a non-3-char currency", () => {
+        const parsed = insertRateSchema.parse({
+            name: "Standard",
+            currency: "EUR",
+            amountCents: 1000,
+            unit: "per_person",
+        });
+        expect(parsed.unit).toBe("per_person");
+        expect(insertRateSchema.safeParse({
+            name: "Standard",
+            currency: "EURO",
+            amountCents: 1000,
+            unit: "per_person",
+        }).success).toBe(false);
+    });
+});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./validation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1 @@
+export * from "./validation.js";

package/dist/validation.d.ts

@@ -0,0 +1,304 @@
+import { z } from "zod";
+export declare const insertSupplierSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        hotel: "hotel";
+        transfer: "transfer";
+        guide: "guide";
+        experience: "experience";
+        airline: "airline";
+        restaurant: "restaurant";
+        other: "other";
+    }>;
+    status: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+        pending: "pending";
+    }>>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    website: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    address: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    city: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    country: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    defaultCurrency: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    primaryFacilityId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contactName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contactEmail: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contactPhone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    paymentTermsDays: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    reservationTimeoutMinutes: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    customerPaymentPolicy: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        deposit: z.ZodObject<{
+            kind: z.ZodEnum<{
+                none: "none";
+                percent: "percent";
+                fixed_cents: "fixed_cents";
+            }>;
+            percent: z.ZodOptional<z.ZodNumber>;
+            amountCents: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        minDaysBeforeDepartureForDeposit: z.ZodNumber;
+        balanceDueDaysBeforeDeparture: z.ZodNumber;
+        balanceDueMinDaysFromNow: z.ZodNumber;
+    }, z.core.$strip>>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const updateSupplierSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        hotel: "hotel";
+        transfer: "transfer";
+        guide: "guide";
+        experience: "experience";
+        airline: "airline";
+        restaurant: "restaurant";
+        other: "other";
+    }>>;
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+        pending: "pending";
+    }>>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    phone: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    website: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    address: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    city: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    country: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    defaultCurrency: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    primaryFacilityId: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    contactName: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    contactEmail: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    contactPhone: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    paymentTermsDays: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodNumber>>>;
+    reservationTimeoutMinutes: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodNumber>>>;
+    customerPaymentPolicy: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        deposit: z.ZodObject<{
+            kind: z.ZodEnum<{
+                none: "none";
+                percent: "percent";
+                fixed_cents: "fixed_cents";
+            }>;
+            percent: z.ZodOptional<z.ZodNumber>;
+            amountCents: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        minDaysBeforeDepartureForDeposit: z.ZodNumber;
+        balanceDueDaysBeforeDeparture: z.ZodNumber;
+        balanceDueMinDaysFromNow: z.ZodNumber;
+    }, z.core.$strip>>>>;
+    tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+export declare const selectSupplierSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        hotel: "hotel";
+        transfer: "transfer";
+        guide: "guide";
+        experience: "experience";
+        airline: "airline";
+        restaurant: "restaurant";
+        other: "other";
+    }>;
+    status: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+        pending: "pending";
+    }>>;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    website: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    address: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    city: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    country: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    defaultCurrency: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    primaryFacilityId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contactName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contactEmail: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    contactPhone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    paymentTermsDays: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    reservationTimeoutMinutes: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    customerPaymentPolicy: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        deposit: z.ZodObject<{
+            kind: z.ZodEnum<{
+                none: "none";
+                percent: "percent";
+                fixed_cents: "fixed_cents";
+            }>;
+            percent: z.ZodOptional<z.ZodNumber>;
+            amountCents: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        minDaysBeforeDepartureForDeposit: z.ZodNumber;
+        balanceDueDaysBeforeDeparture: z.ZodNumber;
+        balanceDueMinDaysFromNow: z.ZodNumber;
+    }, z.core.$strip>>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    id: z.ZodString;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strip>;
+export declare const supplierListSortFieldSchema: z.ZodEnum<{
+    type: "type";
+    name: "name";
+    status: "status";
+    defaultCurrency: "defaultCurrency";
+    createdAt: "createdAt";
+}>;
+export declare const supplierListSortDirSchema: z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+}>;
+export declare const supplierListQuerySchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        hotel: "hotel";
+        transfer: "transfer";
+        guide: "guide";
+        experience: "experience";
+        airline: "airline";
+        restaurant: "restaurant";
+        other: "other";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+        pending: "pending";
+    }>>;
+    primaryFacilityId: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    defaultCurrency: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    sortBy: z.ZodDefault<z.ZodEnum<{
+        type: "type";
+        name: "name";
+        status: "status";
+        defaultCurrency: "defaultCurrency";
+        createdAt: "createdAt";
+    }>>;
+    sortDir: z.ZodDefault<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const supplierAggregatesQuerySchema: z.ZodObject<{
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InsertSupplier = z.infer<typeof insertSupplierSchema>;
+export type UpdateSupplier = z.infer<typeof updateSupplierSchema>;
+export type SelectSupplier = z.infer<typeof selectSupplierSchema>;
+export declare const insertServiceSchema: z.ZodObject<{
+    serviceType: z.ZodEnum<{
+        transfer: "transfer";
+        guide: "guide";
+        experience: "experience";
+        other: "other";
+        accommodation: "accommodation";
+        meal: "meal";
+    }>;
+    facilityId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    duration: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    capacity: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    active: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const updateServiceSchema: z.ZodObject<{
+    serviceType: z.ZodOptional<z.ZodEnum<{
+        transfer: "transfer";
+        guide: "guide";
+        experience: "experience";
+        other: "other";
+        accommodation: "accommodation";
+        meal: "meal";
+    }>>;
+    facilityId: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    duration: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    capacity: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodNumber>>>;
+    active: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+export type InsertService = z.infer<typeof insertServiceSchema>;
+export type UpdateService = z.infer<typeof updateServiceSchema>;
+export declare const insertRateSchema: z.ZodObject<{
+    name: z.ZodString;
+    currency: z.ZodString;
+    amountCents: z.ZodNumber;
+    unit: z.ZodEnum<{
+        per_person: "per_person";
+        per_group: "per_group";
+        per_night: "per_night";
+        per_vehicle: "per_vehicle";
+        flat: "flat";
+    }>;
+    validFrom: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    validTo: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    minPax: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    maxPax: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const updateRateSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    amountCents: z.ZodOptional<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodEnum<{
+        per_person: "per_person";
+        per_group: "per_group";
+        per_night: "per_night";
+        per_vehicle: "per_vehicle";
+        flat: "flat";
+    }>>;
+    validFrom: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    validTo: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    minPax: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodNumber>>>;
+    maxPax: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodNumber>>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+}, z.core.$strip>;
+export type InsertRate = z.infer<typeof insertRateSchema>;
+export type UpdateRate = z.infer<typeof updateRateSchema>;
+export declare const insertSupplierNoteSchema: z.ZodObject<{
+    content: z.ZodString;
+}, z.core.$strip>;
+export declare const insertAvailabilitySchema: z.ZodObject<{
+    date: z.ZodString;
+    available: z.ZodDefault<z.ZodBoolean>;
+    notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export declare const availabilityQuerySchema: z.ZodObject<{
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const insertContractSchema: z.ZodObject<{
+    agreementNumber: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    startDate: z.ZodString;
+    endDate: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    renewalDate: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    terms: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        pending: "pending";
+        expired: "expired";
+        terminated: "terminated";
+    }>>;
+}, z.core.$strip>;
+export declare const updateContractSchema: z.ZodObject<{
+    agreementNumber: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    renewalDate: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    terms: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        pending: "pending";
+        expired: "expired";
+        terminated: "terminated";
+    }>>>;
+}, z.core.$strip>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAoEvB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAqB,CAAA;AACtD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA+B,CAAA;AAChE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;EAMtC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;EAA0B,CAAA;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWlC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAejE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAAoB,CAAA;AACpD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAA8B,CAAA;AAE9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAgB/D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iBAAiB,CAAA;AAC9C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iBAA2B,CAAA;AAExD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AACzD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAIzD,eAAO,MAAM,wBAAwB;;iBAEnC,CAAA;AAIF,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAA;AAeF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAAqB,CAAA;AACtD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAA+B,CAAA"}

package/dist/validation.js

@@ -0,0 +1,144 @@
+import { typeIdSchema } from "@voyantjs/schema-kit/typeid";
+import { z } from "zod";
+const supplierTypeSchema = z.enum([
+    "hotel",
+    "transfer",
+    "guide",
+    "experience",
+    "airline",
+    "restaurant",
+    "other",
+]);
+const supplierStatusSchema = z.enum(["active", "inactive", "pending"]);
+const serviceTypeSchema = z.enum([
+    "accommodation",
+    "transfer",
+    "experience",
+    "guide",
+    "meal",
+    "other",
+]);
+const rateUnitSchema = z.enum(["per_person", "per_group", "per_night", "per_vehicle", "flat"]);
+// ---------- suppliers ----------
+const depositRuleSchema = z.object({
+    kind: z.enum(["none", "percent", "fixed_cents"]),
+    percent: z.number().min(0).max(100).optional(),
+    amountCents: z.number().int().min(0).optional(),
+});
+const customerPaymentPolicySchema = z.object({
+    deposit: depositRuleSchema,
+    minDaysBeforeDepartureForDeposit: z.number().int().min(0),
+    balanceDueDaysBeforeDeparture: z.number().int().min(0),
+    balanceDueMinDaysFromNow: z.number().int().min(0),
+});
+const supplierCoreSchema = z.object({
+    name: z.string().min(1).max(255),
+    type: supplierTypeSchema,
+    status: supplierStatusSchema.default("active"),
+    description: z.string().optional().nullable(),
+    email: z.string().email().optional().nullable(),
+    phone: z.string().optional().nullable(),
+    website: z.string().url().optional().nullable(),
+    address: z.string().optional().nullable(),
+    city: z.string().optional().nullable(),
+    country: z.string().optional().nullable(),
+    defaultCurrency: z.string().max(3).optional().nullable(),
+    primaryFacilityId: z.string().optional().nullable(),
+    contactName: z.string().optional().nullable(),
+    contactEmail: z.string().email().optional().nullable(),
+    contactPhone: z.string().optional().nullable(),
+    paymentTermsDays: z.number().int().positive().optional().nullable(),
+    reservationTimeoutMinutes: z
+        .number()
+        .int()
+        .min(0)
+        .max(24 * 60)
+        .optional()
+        .nullable(),
+    customerPaymentPolicy: customerPaymentPolicySchema.optional().nullable(),
+    tags: z.array(z.string()).default([]),
+});
+export const insertSupplierSchema = supplierCoreSchema;
+export const updateSupplierSchema = supplierCoreSchema.partial();
+export const selectSupplierSchema = supplierCoreSchema.extend({
+    id: typeIdSchema("suppliers"),
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+});
+export const supplierListSortFieldSchema = z.enum([
+    "name",
+    "type",
+    "status",
+    "defaultCurrency",
+    "createdAt",
+]);
+export const supplierListSortDirSchema = z.enum(["asc", "desc"]);
+export const supplierListQuerySchema = z.object({
+    type: supplierTypeSchema.optional(),
+    status: supplierStatusSchema.optional(),
+    primaryFacilityId: z.string().optional(),
+    country: z.string().optional(),
+    defaultCurrency: z.string().optional(),
+    search: z.string().optional(),
+    sortBy: supplierListSortFieldSchema.default("createdAt"),
+    sortDir: supplierListSortDirSchema.default("desc"),
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+    offset: z.coerce.number().int().min(0).default(0),
+});
+export const supplierAggregatesQuerySchema = z.object({
+    from: z.string().datetime().optional(),
+    to: z.string().datetime().optional(),
+});
+// ---------- services ----------
+const serviceCoreSchema = z.object({
+    serviceType: serviceTypeSchema,
+    facilityId: z.string().optional().nullable(),
+    name: z.string().min(1).max(255),
+    description: z.string().optional().nullable(),
+    duration: z.string().optional().nullable(),
+    capacity: z.number().int().positive().optional().nullable(),
+    active: z.boolean().default(true),
+    tags: z.array(z.string()).default([]),
+});
+export const insertServiceSchema = serviceCoreSchema;
+export const updateServiceSchema = serviceCoreSchema.partial();
+// ---------- rates ----------
+const rateCoreSchema = z.object({
+    name: z.string().min(1).max(255),
+    currency: z.string().min(3).max(3),
+    amountCents: z.number().int().min(0),
+    unit: rateUnitSchema,
+    validFrom: z.string().optional().nullable(),
+    validTo: z.string().optional().nullable(),
+    minPax: z.number().int().positive().optional().nullable(),
+    maxPax: z.number().int().positive().optional().nullable(),
+    notes: z.string().optional().nullable(),
+});
+export const insertRateSchema = rateCoreSchema;
+export const updateRateSchema = rateCoreSchema.partial();
+// ---------- notes ----------
+export const insertSupplierNoteSchema = z.object({
+    content: z.string().min(1).max(10000),
+});
+// ---------- availability ----------
+export const insertAvailabilitySchema = z.object({
+    date: z.string().min(1),
+    available: z.boolean().default(true),
+    notes: z.string().optional().nullable(),
+});
+export const availabilityQuerySchema = z.object({
+    from: z.string().optional(),
+    to: z.string().optional(),
+});
+// ---------- contracts ----------
+const supplierContractStatusSchema = z.enum(["active", "expired", "pending", "terminated"]);
+const contractCoreSchema = z.object({
+    agreementNumber: z.string().max(255).optional().nullable(),
+    startDate: z.string().min(1),
+    endDate: z.string().optional().nullable(),
+    renewalDate: z.string().optional().nullable(),
+    terms: z.string().optional().nullable(),
+    status: supplierContractStatusSchema.default("active"),
+});
+export const insertContractSchema = contractCoreSchema;
+export const updateContractSchema = contractCoreSchema.partial();

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@voyantjs/suppliers-contracts",
+  "version": "0.95.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./validation": "./src/validation.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "test": "vitest run --passWithNoTests",
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "prepack": "pnpm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./validation": {
+        "types": "./dist/validation.d.ts",
+        "import": "./dist/validation.js",
+        "default": "./dist/validation.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "dependencies": {
+    "@voyantjs/schema-kit": "workspace:*",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@voyantjs/voyant-typescript-config": "workspace:*",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyantjs/voyant.git",
+    "directory": "packages/suppliers-contracts"
+  }
+}