@mohasinac/appkit 4.33.0 → 4.34.0

package/dist/seed/products-preorders-seed-data.d.ts

@@ -1,138 +1,2 @@
-export declare const productsPreordersSeedData: {
-    listingType: "pre-order";
-    searchTxt: string[];
-    title?: string | undefined;
-    description?: string | undefined;
-    slug?: string | undefined;
-    isTestData?: boolean | undefined;
-    testDataExpiresAt?: Date | undefined;
-    seoTitle?: string | undefined;
-    seoDescription?: string | undefined;
-    seoKeywords?: string[] | undefined;
-    categorySlugs?: string[] | undefined;
-    categoryNames?: string[] | undefined;
-    category?: string | undefined;
-    categoryName?: string | undefined;
-    subcategory?: string | undefined;
-    brand?: string | undefined;
-    brandSlug?: string | undefined;
-    price?: number | undefined;
-    currency?: string | undefined;
-    stockQuantity: number;
-    availableQuantity?: number | undefined;
-    mainImage: string;
-    images?: string[] | undefined;
-    video?: import("..").ProductVideoField | undefined;
-    status?: import("..").ProductStatus | undefined;
-    storeId?: string | undefined;
-    storeName?: string | undefined;
-    storeSlug?: string | undefined;
-    storeRating?: number | undefined;
-    storeReviewCount?: number | undefined;
-    featured?: boolean | undefined;
-    tags: string[];
-    specifications?: import("..").ProductSpecification[] | undefined;
-    features?: string[] | undefined;
-    shippingInfo?: string | undefined;
-    returnPolicy?: string | undefined;
-    condition?: "new" | "like_new" | "good" | "fair" | "poor" | "used" | "refurbished" | "broken" | "graded" | undefined;
-    insurance?: boolean | undefined;
-    insuranceCost?: number | undefined;
-    shippingPaidBy?: "seller" | "buyer" | undefined;
-    auctionEndDate?: Date | undefined;
-    startingBid?: number | undefined;
-    currentBid?: number | undefined;
-    bidCount?: number | undefined;
-    leadingBidderId?: string | undefined;
-    reservePrice?: number | undefined;
-    buyNowPrice?: number | undefined;
-    minBidIncrement?: number | undefined;
-    autoExtendable?: boolean | undefined;
-    auctionExtensionMinutes?: number | undefined;
-    auctionOriginalEndDate?: Date | undefined;
-    auctionShippingPaidBy?: "seller" | "winner" | undefined;
-    bidsHaveStarted?: boolean | undefined;
-    grading?: import("../features/products").ProductGrading | undefined;
-    card?: import("../features/products").ProductCardMetadata | undefined;
-    classified?: import("../features/products").ProductClassifiedMeta | undefined;
-    digitalCode?: import("../features/products").ProductDigitalCodeMeta | undefined;
-    liveItem?: import("../features/products").ProductLiveItemMeta | undefined;
-    catalogProductId?: string | undefined;
-    preOrderDeliveryDate?: Date | undefined;
-    preOrderDepositPercent?: number | undefined;
-    preOrderDepositAmount?: number | undefined;
-    preOrderMaxQuantity?: number | undefined;
-    preOrderCurrentCount?: number | undefined;
-    preOrderProductionStatus?: "upcoming" | "in_production" | "ready_to_ship" | undefined;
-    preOrderCancellable?: boolean | undefined;
-    preOrderClosed?: boolean | undefined;
-    isPromoted?: boolean | undefined;
-    isOnSale?: boolean | undefined;
-    isSold?: boolean | undefined;
-    allowShipBeforeEmiComplete?: boolean | undefined;
-    gstRate?: 0 | 5 | 12 | 18 | 28 | undefined;
-    hsnCode?: string | undefined;
-    printMeta?: import("../features/products").ProductPrintMeta | undefined;
-    promotionEndDate?: Date | undefined;
-    pickupAddressId?: string | undefined;
-    viewCount?: number | undefined;
-    avgRating?: number | undefined;
-    reviewCount?: number | undefined;
-    bulkDiscounts?: {
-        quantity: number;
-        discountPercent: number;
-    }[] | undefined;
-    ingredients?: string[] | undefined;
-    howToUse?: string[] | undefined;
-    allowOffers?: boolean | undefined;
-    minOfferPercent?: number | undefined;
-    customFields?: import("../features/products").CustomField[] | undefined;
-    customSections?: import("../features/products").CustomSection[] | undefined;
-    sublistingCategoryId?: string | undefined;
-    groupId?: string | undefined;
-    isGroupParent?: boolean | undefined;
-    groupParentSlug?: string | undefined;
-    groupChildSlugs?: string[] | undefined;
-    groupTitle?: string | undefined;
-    groupIcon?: string | undefined;
-    sublistingIcon?: string | undefined;
-    maxPerUser?: number | undefined;
-    partOfBundleIds?: string[] | undefined;
-    partOfBundleTitles?: string[] | undefined;
-    isPartOfBundle?: boolean | undefined;
-    sourceShipmentId?: string | undefined;
-    sourceShipmentLotId?: string | undefined;
-    sourceShipmentItemId?: string | undefined;
-    sourceCatalogueItemId?: string | undefined;
-    sourceCatalogueOwnerId?: string | undefined;
-    prizeDrawItems?: import("../features/products").PrizeDrawItem[] | undefined;
-    pricePerEntry?: number | undefined;
-    prizeMaxEntries?: number | undefined;
-    prizeCurrentEntries?: number | undefined;
-    prizeRevealWindowStart?: Date | undefined;
-    prizeRevealWindowEnd?: Date | undefined;
-    prizeRevealStatus?: "pending" | "open" | "closed" | undefined;
-    prizeDrawDurationDays?: number | undefined;
-    prizeGithubFileUrl?: string | undefined;
-    prizeDrawMode?: "reveal" | "lottery" | undefined;
-    prizeRevealMode?: "instant" | "scheduled" | undefined;
-    lotteryConfig?: import("..").LotteryConfig | undefined;
-    shipping?: {
-        allowedProviderIds?: string[];
-        overrides?: Array<{
-            providerId: string;
-            fee?: number;
-            etaDaysMin?: number;
-            etaDaysMax?: number;
-        }>;
-    } | undefined;
-    physicalLocation?: {
-        zone: string;
-        shelf: string;
-        bin: string;
-    } | undefined;
-    barcodeId?: string | undefined;
-    id?: string | undefined;
-    createdAt?: Date | undefined;
-    updatedAt?: Date | undefined;
-}[];
+import { ProductDocument } from "../features/products/schemas/firestore";
+export declare const productsPreordersSeedData: Partial<ProductDocument>[];

