@voyant-travel/commerce 0.1.0

package/dist/sellability/service-shared.d.ts

@@ -0,0 +1,124 @@
+import type { z } from "zod";
+import type { insertOfferExpirationEventSchema, insertOfferRefreshRunSchema, insertSellabilityExplanationSchema, insertSellabilityPolicyResultSchema, insertSellabilityPolicySchema, offerExpirationEventListQuerySchema, offerRefreshRunListQuerySchema, SellabilityResolveQuery, sellabilityExplanationListQuerySchema, sellabilityPolicyListQuerySchema, sellabilityPolicyResultListQuerySchema, updateOfferExpirationEventSchema, updateOfferRefreshRunSchema, updateSellabilityExplanationSchema, updateSellabilityPolicyResultSchema, updateSellabilityPolicySchema } from "./validation.js";
+export type { SellabilityResolveQuery } from "./validation.js";
+export type RequestedUnit = SellabilityResolveQuery["requestedUnits"][number];
+export type SellabilitySnapshotListQuery = {
+    limit: number;
+    offset: number;
+    offerId?: string;
+    marketId?: string;
+    channelId?: string;
+    productId?: string;
+    optionId?: string;
+    slotId?: string;
+    status?: "resolved" | "offer_constructed" | "expired";
+};
+export type SellabilitySnapshotItemListQuery = {
+    limit: number;
+    offset: number;
+    snapshotId?: string;
+    productId?: string;
+    optionId?: string;
+    slotId?: string;
+    unitId?: string;
+};
+export type SellabilityPolicyListQuery = z.infer<typeof sellabilityPolicyListQuerySchema>;
+export type CreateSellabilityPolicyInput = z.infer<typeof insertSellabilityPolicySchema>;
+export type UpdateSellabilityPolicyInput = z.infer<typeof updateSellabilityPolicySchema>;
+export type SellabilityPolicyResultListQuery = z.infer<typeof sellabilityPolicyResultListQuerySchema>;
+export type CreateSellabilityPolicyResultInput = z.infer<typeof insertSellabilityPolicyResultSchema>;
+export type UpdateSellabilityPolicyResultInput = z.infer<typeof updateSellabilityPolicyResultSchema>;
+export type OfferRefreshRunListQuery = z.infer<typeof offerRefreshRunListQuerySchema>;
+export type CreateOfferRefreshRunInput = z.infer<typeof insertOfferRefreshRunSchema>;
+export type UpdateOfferRefreshRunInput = z.infer<typeof updateOfferRefreshRunSchema>;
+export type OfferExpirationEventListQuery = z.infer<typeof offerExpirationEventListQuerySchema>;
+export type CreateOfferExpirationEventInput = z.infer<typeof insertOfferExpirationEventSchema>;
+export type UpdateOfferExpirationEventInput = z.infer<typeof updateOfferExpirationEventSchema>;
+export type SellabilityExplanationListQuery = z.infer<typeof sellabilityExplanationListQuerySchema>;
+export type CreateSellabilityExplanationInput = z.infer<typeof insertSellabilityExplanationSchema>;
+export type UpdateSellabilityExplanationInput = z.infer<typeof updateSellabilityExplanationSchema>;
+export type ResolvedPriceBreakdown = {
+    requestRef: string | null;
+    unitId: string | null;
+    unitName: string | null;
+    unitType: string | null;
+    pricingCategoryId: string | null;
+    pricingCategoryName: string | null;
+    quantity: number;
+    pricingMode: string;
+    sellAmountCents: number;
+    costAmountCents: number;
+    sourceRuleId: string | null;
+    tierId: string | null;
+};
+export type ResolvedPriceComponent = {
+    kind: "base" | "unit" | "pickup" | "start_time_adjustment";
+    title: string;
+    quantity: number;
+    pricingMode: string;
+    sellAmountCents: number;
+    costAmountCents: number;
+    unitId: string | null;
+    unitName: string | null;
+    unitType: string | null;
+    pricingCategoryId: string | null;
+    pricingCategoryName: string | null;
+    requestRef: string | null;
+    sourceRuleId: string | null;
+    tierId: string | null;
+};
+export declare function weekdayCandidates(dateLocal: string): (string | undefined)[];
+export declare function scheduleMatches(schedule: {
+    validFrom: string | null;
+    validTo: string | null;
+    weekdays: string[] | null;
+}, dateLocal?: string): boolean;
+export declare function applyAdjustment(total: {
+    sellAmountCents: number;
+    costAmountCents: number;
+}, adjustment: {
+    adjustmentType: "fixed" | "percentage" | null;
+    sellAdjustmentCents: number | null;
+    costAdjustmentCents: number | null;
+    adjustmentBasisPoints: number | null;
+}): {
+    sellAmountCents: number;
+    costAmountCents: number;
+};
+export declare function computeUnitAmounts(request: RequestedUnit, details: {
+    unitName: string | null;
+    unitType: string | null;
+    pricingCategoryName: string | null;
+}, unitRule: {
+    id: string;
+    pricingMode: string;
+    sellAmountCents: number | null;
+    costAmountCents: number | null;
+} | null, tier: {
+    id: string;
+    sellAmountCents: number | null;
+    costAmountCents: number | null;
+} | null, override: {
+    sellAmountCents: number;
+    costAmountCents: number | null;
+} | null): ResolvedPriceBreakdown;
+export declare function chooseBestScheduledRule<T extends {
+    isDefault?: boolean | null;
+    priceScheduleId?: string | null;
+}>(rows: T[]): T | null;
+export declare function chooseBestSpecificRule<T extends {
+    optionId?: string | null;
+}>(rows: T[]): T | null;
+export declare function toNumeric(value: string | number | null | undefined): number | null;
+export declare function compactObject<T extends Record<string, unknown>>(value: T): T;
+export declare function paginate<T extends object>(rowsQuery: Promise<T[]>, countQuery: Promise<Array<{
+    count: number;
+}>>, limit: number, offset: number): Promise<{
+    data: T[];
+    total: number;
+    limit: number;
+    offset: number;
+}>;
+export declare function normalizeDateTime(value: string | null | undefined): Date | null;
+export type PaginatedResult<T extends object> = Awaited<ReturnType<typeof paginate<T>>>;
+//# sourceMappingURL=service-shared.d.ts.map

