@voyantjs/travel-composer 0.55.0

package/dist/validation.js

@@ -0,0 +1,226 @@
+import { z } from "zod";
+export const tripEnvelopeStatusSchema = z.enum([
+    "draft",
+    "priced",
+    "reserve_in_progress",
+    "reserved",
+    "checkout_started",
+    "booked",
+    "failed",
+    "cancelled",
+]);
+export const tripComponentKindSchema = z.enum([
+    "catalog_booking",
+    "manual_placeholder",
+    "flight_placeholder",
+    "flight_order",
+    "external_order",
+]);
+export const tripComponentStatusSchema = z.enum([
+    "draft",
+    "priced",
+    "unavailable",
+    "held",
+    "booked",
+    "checkout_started",
+    "failed",
+    "cancelled",
+    "removed",
+]);
+export const tripComponentEventTypeSchema = z.enum([
+    "created",
+    "updated",
+    "priced",
+    "hold_placed",
+    "booked",
+    "checkout_started",
+    "failed",
+    "cancelled",
+    "removed",
+    "staff_remediation_required",
+]);
+export const tripComponentTaxLineSchema = z.object({
+    code: z.string().min(1),
+    label: z.string().min(1),
+    amountCents: z.number().int(),
+    baseAmountCents: z.number().int(),
+    rate: z.number().nonnegative().optional(),
+    jurisdiction: z.string().min(1).optional(),
+    includedInPrice: z.boolean().optional(),
+    source: z.string().min(1).optional(),
+});
+export const tripComponentPricingSnapshotSchema = z.object({
+    currency: z.string().length(3),
+    subtotalAmountCents: z.number().int(),
+    taxAmountCents: z.number().int(),
+    totalAmountCents: z.number().int(),
+    priceExpiresAt: z.string().datetime().optional(),
+    warnings: z.array(z.string()).optional(),
+});
+export const tripEnvelopePricingSnapshotSchema = z.object({
+    currency: z.string().length(3),
+    subtotalAmountCents: z.number().int(),
+    taxAmountCents: z.number().int(),
+    totalAmountCents: z.number().int(),
+    componentCount: z.number().int().nonnegative(),
+    pricedComponentCount: z.number().int().nonnegative(),
+    warnings: z.array(z.string()).optional(),
+});
+export const catalogComponentReferenceSchema = z.object({
+    entityModule: z.string().min(1),
+    entityId: z.string().min(1),
+    sourceKind: z.string().min(1),
+    sourceConnectionId: z.string().min(1).optional(),
+    sourceRef: z.string().min(1).optional(),
+});
+export const committedComponentReferenceSchema = z.object({
+    bookingId: z.string().min(1).optional(),
+    bookingGroupId: z.string().min(1).optional(),
+    orderId: z.string().min(1).optional(),
+    paymentSessionId: z.string().min(1).optional(),
+    providerRef: z.string().min(1).optional(),
+    supplierRef: z.string().min(1).optional(),
+});
+export const createTripEnvelopeSchema = z.object({
+    title: z.string().min(1).max(255).optional(),
+    description: z.string().optional(),
+    travelerParty: z.record(z.string(), z.unknown()).default({}),
+    constraints: z.record(z.string(), z.unknown()).default({}),
+    createdBy: z.string().min(1).optional(),
+});
+export const tripsListSortFieldSchema = z.enum(["updatedAt", "createdAt", "status", "total"]);
+export const tripsListSortDirSchema = z.enum(["asc", "desc"]);
+export const listTripsQuerySchema = z.object({
+    status: tripEnvelopeStatusSchema.optional(),
+    search: z.string().trim().min(1).max(255).optional(),
+    // Component-driven filters. Match trips that contain *at least one*
+    // non-removed component referencing the given entity / vertical.
+    productId: z.string().trim().min(1).max(255).optional(),
+    hospitalityId: z.string().trim().min(1).max(255).optional(),
+    cruiseId: z.string().trim().min(1).max(255).optional(),
+    hasFlight: z.coerce.boolean().optional(),
+    // Envelope-level numeric / temporal filters.
+    totalMinCents: z.coerce.number().int().nonnegative().optional(),
+    totalMaxCents: z.coerce.number().int().nonnegative().optional(),
+    createdFrom: z.string().trim().min(1).max(35).optional(),
+    createdTo: z.string().trim().min(1).max(35).optional(),
+    sortBy: tripsListSortFieldSchema.default("updatedAt"),
+    sortDir: tripsListSortDirSchema.default("desc"),
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+    offset: z.coerce.number().int().min(0).default(0),
+});
+export const updateTripEnvelopeSchema = z.object({
+    title: z.string().min(1).max(255).nullable().optional(),
+    description: z.string().nullable().optional(),
+    travelerParty: z.record(z.string(), z.unknown()).optional(),
+    constraints: z.record(z.string(), z.unknown()).optional(),
+    status: tripEnvelopeStatusSchema.optional(),
+    updatedBy: z.string().min(1).nullable().optional(),
+});
+const createTripComponentBaseSchema = z
+    .object({
+    envelopeId: z.string().min(1),
+    sequence: z.number().int().min(0).default(0),
+    kind: tripComponentKindSchema,
+    description: z.string().optional(),
+    catalogRef: catalogComponentReferenceSchema.optional(),
+    estimatedPricing: tripComponentPricingSnapshotSchema.optional(),
+    metadata: z.record(z.string(), z.unknown()).default({}),
+})
+    .strict();
+const createTripComponentBodyBaseSchema = createTripComponentBaseSchema.omit({ envelopeId: true });
+function requireManualServiceName(component, ctx) {
+    const metadata = component.metadata;
+    if (component.kind !== "manual_placeholder" || metadata.template !== "manual")
+        return;
+    const name = metadata.manualService?.name;
+    if (typeof name !== "string" || name.trim().length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["metadata", "manualService", "name"],
+            message: "Manual services require metadata.manualService.name",
+        });
+    }
+}
+export const createTripComponentSchema = createTripComponentBaseSchema.superRefine(requireManualServiceName);
+export const createTripComponentBodySchema = createTripComponentBodyBaseSchema.superRefine(requireManualServiceName);
+export const updateTripComponentSchema = z.object({
+    sequence: z.number().int().min(0).optional(),
+    status: tripComponentStatusSchema.optional(),
+    description: z.string().nullable().optional(),
+    catalogRef: catalogComponentReferenceSchema.nullable().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    warningCodes: z.array(z.string().min(1)).optional(),
+});
+export const reorderTripComponentsSchema = z.object({
+    envelopeId: z.string().min(1),
+    componentIds: z.array(z.string().min(1)).min(1),
+});
+export const updateTripComponentRefsSchema = z.object({
+    bookingDraftId: z.string().min(1).optional(),
+    catalogQuoteId: z.string().min(1).optional(),
+    committedRef: committedComponentReferenceSchema.optional(),
+});
+export const priceTripSchema = z.object({
+    envelopeId: z.string().min(1),
+    scope: z.object({
+        locale: z.string().min(1),
+        audience: z.enum(["staff", "customer", "partner", "supplier"]),
+        market: z.string().min(1),
+        currency: z.string().length(3).optional(),
+    }),
+    ttlMs: z.number().int().positive().optional(),
+});
+export const reserveTripSchema = z.object({
+    envelopeId: z.string().min(1),
+    idempotencyKey: z.string().min(1).max(255).optional(),
+    refreshScope: priceTripSchema.shape.scope.optional(),
+});
+export const startTripCheckoutSchema = z.object({
+    envelopeId: z.string().min(1),
+    idempotencyKey: z.string().min(1).max(255).optional(),
+    intent: z.enum(["card", "bank_transfer", "hold", "inquiry"]).default("card"),
+    request: z.record(z.string(), z.unknown()).default({}),
+});
+export const previewTripCancellationSchema = z.object({
+    envelopeId: z.string().min(1),
+    componentIds: z.array(z.string().min(1)).min(1).optional(),
+    reason: z.string().min(1).max(500).optional(),
+    requestedAt: z.string().datetime().optional(),
+    request: z.record(z.string(), z.unknown()).default({}),
+});
+export const cancelTripComponentsSchema = previewTripCancellationSchema.extend({
+    idempotencyKey: z.string().min(1).max(255).optional(),
+});
+const allowedTripComponentStatusTransitions = {
+    draft: ["priced", "unavailable", "failed", "cancelled", "removed"],
+    priced: ["priced", "unavailable", "held", "booked", "failed", "cancelled", "removed"],
+    unavailable: ["draft", "priced", "failed", "cancelled", "removed"],
+    held: ["booked", "checkout_started", "failed", "cancelled"],
+    booked: ["checkout_started", "cancelled"],
+    checkout_started: ["booked", "failed", "cancelled"],
+    failed: ["draft", "priced", "removed"],
+    cancelled: [],
+    removed: [],
+};
+export function isAllowedTripComponentStatusTransition(from, to) {
+    return (from === to ||
+        allowedTripComponentStatusTransitions[from].includes(to));
+}
+export const tripComponentStatusTransitionSchema = z
+    .object({
+    from: tripComponentStatusSchema,
+    to: tripComponentStatusSchema,
+})
+    .refine(({ from, to }) => isAllowedTripComponentStatusTransition(from, to), {
+    message: "Invalid trip component status transition",
+    path: ["to"],
+});
+export function isTerminalTripComponentStatus(status) {
+    return status === "cancelled" || status === "removed";
+}
+export const travelComposerStatusSchema = z.object({
+    module: z.literal("travel-composer"),
+    status: z.literal("scaffolded"),
+});
+export const travelComposerHealthCheckSchema = travelComposerStatusSchema;

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@voyantjs/travel-composer",
+  "version": "0.55.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./schema": "./src/schema.ts",
+    "./validation": "./src/validation.ts",
+    "./service": "./src/service.ts",
+    "./mcp-tools": "./src/mcp-tools.ts",
+    "./cruise-extension": "./src/cruise-extension.ts",
+    "./routes": "./src/routes.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/ tests/",
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "prepack": "pnpm run build"
+  },
+  "dependencies": {
+    "@voyantjs/core": "workspace:*",
+    "@voyantjs/catalog": "workspace:*",
+    "@voyantjs/catalog-mcp": "workspace:*",
+    "@voyantjs/db": "workspace:*",
+    "@voyantjs/hono": "workspace:*",
+    "drizzle-orm": "^0.45.2",
+    "hono": "^4.12.10",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@voyantjs/voyant-typescript-config": "workspace:*",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./schema": {
+        "types": "./dist/schema.d.ts",
+        "import": "./dist/schema.js",
+        "default": "./dist/schema.js"
+      },
+      "./validation": {
+        "types": "./dist/validation.d.ts",
+        "import": "./dist/validation.js",
+        "default": "./dist/validation.js"
+      },
+      "./service": {
+        "types": "./dist/service.d.ts",
+        "import": "./dist/service.js",
+        "default": "./dist/service.js"
+      },
+      "./mcp-tools": {
+        "types": "./dist/mcp-tools.d.ts",
+        "import": "./dist/mcp-tools.js",
+        "default": "./dist/mcp-tools.js"
+      },
+      "./cruise-extension": {
+        "types": "./dist/cruise-extension.d.ts",
+        "import": "./dist/cruise-extension.js",
+        "default": "./dist/cruise-extension.js"
+      },
+      "./routes": {
+        "types": "./dist/routes.d.ts",
+        "import": "./dist/routes.js",
+        "default": "./dist/routes.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyantjs/voyant.git",
+    "directory": "packages/travel-composer"
+  }
+}