@voyant-travel/charters 0.117.2

package/dist/service-content.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Charter content service — `getCharterContent` with locale-resolved
+ * cache reads, SWR refresh, and synthesizer fallback.
+ *
+ * Mirrors `service-content.ts` in the products / cruises / accommodations
+ * packages but charter-shaped. The charter content aggregate (§3.2 /
+ * §3.6) is `{ charter, yacht, voyages[], suites[], schedule_days[],
+ * policies[] }` — one payload returned by a single getContent.
+ * Pricing stays out (volatile-live, flows through `liveResolve`).
+ */
+import { type ContentLocaleResolution, type InvalidateOnDrift, type SourceAdapter, type SourceAdapterContext } from "@voyant-travel/catalog";
+import type { SourceAdapterRegistry } from "@voyant-travel/catalog/booking-engine";
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import { type CharterContent } from "./content-shape.js";
+export interface CharterContentScope {
+    preferredLocales: ReadonlyArray<string>;
+    market?: string;
+    currency?: string;
+    acceptMachineTranslated?: boolean;
+}
+export interface GetCharterContentOptions {
+    registry: SourceAdapterRegistry;
+    buildAdapterContext?: (adapter: SourceAdapter) => SourceAdapterContext;
+    onOverlayError?: (event: {
+        field_path: string;
+        reason: string;
+    }) => void;
+}
+export interface ResolvedCharterContent {
+    content: CharterContent;
+    resolution: ContentLocaleResolution<{
+        locale: string;
+        payload: CharterContent;
+    }>;
+    source: "sourced-cache" | "sourced-fresh" | "synthesized";
+    served_stale: boolean;
+    synthesized: boolean;
+    machine_translated: boolean;
+}
+export declare function getCharterContent(db: AnyDrizzleDb, entityId: string, scope: CharterContentScope, options: GetCharterContentOptions): Promise<ResolvedCharterContent | null>;
+/** Drift event consumer for the charters content cache. Per §3.4.1. */
+export declare const invalidateCharterContentOnDrift: InvalidateOnDrift;
+//# sourceMappingURL=service-content.d.ts.map

package/dist/service-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-content.d.ts","sourceRoot":"","sources":["../src/service-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAK5B,KAAK,iBAAiB,EAKtB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,EAEL,KAAK,cAAc,EAIpB,MAAM,oBAAoB,CAAA;AAc3B,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,oBAAoB,CAAA;IACtE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACzE;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,cAAc,CAAA;IACvB,UAAU,EAAE,uBAAuB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC,CAAA;IAChF,MAAM,EAAE,eAAe,GAAG,eAAe,GAAG,aAAa,CAAA;IACzD,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA0FxC;AA2ND,uEAAuE;AACvE,eAAO,MAAM,+BAA+B,EAAE,iBAG7C,CAAA"}

package/dist/service-content.js