package/dist/sellability/service-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-shared.d.ts","sourceRoot":"","sources":["../../src/sellability/service-shared.ts"],"names":[],"mappings":"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"}

package/dist/sellability/service-shared.js

@@ -0,0 +1,96 @@
+export function weekdayCandidates(dateLocal) {
+    const weekday = new Date(`${dateLocal}T00:00:00Z`).getUTCDay();
+    const names = ["sun", "mon", "tue", "wed", "thu", "fri", "sat"];
+    const longNames = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+    return [String(weekday), names[weekday], longNames[weekday]];
+}
+export function scheduleMatches(schedule, dateLocal) {
+    if (!dateLocal)
+        return true;
+    if (schedule.validFrom && dateLocal < schedule.validFrom)
+        return false;
+    if (schedule.validTo && dateLocal > schedule.validTo)
+        return false;
+    if (!schedule.weekdays || schedule.weekdays.length === 0)
+        return true;
+    const candidates = weekdayCandidates(dateLocal);
+    return schedule.weekdays.some((entry) => candidates.includes(entry.toLowerCase()));
+}
+export function applyAdjustment(total, adjustment) {
+    if (adjustment.adjustmentType === "fixed") {
+        return {
+            sellAmountCents: total.sellAmountCents + (adjustment.sellAdjustmentCents ?? 0),
+            costAmountCents: total.costAmountCents + (adjustment.costAdjustmentCents ?? 0),
+        };
+    }
+    if (adjustment.adjustmentType === "percentage" && adjustment.adjustmentBasisPoints) {
+        return {
+            sellAmountCents: total.sellAmountCents +
+                Math.round((total.sellAmountCents * adjustment.adjustmentBasisPoints) / 10_000),
+            costAmountCents: total.costAmountCents +
+                Math.round((total.costAmountCents * adjustment.adjustmentBasisPoints) / 10_000),
+        };
+    }
+    return total;
+}
+export function computeUnitAmounts(request, details, unitRule, tier, override) {
+    const pricingMode = unitRule?.pricingMode ?? "per_unit";
+    const baseSell = override?.sellAmountCents ?? tier?.sellAmountCents ?? unitRule?.sellAmountCents ?? 0;
+    const baseCost = override?.costAmountCents ?? tier?.costAmountCents ?? unitRule?.costAmountCents ?? 0;
+    if (pricingMode === "included" || pricingMode === "free") {
+        return {
+            requestRef: request.requestRef ?? null,
+            unitId: request.unitId ?? null,
+            unitName: details.unitName,
+            unitType: details.unitType,
+            pricingCategoryId: request.pricingCategoryId ?? null,
+            pricingCategoryName: details.pricingCategoryName,
+            quantity: request.quantity,
+            pricingMode,
+            sellAmountCents: 0,
+            costAmountCents: 0,
+            sourceRuleId: unitRule?.id ?? null,
+            tierId: tier?.id ?? null,
+        };
+    }
+    const multiplier = pricingMode === "per_booking" ? 1 : request.quantity;
+    return {
+        requestRef: request.requestRef ?? null,
+        unitId: request.unitId ?? null,
+        unitName: details.unitName,
+        unitType: details.unitType,
+        pricingCategoryId: request.pricingCategoryId ?? null,
+        pricingCategoryName: details.pricingCategoryName,
+        quantity: request.quantity,
+        pricingMode,
+        sellAmountCents: baseSell * multiplier,
+        costAmountCents: baseCost * multiplier,
+        sourceRuleId: unitRule?.id ?? null,
+        tierId: tier?.id ?? null,
+    };
+}
+export function chooseBestScheduledRule(rows) {
+    return ([...rows].sort((a, b) => {
+        const scoreA = Number(Boolean(a.priceScheduleId)) * 10 + Number(Boolean(a.isDefault));
+        const scoreB = Number(Boolean(b.priceScheduleId)) * 10 + Number(Boolean(b.isDefault));
+        return scoreB - scoreA;
+    })[0] ?? null);
+}
+export function chooseBestSpecificRule(rows) {
+    return ([...rows].sort((a, b) => Number(Boolean(b.optionId)) - Number(Boolean(a.optionId)))[0] ?? null);
+}
+export function toNumeric(value) {
+    if (value === null || value === undefined)
+        return null;
+    return typeof value === "number" ? value : Number(value);
+}
+export function compactObject(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+export async function paginate(rowsQuery, countQuery, limit, offset) {
+    const [data, countResult] = await Promise.all([rowsQuery, countQuery]);
+    return { data, total: countResult[0]?.count ?? 0, limit, offset };
+}
+export function normalizeDateTime(value) {
+    return value ? new Date(value) : null;
+}

package/dist/sellability/service-snapshots.d.ts

@@ -0,0 +1,191 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { resolve } from "./service-resolve.js";
+import { type ResolvedPriceComponent, type SellabilityResolveQuery, type SellabilitySnapshotItemListQuery, type SellabilitySnapshotListQuery } from "./service-shared.js";
+import type { SellabilityPersistSnapshotInput } from "./validation.js";
+type SellabilityResolver = typeof resolve;
+export declare function persistResolvedSnapshot(db: PostgresJsDatabase, input: {
+    query: SellabilityResolveQuery;
+    resolved: Awaited<ReturnType<typeof resolve>>;
+    selectedCandidateIndex?: number;
+    offerId?: string | null;
+    status?: "resolved" | "offer_constructed" | "expired";
+    expiresAt?: string | null;
+}): Promise<{
+    id: string;
+    status: "expired" | "resolved" | "offer_constructed";
+    createdAt: Date;
+    updatedAt: Date;
+    marketId: string | null;
+    fxRateSetId: string | null;
+    productId: string | null;
+    optionId: string | null;
+    channelId: string | null;
+    offerId: string | null;
+    slotId: string | null;
+    expiresAt: Date | null;
+    requestedCurrencyCode: string | null;
+    sourceCurrencyCode: string | null;
+    queryPayload: Record<string, unknown>;
+    pricingSummary: Record<string, unknown>;
+}>;
+export declare function persistSnapshot(db: PostgresJsDatabase, input: SellabilityPersistSnapshotInput, resolver?: SellabilityResolver): Promise<{
+    snapshot: {
+        id: string;
+        status: "expired" | "resolved" | "offer_constructed";
+        createdAt: Date;
+        updatedAt: Date;
+        marketId: string | null;
+        fxRateSetId: string | null;
+        productId: string | null;
+        optionId: string | null;
+        channelId: string | null;
+        offerId: string | null;
+        slotId: string | null;
+        expiresAt: Date | null;
+        requestedCurrencyCode: string | null;
+        sourceCurrencyCode: string | null;
+        queryPayload: Record<string, unknown>;
+        pricingSummary: Record<string, unknown>;
+    };
+    resolved: {
+        data: {
+            product: {
+                id: string;
+                name: string;
+            };
+            option: {
+                id: string;
+                name: string;
+                code: string | null;
+            };
+            slot: {
+                id: string;
+                productId: string;
+                optionId: string | null;
+                startTimeId: string | null;
+                dateLocal: string;
+                startsAt: Date | string;
+                timezone: string;
+                unlimited: boolean;
+                remainingPax: number | null;
+                remainingPickups: number | null;
+                pastCutoff: boolean;
+                tooEarly: boolean;
+            };
+            market: {
+                id: string;
+                code: string;
+                name: string;
+            } | null;
+            channel: {
+                id: string;
+                kind: "direct" | "reseller" | "affiliate" | "ota" | "marketplace" | "api_partner" | "connect";
+            } | null;
+            sellability: {
+                mode: "unavailable" | "sellable" | "on_request";
+                onRequest: boolean;
+                allotmentStatus: "sellable" | "not_applicable";
+            };
+            pricing: {
+                currencyCode: string;
+                sellAmountCents: number;
+                costAmountCents: number;
+                marginAmountCents: number;
+                breakdown: import("./service-shared.js").ResolvedPriceBreakdown[];
+                components: ResolvedPriceComponent[];
+                fx: {
+                    fxRateSetId: string;
+                    baseCurrency: string;
+                    quoteCurrency: string;
+                    rateDecimal: number;
+                } | null;
+            };
+            sources: {
+                marketProductRuleId: string | null;
+                marketChannelRuleId: string | null;
+                marketPriceCatalogId: string | null;
+                optionPriceRuleId: string;
+                optionStartTimeRuleId: string | null;
+                channelInventoryAllotmentIds: string[];
+                channelInventoryReleaseRuleId: string | null;
+            };
+        }[];
+        meta: {
+            total: number;
+        };
+    };
+}>;
+export declare function listSnapshots(db: PostgresJsDatabase, query: SellabilitySnapshotListQuery): Promise<{
+    data: {
+        id: string;
+        offerId: string | null;
+        marketId: string | null;
+        channelId: string | null;
+        productId: string | null;
+        optionId: string | null;
+        slotId: string | null;
+        requestedCurrencyCode: string | null;
+        sourceCurrencyCode: string | null;
+        fxRateSetId: string | null;
+        status: "expired" | "resolved" | "offer_constructed";
+        queryPayload: Record<string, unknown>;
+        pricingSummary: Record<string, unknown>;
+        expiresAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}>;
+export declare function getSnapshotById(db: PostgresJsDatabase, id: string): Promise<{
+    id: string;
+    offerId: string | null;
+    marketId: string | null;
+    channelId: string | null;
+    productId: string | null;
+    optionId: string | null;
+    slotId: string | null;
+    requestedCurrencyCode: string | null;
+    sourceCurrencyCode: string | null;
+    fxRateSetId: string | null;
+    status: "expired" | "resolved" | "offer_constructed";
+    queryPayload: Record<string, unknown>;
+    pricingSummary: Record<string, unknown>;
+    expiresAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+} | null>;
+export declare function listSnapshotItems(db: PostgresJsDatabase, query: SellabilitySnapshotItemListQuery): Promise<{
+    data: {
+        id: string;
+        snapshotId: string;
+        candidateIndex: number;
+        componentIndex: number;
+        productId: string | null;
+        optionId: string | null;
+        slotId: string | null;
+        unitId: string | null;
+        requestRef: string | null;
+        componentKind: "base" | "unit" | "pickup" | "start_time_adjustment";
+        title: string;
+        quantity: number;
+        pricingMode: string;
+        pricingCategoryId: string | null;
+        pricingCategoryName: string | null;
+        unitName: string | null;
+        unitType: string | null;
+        currencyCode: string;
+        sellAmountCents: number;
+        costAmountCents: number;
+        sourceRuleId: string | null;
+        tierId: string | null;
+        isSelected: boolean;
+        createdAt: Date;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}>;
+export {};
+//# sourceMappingURL=service-snapshots.d.ts.map

package/dist/sellability/service-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-snapshots.d.ts","sourceRoot":"","sources":["../../src/sellability/service-snapshots.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAGjE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EAClC,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AAEtE,KAAK,mBAAmB,GAAG,OAAO,OAAO,CAAA;AAMzC,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE;IACL,KAAK,EAAE,uBAAuB,CAAA;IAC9B,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAA;IAC7C,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAAA;IACrD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;;;;;;;;;;;;;;;;;GAoFF;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE,+BAA+B,EACtC,QAAQ,GAAE,mBAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAcxC;AAED,wBAAsB,aAAa,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,4BAA4B;;;;;;;;;;;;;;;;;;;;;;GAsB9F;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;UAOvE;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwBxC"}

package/dist/sellability/service-snapshots.js

@@ -0,0 +1,153 @@
+import { and, asc, desc, eq, sql } from "drizzle-orm";
+import { sellabilitySnapshotItems, sellabilitySnapshots } from "./schema.js";
+import { resolve } from "./service-resolve.js";
+import { paginate, } from "./service-shared.js";
+function normalizeDateTime(value) {
+    return value ? new Date(value) : null;
+}
+export async function persistResolvedSnapshot(db, input) {
+    const primaryCandidate = input.resolved.data[0] ?? null;
+    const [snapshot] = await db
+        .insert(sellabilitySnapshots)
+        .values({
+        offerId: input.offerId ?? null,
+        marketId: primaryCandidate?.market?.id ?? input.query.marketId ?? null,
+        channelId: primaryCandidate?.channel?.id ?? input.query.channelId ?? null,
+        productId: primaryCandidate?.product.id ?? input.query.productId ?? null,
+        optionId: primaryCandidate?.option.id ?? input.query.optionId ?? null,
+        slotId: primaryCandidate?.slot.id ?? input.query.slotId ?? null,
+        requestedCurrencyCode: input.query.currencyCode ?? null,
+        sourceCurrencyCode: primaryCandidate?.pricing.currencyCode ?? null,
+        fxRateSetId: primaryCandidate?.pricing.fx?.fxRateSetId ?? null,
+        status: input.status ?? "resolved",
+        queryPayload: { ...input.query },
+        pricingSummary: {
+            totalCandidates: input.resolved.meta.total,
+            selectedCandidateIndex: input.selectedCandidateIndex ?? null,
+        },
+        expiresAt: normalizeDateTime(input.expiresAt ?? null),
+    })
+        .returning();
+    if (!snapshot) {
+        throw new Error("Failed to persist sellability snapshot");
+    }
+    const itemValues = input.resolved.data.flatMap((candidate, candidateIndex) => {
+        const components = candidate.pricing.components ?? [];
+        const normalizedComponents = components.length > 0
+            ? components
+            : [
+                {
+                    kind: "base",
+                    title: candidate.option.name,
+                    quantity: 1,
+                    pricingMode: "per_booking",
+                    sellAmountCents: candidate.pricing.sellAmountCents,
+                    costAmountCents: candidate.pricing.costAmountCents,
+                    unitId: null,
+                    unitName: null,
+                    unitType: null,
+                    pricingCategoryId: null,
+                    pricingCategoryName: null,
+                    requestRef: null,
+                    sourceRuleId: candidate.sources.optionPriceRuleId,
+                    tierId: null,
+                },
+            ];
+        return normalizedComponents.map((component, componentIndex) => ({
+            snapshotId: snapshot.id,
+            candidateIndex,
+            componentIndex,
+            productId: candidate.product.id,
+            optionId: candidate.option.id,
+            slotId: candidate.slot.id,
+            unitId: component.unitId,
+            requestRef: component.requestRef,
+            componentKind: component.kind,
+            title: component.title,
+            quantity: component.quantity,
+            pricingMode: component.pricingMode,
+            pricingCategoryId: component.pricingCategoryId,
+            pricingCategoryName: component.pricingCategoryName,
+            unitName: component.unitName,
+            unitType: component.unitType,
+            currencyCode: candidate.pricing.currencyCode,
+            sellAmountCents: component.sellAmountCents,
+            costAmountCents: component.costAmountCents,
+            sourceRuleId: component.sourceRuleId,
+            tierId: component.tierId,
+            isSelected: input.selectedCandidateIndex === candidateIndex,
+        }));
+    });
+    if (itemValues.length > 0) {
+        await db.insert(sellabilitySnapshotItems).values(itemValues);
+    }
+    return snapshot;
+}
+export async function persistSnapshot(db, input, resolver = resolve) {
+    const resolvedQuery = {
+        ...input.query,
+        limit: input.query.limit ?? 25,
+    };
+    const resolved = await resolver(db, resolvedQuery);
+    const snapshot = await persistResolvedSnapshot(db, {
+        query: resolvedQuery,
+        resolved,
+        status: "resolved",
+        expiresAt: input.expiresAt ?? null,
+    });
+    return { snapshot, resolved };
+}
+export async function listSnapshots(db, query) {
+    const conditions = [];
+    if (query.offerId)
+        conditions.push(eq(sellabilitySnapshots.offerId, query.offerId));
+    if (query.marketId)
+        conditions.push(eq(sellabilitySnapshots.marketId, query.marketId));
+    if (query.channelId)
+        conditions.push(eq(sellabilitySnapshots.channelId, query.channelId));
+    if (query.productId)
+        conditions.push(eq(sellabilitySnapshots.productId, query.productId));
+    if (query.optionId)
+        conditions.push(eq(sellabilitySnapshots.optionId, query.optionId));
+    if (query.slotId)
+        conditions.push(eq(sellabilitySnapshots.slotId, query.slotId));
+    if (query.status)
+        conditions.push(eq(sellabilitySnapshots.status, query.status));
+    const where = conditions.length > 0 ? and(...conditions) : undefined;
+    return paginate(db
+        .select()
+        .from(sellabilitySnapshots)
+        .where(where)
+        .limit(query.limit)
+        .offset(query.offset)
+        .orderBy(desc(sellabilitySnapshots.updatedAt)), db.select({ count: sql `count(*)::int` }).from(sellabilitySnapshots).where(where), query.limit, query.offset);
+}
+export async function getSnapshotById(db, id) {
+    const [row] = await db
+        .select()
+        .from(sellabilitySnapshots)
+        .where(eq(sellabilitySnapshots.id, id))
+        .limit(1);
+    return row ?? null;
+}
+export async function listSnapshotItems(db, query) {
+    const conditions = [];
+    if (query.snapshotId)
+        conditions.push(eq(sellabilitySnapshotItems.snapshotId, query.snapshotId));
+    if (query.productId)
+        conditions.push(eq(sellabilitySnapshotItems.productId, query.productId));
+    if (query.optionId)
+        conditions.push(eq(sellabilitySnapshotItems.optionId, query.optionId));
+    if (query.slotId)
+        conditions.push(eq(sellabilitySnapshotItems.slotId, query.slotId));
+    if (query.unitId)
+        conditions.push(eq(sellabilitySnapshotItems.unitId, query.unitId));
+    const where = conditions.length > 0 ? and(...conditions) : undefined;
+    return paginate(db
+        .select()
+        .from(sellabilitySnapshotItems)
+        .where(where)
+        .limit(query.limit)
+        .offset(query.offset)
+        .orderBy(asc(sellabilitySnapshotItems.candidateIndex), asc(sellabilitySnapshotItems.componentIndex)), db.select({ count: sql `count(*)::int` }).from(sellabilitySnapshotItems).where(where), query.limit, query.offset);
+}