@mohasinac/appkit 3.4.8 → 3.5.0

package/dist/features/shipments/repository/shipments.repository.js

@@ -0,0 +1,77 @@
+/**
+ * Procurement Shipments Repository — header document only.
+ * Lots/items live in ShipmentLotsRepository / ShipmentItemsRepository.
+ */
+import { BaseRepository, prepareForFirestore, } from "../../../providers/db-firebase";
+import { ConflictError } from "../../../errors";
+import { SHIPMENT_COLLECTION, SHIPMENT_FIELDS, SHIPMENT_ITEM_COLLECTION, DEFAULT_SHIPMENT_TOTALS, createShipmentId, } from "../schemas/firestore";
+export class ShipmentsRepository extends BaseRepository {
+    constructor() {
+        super(SHIPMENT_COLLECTION);
+    }
+    async findByShipmentNumber(shipmentNumber) {
+        return this.findOneBy(SHIPMENT_FIELDS.SHIPMENT_NUMBER, shipmentNumber);
+    }
+    async assertShipmentNumberAvailable(shipmentNumber, excludeId) {
+        const existing = await this.findByShipmentNumber(shipmentNumber);
+        if (existing && existing.id !== excludeId) {
+            throw new ConflictError(`Shipment number "${shipmentNumber}" is already in use`, "SHIPMENT_NUMBER_TAKEN");
+        }
+    }
+    async create(input) {
+        await this.assertShipmentNumberAvailable(input.shipmentNumber);
+        const id = createShipmentId({ supplierName: input.supplierName });
+        const data = {
+            ...input,
+            totals: DEFAULT_SHIPMENT_TOTALS,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+        await this.getCollection().doc(id).set(prepareForFirestore(data));
+        return { id, ...data };
+    }
+    async update(shipmentId, input) {
+        if (input.shipmentNumber) {
+            await this.assertShipmentNumberAvailable(input.shipmentNumber, shipmentId);
+        }
+        return super.update(shipmentId, input);
+    }
+    /** Cheap bounded existence check — any item under this shipment still linked to a product? */
+    async hasLinkedItems(shipmentId) {
+        const snap = await this.db
+            .collection(SHIPMENT_ITEM_COLLECTION)
+            .where("shipmentId", "==", shipmentId)
+            .where("linkedProductId", "!=", null)
+            .limit(1)
+            .get();
+        return !snap.empty;
+    }
+    /**
+     * Blocks deletion if any item is still linked to a product — unlink first.
+     * Cascade-deleting the shipment's lots/items themselves is handled by the
+     * onShipmentDeleted Firestore trigger (Function #3), not here — this keeps
+     * the route fast regardless of how many items the shipment had.
+     */
+    async delete(shipmentId) {
+        const linked = await this.hasLinkedItems(shipmentId);
+        if (linked) {
+            throw new ConflictError(`Cannot delete shipment ${shipmentId}: one or more items are still linked to a product. Unlink first.`, "SHIPMENT_HAS_LINKED_ITEMS");
+        }
+        await super.delete(shipmentId);
+    }
+    async list(model) {
+        return this.sieveQuery(model, ShipmentsRepository.SIEVE_FIELDS, {
+            defaultPageSize: 20,
+            maxPageSize: 50,
+        });
+    }
+}
+ShipmentsRepository.SIEVE_FIELDS = {
+    id: { canFilter: true, canSort: false },
+    shipmentNumber: { canFilter: true, canSort: true },
+    supplierName: { canFilter: true, canSort: true },
+    status: { canFilter: true, canSort: true },
+    etaDate: { canFilter: true, canSort: true },
+    createdAt: { canFilter: true, canSort: true },
+};
+export const shipmentsRepository = new ShipmentsRepository();

package/dist/features/shipments/schemas/firestore.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Procurement Shipments Firestore Document Types & Constants
+ *
+ * Three top-level collections (not embedded arrays — a lot can hold up to
+ * ~500 items and a shipment up to ~10 lots, which blows past Firestore's
+ * 1 MiB document limit if nested):
+ *   procurementShipments — header + overall totals (persisted rollup)
+ *   shipmentLots          — one doc per lot, FK shipmentId
+ *   shipmentItems         — one doc per individually-tracked "main" item, FK lotId/shipmentId
+ *
+ * Totals are recomputed by a background Firestore-triggered Function
+ * cascade (see appkit/src/_internal/server/functions/firestore/on-shipment-*),
+ * never inline in a Vercel route or React component.
+ */
+import { type GenerateShipmentIdInput } from "../../../utils/id-generators";
+import type { BaseDocument } from "../../../_internal/shared/types/base-document";
+import type { MediaField } from "../../media/types";
+import type { ListingType } from "../../products/types";
+import type { ProductDocument } from "../../products/schemas/firestore";
+export declare const SHIPMENT_COLLECTION: "procurementShipments";
+export declare const SHIPMENT_LOT_COLLECTION: "shipmentLots";
+export declare const SHIPMENT_ITEM_COLLECTION: "shipmentItems";
+export type ShipmentStatus = "planning" | "ordered" | "in_transit" | "customs" | "received" | "processing" | "completed" | "cancelled";
+export declare const MAX_ITEMS_PER_LOT = 500;
+export declare const MAX_LOTS_PER_SHIPMENT = 10;
+export interface ShipmentTotals {
+    lotsCostPaise: number;
+    customsTotalPaise: number;
+    shippingTotalPaise: number;
+    laborCostPaise: number;
+    totalShipmentCostPaise: number;
+    totalProjectedRevenuePaise: number;
+    projectedProfitPaise: number;
+    projectedProfitAfterLaborPaise: number;
+    projectedMarginPercent: number;
+    projectedRoiPercent: number;
+    totalWeightGrams: number;
+    totalItemCount: number;
+    lotCount: number;
+    estimatedProcessingDays: number;
+}
+export declare const DEFAULT_SHIPMENT_TOTALS: ShipmentTotals;
+export interface ShipmentDocument extends BaseDocument {
+    shipmentNumber: string;
+    supplierName: string;
+    originCountry?: string;
+    status: ShipmentStatus;
+    trackingNumber?: string;
+    carrier?: string;
+    etaDate?: Date;
+    receivedDate?: Date;
+    notes?: string;
+    customsTotalPaise: number;
+    shippingTotalPaise: number;
+    laborHoursSpent?: number;
+    laborRatePaisePerHour?: number;
+    totals: ShipmentTotals;
+    totalsComputedAt?: Date;
+    createdBy: string;
+}
+export interface ShipmentLot extends BaseDocument {
+    shipmentId: string;
+    shipmentStatus: ShipmentStatus;
+    lotName: string;
+    supplierOrderRef?: string;
+    weightGrams: number;
+    purchaseCostPaise: number;
+    images: MediaField[];
+    remainderItemCount?: number;
+    remainderEstimatedValuePaise?: number;
+    itemCount: number;
+    mainItemsProjectedRevenuePaise: number;
+    customsAllocatedPaise: number;
+    shippingAllocatedPaise: number;
+    totalLandedCostPaise: number;
+    projectedRevenuePaise: number;
+    projectedProfitPaise: number;
+}
+/**
+ * Reused everywhere a "this will eventually become a real product" record is
+ * needed (ShipmentItem below, and Feature B's CatalogueItemDocument) — a
+ * Pick off the live ProductDocument, not a hand-duplicated field list, so
+ * (a) the eventual product-creation call is close to a literal field spread,
+ * and (b) a future ProductDocument field rename surfaces as a type error
+ * here instead of silently drifting.
+ */
+export type ProductDraftFields = Pick<ProductDocument, "title" | "mainImage" | "images" | "condition" | "categorySlugs" | "brandSlug" | "price">;
+export interface ShipmentItem extends BaseDocument, Partial<Omit<ProductDraftFields, "title">> {
+    shipmentId: string;
+    lotId: string;
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string;
+    linkedProductId?: string | null;
+    linkedProductSlug?: string | null;
+    linkedProductListingType?: ListingType | null;
+}
+export declare const SHIPMENT_STATUS_VALUES: {
+    readonly PLANNING: "planning";
+    readonly ORDERED: "ordered";
+    readonly IN_TRANSIT: "in_transit";
+    readonly CUSTOMS: "customs";
+    readonly RECEIVED: "received";
+    readonly PROCESSING: "processing";
+    readonly COMPLETED: "completed";
+    readonly CANCELLED: "cancelled";
+};
+export declare const SHIPMENT_FIELDS: {
+    readonly ID: "id";
+    readonly SHIPMENT_NUMBER: "shipmentNumber";
+    readonly STATUS: "status";
+    readonly ETA_DATE: "etaDate";
+    readonly CREATED_AT: "createdAt";
+    readonly STATUS_VALUES: {
+        readonly PLANNING: "planning";
+        readonly ORDERED: "ordered";
+        readonly IN_TRANSIT: "in_transit";
+        readonly CUSTOMS: "customs";
+        readonly RECEIVED: "received";
+        readonly PROCESSING: "processing";
+        readonly COMPLETED: "completed";
+        readonly CANCELLED: "cancelled";
+    };
+};
+export declare const SHIPMENT_LOT_FIELDS: {
+    readonly ID: "id";
+    readonly SHIPMENT_ID: "shipmentId";
+    readonly SHIPMENT_STATUS: "shipmentStatus";
+    readonly PROJECTED_PROFIT_PAISE: "projectedProfitPaise";
+    readonly CREATED_AT: "createdAt";
+};
+export declare const SHIPMENT_ITEM_FIELDS: {
+    readonly ID: "id";
+    readonly SHIPMENT_ID: "shipmentId";
+    readonly LOT_ID: "lotId";
+    readonly LINKED_PRODUCT_ID: "linkedProductId";
+    readonly CREATED_AT: "createdAt";
+};
+export type ShipmentCreateInput = Omit<ShipmentDocument, "id" | "createdAt" | "updatedAt" | "totals" | "totalsComputedAt">;
+export type ShipmentUpdateInput = Partial<Omit<ShipmentDocument, "id" | "createdAt" | "createdBy" | "totals" | "totalsComputedAt">>;
+export type ShipmentLotCreateInput = Omit<ShipmentLot, "id" | "createdAt" | "updatedAt" | "shipmentId" | "shipmentStatus" | "itemCount" | "mainItemsProjectedRevenuePaise" | "customsAllocatedPaise" | "shippingAllocatedPaise" | "totalLandedCostPaise" | "projectedRevenuePaise" | "projectedProfitPaise">;
+export type ShipmentLotUpdateInput = Partial<Omit<ShipmentLot, "id" | "createdAt" | "shipmentId">>;
+export type ShipmentItemCreateInput = Omit<ShipmentItem, "id" | "createdAt" | "updatedAt" | "shipmentId" | "lotId">;
+export type ShipmentItemUpdateInput = Partial<Omit<ShipmentItem, "id" | "createdAt" | "shipmentId" | "lotId">>;
+export declare const shipmentQueryHelpers: {
+    readonly byStatus: (status: ShipmentStatus) => readonly ["status", "==", ShipmentStatus];
+    readonly notCancelled: () => readonly ["status", "!=", ShipmentStatus];
+};
+export declare function createShipmentId(input: GenerateShipmentIdInput): string;

package/dist/features/shipments/schemas/firestore.js

@@ -0,0 +1,76 @@
+/**
+ * Procurement Shipments Firestore Document Types & Constants
+ *
+ * Three top-level collections (not embedded arrays — a lot can hold up to
+ * ~500 items and a shipment up to ~10 lots, which blows past Firestore's
+ * 1 MiB document limit if nested):
+ *   procurementShipments — header + overall totals (persisted rollup)
+ *   shipmentLots          — one doc per lot, FK shipmentId
+ *   shipmentItems         — one doc per individually-tracked "main" item, FK lotId/shipmentId
+ *
+ * Totals are recomputed by a background Firestore-triggered Function
+ * cascade (see appkit/src/_internal/server/functions/firestore/on-shipment-*),
+ * never inline in a Vercel route or React component.
+ */
+import { generateShipmentId, } from "../../../utils/id-generators";
+export const SHIPMENT_COLLECTION = "procurementShipments";
+export const SHIPMENT_LOT_COLLECTION = "shipmentLots";
+export const SHIPMENT_ITEM_COLLECTION = "shipmentItems";
+// Hard scale caps (architectural — 500 is Firestore's native batched-write limit).
+export const MAX_ITEMS_PER_LOT = 500;
+export const MAX_LOTS_PER_SHIPMENT = 10;
+export const DEFAULT_SHIPMENT_TOTALS = {
+    lotsCostPaise: 0,
+    customsTotalPaise: 0,
+    shippingTotalPaise: 0,
+    laborCostPaise: 0,
+    totalShipmentCostPaise: 0,
+    totalProjectedRevenuePaise: 0,
+    projectedProfitPaise: 0,
+    projectedProfitAfterLaborPaise: 0,
+    projectedMarginPercent: 0,
+    projectedRoiPercent: 0,
+    totalWeightGrams: 0,
+    totalItemCount: 0,
+    lotCount: 0,
+    estimatedProcessingDays: 0,
+};
+export const SHIPMENT_STATUS_VALUES = {
+    PLANNING: "planning",
+    ORDERED: "ordered",
+    IN_TRANSIT: "in_transit",
+    CUSTOMS: "customs",
+    RECEIVED: "received",
+    PROCESSING: "processing",
+    COMPLETED: "completed",
+    CANCELLED: "cancelled",
+};
+export const SHIPMENT_FIELDS = {
+    ID: "id",
+    SHIPMENT_NUMBER: "shipmentNumber",
+    STATUS: "status",
+    ETA_DATE: "etaDate",
+    CREATED_AT: "createdAt",
+    STATUS_VALUES: SHIPMENT_STATUS_VALUES,
+};
+export const SHIPMENT_LOT_FIELDS = {
+    ID: "id",
+    SHIPMENT_ID: "shipmentId",
+    SHIPMENT_STATUS: "shipmentStatus",
+    PROJECTED_PROFIT_PAISE: "projectedProfitPaise",
+    CREATED_AT: "createdAt",
+};
+export const SHIPMENT_ITEM_FIELDS = {
+    ID: "id",
+    SHIPMENT_ID: "shipmentId",
+    LOT_ID: "lotId",
+    LINKED_PRODUCT_ID: "linkedProductId",
+    CREATED_AT: "createdAt",
+};
+export const shipmentQueryHelpers = {
+    byStatus: (status) => ["status", "==", status],
+    notCancelled: () => ["status", "!=", "cancelled"],
+};
+export function createShipmentId(input) {
+    return generateShipmentId(input);
+}

package/dist/features/shipments/schemas/index.d.ts

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

package/dist/features/shipments/schemas/index.js

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

package/dist/features/shipments/schemas/validation.d.ts

@@ -0,0 +1,350 @@
+import { z } from "zod";
+export declare const shipmentStatusSchema: z.ZodEnum<["planning", "ordered", "in_transit", "customs", "received", "processing", "completed", "cancelled"]>;
+export declare const createShipmentSchema: z.ZodObject<{
+    shipmentNumber: z.ZodString;
+    supplierName: z.ZodString;
+    originCountry: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["planning", "ordered", "in_transit", "customs", "received", "processing", "completed", "cancelled"]>;
+    trackingNumber: z.ZodOptional<z.ZodString>;
+    carrier: z.ZodOptional<z.ZodString>;
+    etaDate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    receivedDate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    notes: z.ZodOptional<z.ZodString>;
+    customsTotalPaise: z.ZodNumber;
+    shippingTotalPaise: z.ZodNumber;
+    laborHoursSpent: z.ZodOptional<z.ZodNumber>;
+    laborRatePaisePerHour: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "received" | "cancelled" | "processing" | "ordered" | "completed" | "planning" | "in_transit" | "customs";
+    shipmentNumber: string;
+    supplierName: string;
+    customsTotalPaise: number;
+    shippingTotalPaise: number;
+    notes?: string | undefined;
+    trackingNumber?: string | undefined;
+    etaDate?: string | Date | undefined;
+    originCountry?: string | undefined;
+    carrier?: string | undefined;
+    receivedDate?: string | Date | undefined;
+    laborHoursSpent?: number | undefined;
+    laborRatePaisePerHour?: number | undefined;
+}, {
+    status: "received" | "cancelled" | "processing" | "ordered" | "completed" | "planning" | "in_transit" | "customs";
+    shipmentNumber: string;
+    supplierName: string;
+    customsTotalPaise: number;
+    shippingTotalPaise: number;
+    notes?: string | undefined;
+    trackingNumber?: string | undefined;
+    etaDate?: string | Date | undefined;
+    originCountry?: string | undefined;
+    carrier?: string | undefined;
+    receivedDate?: string | Date | undefined;
+    laborHoursSpent?: number | undefined;
+    laborRatePaisePerHour?: number | undefined;
+}>;
+export declare const updateShipmentSchema: z.ZodObject<{
+    shipmentNumber: z.ZodOptional<z.ZodString>;
+    supplierName: z.ZodOptional<z.ZodString>;
+    originCountry: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<["planning", "ordered", "in_transit", "customs", "received", "processing", "completed", "cancelled"]>>;
+    trackingNumber: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    carrier: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    etaDate: z.ZodOptional<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>>;
+    receivedDate: z.ZodOptional<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>>;
+    notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    customsTotalPaise: z.ZodOptional<z.ZodNumber>;
+    shippingTotalPaise: z.ZodOptional<z.ZodNumber>;
+    laborHoursSpent: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    laborRatePaisePerHour: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    status?: "received" | "cancelled" | "processing" | "ordered" | "completed" | "planning" | "in_transit" | "customs" | undefined;
+    notes?: string | undefined;
+    trackingNumber?: string | undefined;
+    shipmentNumber?: string | undefined;
+    etaDate?: string | Date | undefined;
+    supplierName?: string | undefined;
+    originCountry?: string | undefined;
+    carrier?: string | undefined;
+    receivedDate?: string | Date | undefined;
+    customsTotalPaise?: number | undefined;
+    shippingTotalPaise?: number | undefined;
+    laborHoursSpent?: number | undefined;
+    laborRatePaisePerHour?: number | undefined;
+}, {
+    status?: "received" | "cancelled" | "processing" | "ordered" | "completed" | "planning" | "in_transit" | "customs" | undefined;
+    notes?: string | undefined;
+    trackingNumber?: string | undefined;
+    shipmentNumber?: string | undefined;
+    etaDate?: string | Date | undefined;
+    supplierName?: string | undefined;
+    originCountry?: string | undefined;
+    carrier?: string | undefined;
+    receivedDate?: string | Date | undefined;
+    customsTotalPaise?: number | undefined;
+    shippingTotalPaise?: number | undefined;
+    laborHoursSpent?: number | undefined;
+    laborRatePaisePerHour?: number | undefined;
+}>;
+export declare const createShipmentLotSchema: z.ZodObject<{
+    lotName: z.ZodString;
+    supplierOrderRef: z.ZodOptional<z.ZodString>;
+    weightGrams: z.ZodNumber;
+    purchaseCostPaise: z.ZodNumber;
+    images: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodEnum<["image", "video", "file"]>;
+        alt: z.ZodOptional<z.ZodString>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+    }, {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+    }>, "many">>>;
+    remainderItemCount: z.ZodOptional<z.ZodNumber>;
+    remainderEstimatedValuePaise: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    images: {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+    }[];
+    lotName: string;
+    weightGrams: number;
+    purchaseCostPaise: number;
+    supplierOrderRef?: string | undefined;
+    remainderItemCount?: number | undefined;
+    remainderEstimatedValuePaise?: number | undefined;
+}, {
+    lotName: string;
+    weightGrams: number;
+    purchaseCostPaise: number;
+    images?: {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+    }[] | undefined;
+    supplierOrderRef?: string | undefined;
+    remainderItemCount?: number | undefined;
+    remainderEstimatedValuePaise?: number | undefined;
+}>;
+export declare const updateShipmentLotSchema: z.ZodObject<{
+    lotName: z.ZodOptional<z.ZodString>;
+    supplierOrderRef: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    weightGrams: z.ZodOptional<z.ZodNumber>;
+    purchaseCostPaise: z.ZodOptional<z.ZodNumber>;
+    images: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodEnum<["image", "video", "file"]>;
+        alt: z.ZodOptional<z.ZodString>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
+        youtubeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+    }, {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+    }>, "many">>>>;
+    remainderItemCount: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    remainderEstimatedValuePaise: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    images?: {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+    }[] | undefined;
+    lotName?: string | undefined;
+    supplierOrderRef?: string | undefined;
+    weightGrams?: number | undefined;
+    purchaseCostPaise?: number | undefined;
+    remainderItemCount?: number | undefined;
+    remainderEstimatedValuePaise?: number | undefined;
+}, {
+    images?: {
+        type: "video" | "image" | "file";
+        url: string;
+        source?: "upload" | "youtube" | "external" | undefined;
+        alt?: string | undefined;
+        thumbnailUrl?: string | undefined;
+        youtubeId?: string | undefined;
+    }[] | undefined;
+    lotName?: string | undefined;
+    supplierOrderRef?: string | undefined;
+    weightGrams?: number | undefined;
+    purchaseCostPaise?: number | undefined;
+    remainderItemCount?: number | undefined;
+    remainderEstimatedValuePaise?: number | undefined;
+}>;
+export declare const createShipmentItemSchema: z.ZodEffects<z.ZodObject<{
+    title: z.ZodString;
+    quantity: z.ZodNumber;
+    isForSelfUse: z.ZodBoolean;
+    price: z.ZodOptional<z.ZodNumber>;
+    condition: z.ZodOptional<z.ZodEnum<["new", "like_new", "good", "fair", "poor", "used", "refurbished", "broken", "graded"]>>;
+    categorySlugs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    brandSlug: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+}, {
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+}>, {
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+}, {
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+}>;
+export declare const updateShipmentItemSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodOptional<z.ZodNumber>;
+    isForSelfUse: z.ZodOptional<z.ZodBoolean>;
+    price: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    condition: z.ZodOptional<z.ZodOptional<z.ZodEnum<["new", "like_new", "good", "fair", "poor", "used", "refurbished", "broken", "graded"]>>>;
+    categorySlugs: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    brandSlug: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+} & {
+    linkedProductId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    linkedProductSlug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    linkedProductListingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["standard", "auction", "pre-order", "prize-draw", "classified", "digital-code", "live", "art", "stickers"]>>>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+    quantity?: number | undefined;
+    isForSelfUse?: boolean | undefined;
+    linkedProductId?: string | null | undefined;
+    linkedProductSlug?: string | null | undefined;
+    linkedProductListingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | "art" | "stickers" | null | undefined;
+}, {
+    title?: string | undefined;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+    quantity?: number | undefined;
+    isForSelfUse?: boolean | undefined;
+    linkedProductId?: string | null | undefined;
+    linkedProductSlug?: string | null | undefined;
+    linkedProductListingType?: "standard" | "auction" | "pre-order" | "prize-draw" | "classified" | "digital-code" | "live" | "art" | "stickers" | null | undefined;
+}>;
+/**
+ * Bulk paste-import payload — capped at MAX_ITEMS_PER_LOT (500), matching
+ * Firestore's native batched-write limit so the route can write the whole
+ * import in one WriteBatch with no chunking logic.
+ */
+export declare const bulkShipmentItemsSchema: z.ZodEffects<z.ZodArray<z.ZodObject<{
+    title: z.ZodString;
+    quantity: z.ZodNumber;
+    isForSelfUse: z.ZodBoolean;
+    price: z.ZodOptional<z.ZodNumber>;
+    condition: z.ZodOptional<z.ZodEnum<["new", "like_new", "good", "fair", "poor", "used", "refurbished", "broken", "graded"]>>;
+    categorySlugs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    brandSlug: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+}, {
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+}>, "many">, {
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+}[], {
+    title: string;
+    quantity: number;
+    isForSelfUse: boolean;
+    notes?: string | undefined;
+    categorySlugs?: string[] | undefined;
+    brandSlug?: string | undefined;
+    price?: number | undefined;
+    condition?: "new" | "used" | "refurbished" | "like_new" | "good" | "fair" | "poor" | "broken" | "graded" | undefined;
+}[]>;
+export type CreateShipmentInput = z.infer<typeof createShipmentSchema>;
+export type UpdateShipmentInput = z.infer<typeof updateShipmentSchema>;
+export type CreateShipmentLotInput = z.infer<typeof createShipmentLotSchema>;
+export type UpdateShipmentLotInput = z.infer<typeof updateShipmentLotSchema>;
+export type CreateShipmentItemInput = z.infer<typeof createShipmentItemSchema>;
+export type UpdateShipmentItemInput = z.infer<typeof updateShipmentItemSchema>;
+export type BulkShipmentItemsInput = z.infer<typeof bulkShipmentItemsSchema>;