@@ -0,0 +1,248 @@
+/**
+ * Charter content service — `getCharterContent` with locale-resolved
+ * cache reads, SWR refresh, and synthesizer fallback.
+ *
+ * Mirrors `service-content.ts` in the products / cruises / accommodations
+ * packages but charter-shaped. The charter content aggregate (§3.2 /
+ * §3.6) is `{ charter, yacht, voyages[], suites[], schedule_days[],
+ * policies[] }` — one payload returned by a single getContent.
+ * Pricing stays out (volatile-live, flows through `liveResolve`).
+ */
+import { createInvalidateOnDrift, fetchOverlaysForEntity, isStale, pickBestCachedLocale, readSourcedEntry, withContentRefreshLock, } from "@voyant-travel/catalog";
+import { and, eq } from "drizzle-orm";
+import { CHARTERS_CONTENT_SCHEMA_VERSION, charterContentSchema, mergeOverlaysIntoCharterContent, validateCharterContent, } from "./content-shape.js";
+import { CHARTERS_CONTENT_MARKET_ANY, chartersSourcedContentTable, } from "./schema-sourced-content.js";
+import { synthesizeCharterContent, } from "./service-content-synthesizer.js";
+/** Charters cache TTL is 24h — same as products / cruises. */
+const CHARTERS_DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+export async function getCharterContent(db, entityId, scope, options) {
+    const sourcedEntry = await readSourcedEntry(db, "charters", entityId);
+    if (!sourcedEntry)
+        return null;
+    const provenance = {
+        kind: "sourced",
+        provenance: {
+            source_kind: sourcedEntry.source_kind,
+            source_provider: sourcedEntry.source_provider ?? undefined,
+            source_connection_id: sourcedEntry.source_connection_id ?? undefined,
+            source_ref: sourcedEntry.source_ref ?? undefined,
+            source_freshness: sourcedEntry.source_freshness,
+            last_sourced_at: sourcedEntry.last_sourced_at ?? undefined,
+        },
+        entry_id: sourcedEntry.id,
+        status: sourcedEntry.status,
+        projection: sourcedEntry.projection,
+        projection_etag: sourcedEntry.projection_etag,
+        projection_seen_at: sourcedEntry.projection_seen_at,
+        first_seen_at: sourcedEntry.first_seen_at,
+        last_seen_at: sourcedEntry.last_seen_at,
+    };
+    const adapter = sourcedEntry.source_connection_id
+        ? (options.registry.resolveByConnection(sourcedEntry.source_connection_id) ??
+            options.registry.byKind(sourcedEntry.source_kind)[0]?.adapter)
+        : options.registry.byKind(sourcedEntry.source_kind)[0]?.adapter;
+    const adapterCtx = options.buildAdapterContext?.(adapter) ?? {
+        connection_id: sourcedEntry.source_connection_id ?? sourcedEntry.source_kind,
+    };
+    const market = scope.market ?? CHARTERS_CONTENT_MARKET_ANY;
+    const acceptMT = scope.acceptMachineTranslated ?? true;
+    const cachedRows = await fetchCacheCandidates(db, entityId, market);
+    const eligibleRows = acceptMT ? cachedRows : cachedRows.filter((r) => !r.machine_translated);
+    const best = pickBestCachedLocale(eligibleRows.map((row) => ({ ...row, locale: row.locale })), scope.preferredLocales);
+    if (best && !isStale(best.candidate)) {
+        return finalizeFromCache(db, entityId, best, false, options);
+    }
+    if (best && isStale(best.candidate)) {
+        if (adapter?.getContent) {
+            void scheduleRefresh(db, adapter, adapterCtx, {
+                entity_module: "charters",
+                entity_id: entityId,
+                locale: scope.preferredLocales[0] ?? best.candidate.locale,
+                market,
+                currency: scope.currency,
+            });
+        }
+        return finalizeFromCache(db, entityId, best, true, options);
+    }
+    if (!adapter?.getContent) {
+        const overlays = await fetchOverlaysForEntity(db, "charters", entityId);
+        const synthesized = synthesizeCharterContent({ locale: scope.preferredLocales[0] ?? "en-GB" }, {
+            provenance,
+            overlays: overlays.map((o) => ({ field_path: o.field_path, value: o.value })),
+        });
+        return wrapSynthesized(synthesized, scope, false);
+    }
+    const fresh = await fetchFreshContent(db, adapter, adapterCtx, {
+        entity_module: "charters",
+        entity_id: entityId,
+        locale: scope.preferredLocales[0] ?? "en-GB",
+        market,
+        currency: scope.currency,
+    });
+    if (!fresh) {
+        const overlays = await fetchOverlaysForEntity(db, "charters", entityId);
+        const synthesized = synthesizeCharterContent({ locale: scope.preferredLocales[0] ?? "en-GB" }, {
+            provenance,
+            overlays: overlays.map((o) => ({ field_path: o.field_path, value: o.value })),
+        });
+        return wrapSynthesized(synthesized, scope, false);
+    }
+    return finalizeFresh(db, entityId, fresh, scope, options);
+}
+async function fetchCacheCandidates(db, entityId, market) {
+    return db
+        .select()
+        .from(chartersSourcedContentTable)
+        .where(and(eq(chartersSourcedContentTable.entity_id, entityId), eq(chartersSourcedContentTable.market, market), eq(chartersSourcedContentTable.content_schema_version, CHARTERS_CONTENT_SCHEMA_VERSION)));
+}
+async function fetchFreshContent(db, adapter, ctx, request) {
+    const result = await withContentRefreshLock(db, {
+        entityModule: request.entity_module,
+        entityId: request.entity_id,
+        locale: request.locale,
+        market: request.market,
+    }, async () => {
+        const got = await adapter.getContent(ctx, request);
+        const validation = validateCharterContent(got.content);
+        if (!validation.valid) {
+            throw new Error(`charters getContent for ${request.entity_id} failed validation: ${validation.reason}`);
+        }
+        await writeCacheRow(db, request, got);
+        return got;
+    });
+    return result ?? null;
+}
+function scheduleRefresh(db, adapter, ctx, request) {
+    void withContentRefreshLock(db, {
+        entityModule: request.entity_module,
+        entityId: request.entity_id,
+        locale: request.locale,
+        market: request.market,
+    }, async () => {
+        const got = await adapter.getContent(ctx, request);
+        const validation = validateCharterContent(got.content);
+        if (!validation.valid)
+            return;
+        await writeCacheRow(db, request, got);
+    }).catch(() => {
+        // intentional swallow — see §3.4 SWR refresh contract
+    });
+}
+async function writeCacheRow(db, request, result) {
+    const market = request.market ?? CHARTERS_CONTENT_MARKET_ANY;
+    const now = new Date();
+    // Coerce JSON-string dates to Date — see products writeCacheRow.
+    const sourceUpdatedAt = toDateOrNull(result.source_updated_at);
+    const freshUntil = toDateOrNull(result.fresh_until) ?? new Date(now.getTime() + CHARTERS_DEFAULT_TTL_MS);
+    await db
+        .insert(chartersSourcedContentTable)
+        .values({
+        entity_id: request.entity_id,
+        locale: request.locale,
+        market,
+        payload: result.content,
+        content_schema_version: result.content_schema_version,
+        returned_locale: result.returned_locale,
+        machine_translated: result.machine_translated ?? false,
+        source_updated_at: sourceUpdatedAt,
+        fetched_at: now,
+        fresh_until: freshUntil,
+        etag: result.etag ?? null,
+        fetch_status: "ok",
+        fetch_error: null,
+    })
+        .onConflictDoUpdate({
+        target: [
+            chartersSourcedContentTable.entity_id,
+            chartersSourcedContentTable.locale,
+            chartersSourcedContentTable.market,
+        ],
+        set: {
+            payload: result.content,
+            content_schema_version: result.content_schema_version,
+            returned_locale: result.returned_locale,
+            machine_translated: result.machine_translated ?? false,
+            source_updated_at: sourceUpdatedAt,
+            fetched_at: now,
+            fresh_until: freshUntil,
+            etag: result.etag ?? null,
+            fetch_status: "ok",
+            fetch_error: null,
+        },
+    });
+}
+async function finalizeFromCache(db, entityId, best, servedStale, options) {
+    const validation = validateCharterContent(best.candidate.payload);
+    if (!validation.valid) {
+        throw new Error(`charters cache row for ${entityId} (${best.candidate.locale}) failed validation: ${validation.reason}`);
+    }
+    const overlays = await fetchOverlaysForEntity(db, "charters", entityId);
+    const merged = mergeOverlaysIntoCharterContent(validation.content, overlays.map((o) => ({ field_path: o.field_path, value: o.value })), {
+        onOverlayError: options.onOverlayError
+            ? (e) => options.onOverlayError({
+                field_path: e.overlay.field_path,
+                reason: e.reason,
+            })
+            : undefined,
+    });
+    return {
+        content: merged,
+        resolution: {
+            candidate: { locale: best.candidate.locale, payload: merged },
+            served_locale: best.candidate.returned_locale,
+            match_kind: best.match_kind,
+        },
+        source: "sourced-cache",
+        served_stale: servedStale,
+        synthesized: false,
+        machine_translated: best.candidate.machine_translated,
+    };
+}
+async function finalizeFresh(db, entityId, fresh, scope, options) {
+    const cachedContent = charterContentSchema.parse(fresh.content);
+    const overlays = await fetchOverlaysForEntity(db, "charters", entityId);
+    const merged = mergeOverlaysIntoCharterContent(cachedContent, overlays.map((o) => ({ field_path: o.field_path, value: o.value })), {
+        onOverlayError: options.onOverlayError
+            ? (e) => options.onOverlayError({
+                field_path: e.overlay.field_path,
+                reason: e.reason,
+            })
+            : undefined,
+    });
+    return {
+        content: merged,
+        resolution: {
+            candidate: { locale: scope.preferredLocales[0] ?? fresh.returned_locale, payload: merged },
+            served_locale: fresh.returned_locale,
+            match_kind: scope.preferredLocales[0] === fresh.returned_locale ? "exact" : "language_match",
+        },
+        source: "sourced-fresh",
+        served_stale: false,
+        synthesized: false,
+        machine_translated: fresh.machine_translated ?? false,
+    };
+}
+function wrapSynthesized(synthesized, scope, servedStale) {
+    return {
+        content: synthesized.content,
+        resolution: {
+            candidate: { locale: synthesized.served_locale, payload: synthesized.content },
+            served_locale: synthesized.served_locale,
+            match_kind: scope.preferredLocales[0] === synthesized.served_locale ? "exact" : "any",
+        },
+        source: "synthesized",
+        served_stale: servedStale,
+        synthesized: true,
+        machine_translated: false,
+    };
+}
+/** Drift event consumer for the charters content cache. Per §3.4.1. */
+export const invalidateCharterContentOnDrift = createInvalidateOnDrift(chartersSourcedContentTable, { entityModule: "charters" });
+function toDateOrNull(value) {
+    if (!value)
+        return null;
+    if (value instanceof Date)
+        return value;
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+}