package/dist/seed/products-preorders-seed-data.js

@@ -22,6 +22,7 @@
 import { PRODUCT_FIELDS } from "../constants/field-names";
 import { buildSearchTxt } from "../utils/search-txt";
 import { seedPhoto } from "./_helpers/media";
+import { withFinalSale } from "./_helpers/final-sale-fixtures";
 const _rawPreordersSeedData = [
     {
         id: "preorder-beyblade-x-bx-08-wave",
@@ -296,7 +297,7 @@ const _rawPreordersSeedData = [
         updatedAt: new Date("2026-08-24"),
     },
 ];
-export const productsPreordersSeedData = _rawPreordersSeedData.map((p) => ({
+export const productsPreordersSeedData = _rawPreordersSeedData.map((p) => withFinalSale({
     tags: [],
     stockQuantity: p.availableQuantity ?? 1,
     mainImage: p.images?.[0] ?? "",

package/dist/seed/products-prize-draws-seed-data.js

@@ -22,6 +22,7 @@ import { withProductSearchTxt } from "./_helpers/product-search-txt";
 import { PRODUCT_FIELDS } from "../constants/field-names";
 import { buildSearchTxt } from "../utils/search-txt";
 import { seedPhoto } from "./_helpers/media";
+import { withFinalSale } from "./_helpers/final-sale-fixtures";
 const _rawproductsPrizeDrawsSeedData = [
     {
         id: "prizedraw-beyblade-mystery-box",
@@ -408,4 +409,4 @@ const _rawproductsPrizeDrawsSeedData = [
  * the bottom of the array cannot ship without it — which is exactly how the
  * sold/depleted fixture in this file ended up unsearchable.
  */
-export const productsPrizeDrawsSeedData = _rawproductsPrizeDrawsSeedData.map(withProductSearchTxt);
+export const productsPrizeDrawsSeedData = _rawproductsPrizeDrawsSeedData.map(withProductSearchTxt).map(withFinalSale);

package/dist/seed/products-standard-seed-data.js

@@ -25,6 +25,7 @@
 import { PRODUCT_FIELDS } from "../constants/field-names";
 import { buildSearchTxt } from "../utils/search-txt";
 import { seedPhoto } from "./_helpers/media";
+import { withFinalSale } from "./_helpers/final-sale-fixtures";
 /*
  * Real Beyblade attributes per fixture — Root Cause #6 (standard was the
  * "richest" seed file by fixture count but never exercised customFields/
@@ -648,4 +649,4 @@ export const productsStandardSeedData = [
         ...(p.id ? SPEC_OVERRIDES[p.id] : undefined),
         listingType: PRODUCT_FIELDS.LISTING_TYPE_VALUES.STANDARD,
     })),
-];
+].map(withFinalSale);

package/dist/seed/products-stickers-seed-data.js

@@ -19,7 +19,8 @@
 import { PRODUCT_FIELDS } from "../constants/field-names";
 import { buildSearchTxt } from "../utils/search-txt";
 import { seedPhoto } from "./_helpers/media";
-export const productsStickersSeedData = [
+import { withFinalSale } from "./_helpers/final-sale-fixtures";
+const _rawProductsStickersSeedData = [
     {
         id: "stickers-beyblade-original-classic-sheet",
         slug: "stickers-beyblade-original-classic-sheet",
@@ -264,3 +265,10 @@ export const productsStickersSeedData = [
         ]),
     },
 ];
+/*
+ * This file had no export wrapper at all — every other product seed file maps
+ * its raw array through one, and these two were the exception. Adding it here
+ * so the final-sale opt-outs are applied the same way everywhere rather than
+ * being hand-written into two records that reviewers would have to find.
+ */
+export const productsStickersSeedData = _rawProductsStickersSeedData.map(withFinalSale);

package/dist/server.d.ts

@@ -8,7 +8,7 @@ export { wrapAction, isOk, unwrap, } from "./_internal/shared/types/action-resul
 export type { ActionResult } from "./_internal/shared/types/action-result";
 export { setActionErrorReporter, hasActionErrorReporter, } from "./_internal/shared/types/action-error-reporter";
 export type { ActionErrorReport, ActionErrorReporter, } from "./_internal/shared/types/action-error-reporter";
-export { attachPaymentProofAction, adminVerifyPaymentAction, adminRequestProofReuploadAction, adminRejectPaymentAsFraudAction, raiseOrderDisputeAction, } from "./_internal/server/features/orders/actions";
+export { attachPaymentProofAction, adminVerifyPaymentAction, adminRequestProofReuploadAction, adminRejectPaymentAsFraudAction, raiseOrderDisputeAction, requestReturnAction, } from "./_internal/server/features/orders/actions";
 export { wrapJobHandler, wrapScheduleHandler, wrapTriggerHandler, wrapCallableHandler, } from "./_internal/server/jobs/core/wrapJobHandler";
 export { analyzeLogs } from "./_internal/server/features/maintenance/analyze";
 export type { AnalyzeOptions, AnalyzeReport, } from "./_internal/server/features/maintenance/analyze";
@@ -530,7 +530,7 @@ export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_
 export type { ListingTypePlugin } from "./_internal/shared/listing-types/_registry";
 export { applyMediaContextGuards, CONTEXT_LIMITS, } from "./_internal/server/features/media/contextGuards";
 export type { GuardResult, GuardError, GuardSuccess } from "./_internal/server/features/media/contextGuards";
-export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, } from "./_internal/shared/media/limits";
+export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, PRODUCT_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "./_internal/shared/media/limits";
 export type { MediaKind, AllowedImageMime, AllowedVideoMime, AllowedDocMime, AllowedMime, } from "./_internal/shared/media/limits";
 export { getServerPermissions, checkPermission, checkAnyPermission, makeAdminSectionLayout, } from "./_internal/server/features/auth/permissions";
 export type { ResolvedPermissions, AdminSectionLayoutOpts, } from "./_internal/server/features/auth/permissions";
@@ -581,3 +581,7 @@ export { validateActionIndexEntry, normaliseRoute, } from "./features/search/act
 export type { ActionIndexValidationContext, ActionIndexValidationIssue, } from "./features/search/action-index/validate-entry";
 export { ActionIndexRepository, actionIndexRepository, } from "./features/search/action-index/repository";
 export type { ActionIndexDocument } from "./features/search/action-index/repository";
+export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
+export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons";
+export type { ReturnReason } from "./_internal/shared/features/orders/return-reasons";
+export { draftToProductInput, productToDraft, } from "./features/seller/utils/product-draft-mapping";

package/dist/server.js

@@ -17,7 +17,11 @@ export { wrapAction, isOk, unwrap, } from "./_internal/shared/types/action-resul
 // server-side rather than from a client bootstrap.
 export { setActionErrorReporter, hasActionErrorReporter, } from "./_internal/shared/types/action-error-reporter";
 // [SERVER-ONLY] P-1 manual payment proof server actions.
-export { attachPaymentProofAction, adminVerifyPaymentAction, adminRequestProofReuploadAction, adminRejectPaymentAsFraudAction, raiseOrderDisputeAction, } from "./_internal/server/features/orders/actions";
+export { attachPaymentProofAction, adminVerifyPaymentAction, adminRequestProofReuploadAction, adminRejectPaymentAsFraudAction, raiseOrderDisputeAction, 
+// Buyer return request. Was reachable only through `server-entry.ts`, which
+// is the bare `@mohasinac/appkit` specifier — not `/server`, where every
+// other order action lives and where a consumer would look for it.
+requestReturnAction, } from "./_internal/server/features/orders/actions";
 // [SERVER-ONLY] Cloud Function handler wrappers — persist exceptions to
 // serverErrors (source: "function") before re-throwing so retry semantics
 // are preserved. Apply at the consumer's runtime adapter boundary.
@@ -1389,7 +1393,7 @@ export { LISTING_TYPE_REGISTRY, pluginFor, detectListingTypeFromSlug } from "./_
 // Media context guards — shared by /api/media/sign + legacy /api/media/upload.
 export { applyMediaContextGuards, CONTEXT_LIMITS, } from "./_internal/server/features/media/contextGuards";
 // Media upload limits — shared by /api/media/sign + /api/media/finalize + /api/media/upload.
-export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, } from "./_internal/shared/media/limits";
+export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, PRODUCT_MAX_IMAGES, PRODUCT_MAX_VIDEOS, PRODUCT_IMAGE_INDEX_MAX, } from "./_internal/shared/media/limits";
 // ── RBAC server helpers ───────────────────────────────────────────────────────
 // getServerPermissions, checkPermission, makeAdminSectionLayout
 export { getServerPermissions, checkPermission, checkAnyPermission, makeAdminSectionLayout, } from "./_internal/server/features/auth/permissions";
@@ -1452,3 +1456,12 @@ export { COUNTRIES, COUNTRY_CODES, DEFAULT_COUNTRY, countryFor, postalPatternFor
 export { SUBDIVISIONS, subdivisionsFor } from "./constants/geo/subdivisions";
 export { validateActionIndexEntry, normaliseRoute, } from "./features/search/action-index/validate-entry";
 export { ActionIndexRepository, actionIndexRepository, } from "./features/search/action-index/repository";
+export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
+// Return / refund reasons — the closed enum the final-sale gate branches on.
+// See the module docstring for why the exempt set is "seller or carrier fault"
+// rather than "serious reasons".
+export { RETURN_REASON, FINAL_SALE_EXEMPT_REASONS, RETURN_REASON_LABEL, RETURN_REASON_GROUP_LABEL, isFinalSaleExempt, isReturnReason, selectableReturnReasons, } from "./_internal/shared/features/orders/return-reasons";
+// Seller listing form draft <-> product write payload. The flat form keys and
+// the nested document blocks are different shapes, and nothing translated
+// between them — see the module docstring.
+export { draftToProductInput, productToDraft, } from "./features/seller/utils/product-draft-mapping";