package/dist/service-myba.d.ts

@@ -0,0 +1,85 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type BookingCharterDetail } from "./booking-extension.js";
+/**
+ * Minimal subset of `@voyant-travel/legal`'s `contractsService` we depend on.
+ * Defined structurally so charters does NOT take a hard dependency on
+ * the legal package — templates wire the real service in. Mirrors the
+ * dependency-inversion pattern legal already uses for document
+ * generators / event resolveDb.
+ */
+export interface CharterContractsService {
+    getDefaultTemplate(db: PostgresJsDatabase, query: {
+        scope?: string;
+        language?: string;
+        slug?: string;
+    }): Promise<{
+        id: string;
+        currentVersionId: string | null;
+        slug: string;
+    } | null>;
+    getTemplateById(db: PostgresJsDatabase, id: string): Promise<{
+        id: string;
+        currentVersionId: string | null;
+        slug: string;
+    } | null>;
+    createContract(db: PostgresJsDatabase, data: {
+        scope: "customer" | "supplier" | "partner" | "channel" | "other";
+        title: string;
+        templateVersionId?: string | null;
+        personId?: string | null;
+        organizationId?: string | null;
+        bookingId?: string | null;
+        variables?: Record<string, unknown> | null;
+        language?: string;
+        metadata?: Record<string, unknown> | null;
+    }): Promise<{
+        id: string;
+    } | null>;
+}
+export type GenerateMybaContractInput = {
+    bookingId: string;
+    /** Override the template that the booking_charter_details snapshotted. */
+    templateIdOverride?: string | null;
+    /** Locale for the contract; defaults to "en". */
+    language?: string;
+    /** Extra Liquid variables passed to the template renderer. Merged on top of
+     *  the defaults generated from the booking + charter snapshot. */
+    extraVariables?: Record<string, unknown>;
+    title?: string;
+};
+export type GenerateMybaContractResult = {
+    status: "ok";
+    contractId: string;
+    detail: BookingCharterDetail;
+} | {
+    status: "not_found";
+} | {
+    status: "wrong_mode";
+    bookingMode: string;
+} | {
+    status: "no_template";
+    detail: BookingCharterDetail;
+} | {
+    status: "template_not_found";
+    templateId: string;
+} | {
+    status: "contract_create_failed";
+};
+/**
+ * Generate a MYBA contract for a whole-yacht booking and link it back via
+ * `booking_charter_details.mybaContractId`. Idempotent in the
+ * already-generated case: if `mybaContractId` is set, returns ok without
+ * recreating.
+ *
+ * Resolves the template id with this precedence:
+ *   1. `input.templateIdOverride`
+ *   2. `booking_charter_details.mybaTemplateIdSnapshot` (recorded at
+ *      booking-creation time from voyage override or product default)
+ *   3. legal's default contract template (scope='customer', the slug
+ *      conventionally used for MYBA — caller can also pass a slug via
+ *      override).
+ */
+export declare const mybaService: {
+    generateContract(db: PostgresJsDatabase, contractsService: CharterContractsService, input: GenerateMybaContractInput): Promise<GenerateMybaContractResult>;
+};
+//# sourceMappingURL=service-myba.d.ts.map

package/dist/service-myba.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-myba.d.ts","sourceRoot":"","sources":["../src/service-myba.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,EAAE,KAAK,oBAAoB,EAAyB,MAAM,wBAAwB,CAAA;AAEzF;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,CAChB,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAEhF,eAAe,CACb,EAAE,EAAE,kBAAkB,EACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAEhF,cAAc,CACZ,EAAE,EAAE,kBAAkB,EACtB,IAAI,EAAE;QACJ,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;QAChE,KAAK,EAAE,MAAM,CAAA;QACb,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;QAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAC1C,GACA,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;CAClC;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;sEACkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAClE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAA;AAExC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;yBAEhB,kBAAkB,oBACJ,uBAAuB,SAClC,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;CAqEvC,CAAA"}

package/dist/service-myba.js

@@ -0,0 +1,88 @@
+import { eq } from "drizzle-orm";
+import { bookingCharterDetails } from "./booking-extension.js";
+/**
+ * Generate a MYBA contract for a whole-yacht booking and link it back via
+ * `booking_charter_details.mybaContractId`. Idempotent in the
+ * already-generated case: if `mybaContractId` is set, returns ok without
+ * recreating.
+ *
+ * Resolves the template id with this precedence:
+ *   1. `input.templateIdOverride`
+ *   2. `booking_charter_details.mybaTemplateIdSnapshot` (recorded at
+ *      booking-creation time from voyage override or product default)
+ *   3. legal's default contract template (scope='customer', the slug
+ *      conventionally used for MYBA — caller can also pass a slug via
+ *      override).
+ */
+export const mybaService = {
+    async generateContract(db, contractsService, input) {
+        const [detail] = await db
+            .select()
+            .from(bookingCharterDetails)
+            .where(eq(bookingCharterDetails.bookingId, input.bookingId))
+            .limit(1);
+        if (!detail)
+            return { status: "not_found" };
+        if (detail.bookingMode !== "whole_yacht") {
+            return { status: "wrong_mode", bookingMode: detail.bookingMode };
+        }
+        if (detail.mybaContractId) {
+            return { status: "ok", contractId: detail.mybaContractId, detail };
+        }
+        const templateId = input.templateIdOverride ?? detail.mybaTemplateIdSnapshot;
+        let template = null;
+        if (templateId) {
+            template = await contractsService.getTemplateById(db, templateId);
+            if (!template)
+                return { status: "template_not_found", templateId };
+        }
+        else {
+            template = await contractsService.getDefaultTemplate(db, {
+                scope: "customer",
+                language: input.language ?? "en",
+            });
+            if (!template)
+                return { status: "no_template", detail };
+        }
+        const variables = {
+            bookingId: detail.bookingId,
+            voyageId: detail.voyageId,
+            voyageDisplayName: detail.voyageDisplayName,
+            yachtName: detail.yachtName,
+            yachtId: detail.yachtId,
+            charterArea: detail.charterAreaSnapshot,
+            guestCount: detail.guestCount,
+            currency: detail.quotedCurrency,
+            charterFee: detail.quotedCharterFee,
+            apaPercent: detail.apaPercent,
+            apaAmount: detail.apaAmount,
+            total: detail.quotedTotal,
+            ...(input.extraVariables ?? {}),
+        };
+        const contract = await contractsService.createContract(db, {
+            scope: "customer",
+            title: input.title ??
+                `MYBA charter agreement — ${detail.voyageDisplayName ?? detail.voyageId ?? detail.bookingId}`,
+            templateVersionId: template.currentVersionId,
+            bookingId: detail.bookingId,
+            variables,
+            language: input.language ?? "en",
+            metadata: {
+                source: "charters",
+                bookingMode: "whole_yacht",
+                templateId: template.id,
+                templateSlug: template.slug,
+            },
+        });
+        if (!contract)
+            return { status: "contract_create_failed" };
+        const [updated] = await db
+            .update(bookingCharterDetails)
+            .set({ mybaContractId: contract.id, updatedAt: new Date() })
+            .where(eq(bookingCharterDetails.bookingId, input.bookingId))
+            .returning();
+        if (!updated)
+            return { status: "contract_create_failed" };
+        return { status: "ok", contractId: contract.id, detail: updated };
+    },
+};

package/dist/service-pricing.d.ts

@@ -0,0 +1,64 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type CharterVoyage } from "./schema-core.js";
+import { type CharterSuite } from "./schema-pricing.js";
+export type PerSuiteQuote = {
+    mode: "per_suite";
+    voyageId: string;
+    suiteId: string;
+    suiteName: string;
+    currency: string;
+    suitePrice: string;
+    portFee: string | null;
+    total: string;
+};
+export type ComposePerSuiteQuoteInput = {
+    voyageId: string;
+    suite: Pick<CharterSuite, "id" | "suiteName" | "pricesByCurrency" | "portFeesByCurrency">;
+    currency: string;
+};
+export declare function composePerSuiteQuote(input: ComposePerSuiteQuoteInput): PerSuiteQuote;
+export type WholeYachtQuote = {
+    mode: "whole_yacht";
+    voyageId: string;
+    currency: string;
+    charterFee: string;
+    apaPercent: string;
+    apaAmount: string;
+    total: string;
+};
+export type ComposeWholeYachtQuoteInput = {
+    voyage: Pick<CharterVoyage, "id" | "wholeYachtPricesByCurrency" | "apaPercentOverride">;
+    /**
+     * The product's defaultApaPercent — passed in by the caller so this stays
+     * a pure function. Voyage-level override takes precedence.
+     */
+    productDefaultApaPercent: string | null;
+    currency: string;
+};
+export declare function composeWholeYachtQuote(input: ComposeWholeYachtQuoteInput): WholeYachtQuote;
+/**
+ * Compute APA amount from a charter fee and a percent. Useful for finance-side
+ * recalculation without needing to re-quote the whole voyage.
+ */
+export declare function computeApaAmount(charterFee: string, apaPercent: string): string;
+export declare const pricingService: {
+    quotePerSuite(db: PostgresJsDatabase, args: {
+        suiteId: string;
+        currency: string;
+    }): Promise<PerSuiteQuote>;
+    quoteWholeYacht(db: PostgresJsDatabase, args: {
+        voyageId: string;
+        currency: string;
+    }): Promise<WholeYachtQuote>;
+    /**
+     * Lowest published per-suite price for a voyage, in the requested currency.
+     * Returns `null` when no available suite has that currency. The previous
+     * `lowestSuitePriceUSD` shape was renamed and generalized as part of #355
+     * (browse-currency policy is a deployment choice, not a hardcoded USD).
+     */
+    lowestSuitePriceForCurrency(db: PostgresJsDatabase, voyageId: string, currency: string): Promise<{
+        suiteId: string;
+        price: string;
+    } | null>;
+};
+//# sourceMappingURL=service-pricing.d.ts.map

package/dist/service-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-pricing.d.ts","sourceRoot":"","sources":["../src/service-pricing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,EAAE,KAAK,aAAa,EAAmC,MAAM,kBAAkB,CAAA;AACtF,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,qBAAqB,CAAA;AAgEtE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,GAAG,kBAAkB,GAAG,oBAAoB,CAAC,CAAA;IACzF,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,aAAa,CAqBpF;AAID,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,aAAa,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CAMd,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,4BAA4B,GAAG,oBAAoB,CAAC,CAAA;IACvF;;;OAGG;IACH,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,eAAe,CA2B1F;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG/E;AAID,eAAO,MAAM,cAAc;sBAEnB,kBAAkB,QAChB;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,aAAa,CAAC;wBAenB,kBAAkB,QAChB;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,eAAe,CAAC;IAqB3B;;;;;OAKG;oCAEG,kBAAkB,YACZ,MAAM,YACN,MAAM,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAsBtD,CAAA"}