@mohasinac/appkit 2.6.1 → 2.6.3

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

@@ -16,6 +16,7 @@ export const CATEGORIES_INDEXED_FIELDS = [
     "isFeatured",
     "featuredPriority",
     "isBrand",
+    "categoryType",
     "isActive",
     "isSearchable",
     "showOnHomepage",
@@ -97,7 +98,12 @@ export const categoryQueryHelpers = {
     byRootId: (rootId) => ["rootId", "==", rootId],
     children: (parentId) => ["parentIds", "array-contains", parentId],
     featured: () => ["isFeatured", "==", true],
+    /** @deprecated Use byCategoryType("brand"). */
     brands: () => ["isBrand", "==", true],
+    /** SB-UNI B + C + D — discriminator-based listing. */
+    byCategoryType: (type) => ["categoryType", "==", type],
+    sublistings: () => ["categoryType", "==", "sublisting"],
+    brandPages: () => ["categoryType", "==", "brand"],
     active: () => ["isActive", "==", true],
     searchable: () => ["isSearchable", "==", true],
     byCreator: (userId) => ["createdBy", "==", userId],

package/dist/features/categories/types/index.d.ts

@@ -1,4 +1,4 @@
-export type CategoryType = "category" | "concern" | "collection" | "brand";
+export type CategoryType = "category" | "sublisting" | "brand" | "bundle";
 export interface CategorySeo {
     title?: string;
     description?: string;
@@ -24,7 +24,15 @@ export interface CategoryAncestor {
 }
 export interface CategoryItem {
     id: string;
-    type?: CategoryType;
+    categoryType?: CategoryType;
+    /** Sublisting/grading code, e.g. "108/120" or "PSA 10" — only set when categoryType==="sublisting". */
+    itemCode?: string;
+    /** Brand website — only set when categoryType==="brand". */
+    brandWebsite?: string;
+    /** Brand country — only set when categoryType==="brand". */
+    brandCountry?: string;
+    /** Brand founded year — only set when categoryType==="brand". */
+    brandFounded?: number;
     name: string;
     slug: string;
     description?: string;
@@ -38,7 +46,7 @@ export interface CategoryItem {
     metrics?: CategoryMetrics;
     isFeatured?: boolean;
     featuredPriority?: number;
-    /** @deprecated Use type === "brand" */ isBrand?: boolean;
+    /** @deprecated Use categoryType === "brand" */ isBrand?: boolean;
     seo?: CategorySeo;
     display?: CategoryDisplay;
     ancestors?: CategoryAncestor[];

package/dist/features/events/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/events/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for event/eventEntry.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `events: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

package/dist/features/faq/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/faq/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for faq.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `faq: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

package/dist/features/grouped/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/grouped/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for groupedListing.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `grouped: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

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

@@ -1,13 +1,28 @@
 /**
  * Grouped Listings Firestore Document Types & Constants
  *
- * A grouped listing bundles multiple products together, optionally at a
- * discounted bundle price. Standard products and pre-orders only — auctions
- * are excluded per GP1 spec. Displayed as a horizontal scroller of circular
- * thumbnail cards between the buy-box and the TABS row on the detail page.
+ * SB-UNI-V re-scoped this from a "bundle-like" pricing construct (with
+ * `bundlePrice` / `originalPrice` / `discountPercent`) to a **theme group**
+ * — a horizontal scroller that links related listings on the detail page
+ * without any pricing semantics. Pricing-aware bundles now live on the
+ * categories collection with `categoryType:"bundle"` (SB-UNI-D).
  *
- * Used in Session 86 (GP1–GP2).
+ * A grouped listing survives partial sellout: when the count of currently-
+ * active members drops below `minActiveMembers`, `visibilityStatus` flips
+ * to "hidden" (recomputed by `onProductStockChange`).
  */
+export type GroupTheme = 
+/** "Other anime figures you might like" */
+"related"
+/** "Same character across multiple lines" */
+ | "character"
+/** "All HG kits in this lineage" */
+ | "lineage"
+/** "From the same set / wave / drop" */
+ | "set"
+/** Default / unspecified theme */
+ | "generic";
+export type GroupVisibility = "visible" | "hidden";
 export interface GroupedListingDocument {
     id: string;
     slug: string;
@@ -15,10 +30,14 @@ export interface GroupedListingDocument {
     description?: string;
     productIds: string[];
     coverImage?: string;
-    bundlePrice?: number;
-    originalPrice?: number;
-    discountPercent?: number;
-    currency: "INR";
+    /** SB-UNI-V — semantic label for the group (drives section heading copy). */
+    groupTheme: GroupTheme;
+    /** Hide the group if fewer than this many members are active. Default 2. */
+    minActiveMembers: number;
+    /** Count of currently-active members. Maintained by onProductStockChange. */
+    activeMemberCount: number;
+    /** Computed from activeMemberCount < minActiveMembers. */
+    visibilityStatus: GroupVisibility;
     isActive: boolean;
     isFeatured: boolean;
     storeId?: string;
@@ -29,4 +48,4 @@ export interface GroupedListingDocument {
     updatedAt: Date;
 }
 export declare const GROUPED_LISTINGS_COLLECTION: "groupedListings";
-export declare const GROUPED_LISTINGS_INDEXED_FIELDS: readonly ["storeId", "brandSlug", "categorySlug", "isActive", "isFeatured", "createdAt"];
+export declare const GROUPED_LISTINGS_INDEXED_FIELDS: readonly ["storeId", "brandSlug", "categorySlug", "isActive", "isFeatured", "groupTheme", "visibilityStatus", "createdAt"];

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

@@ -1,12 +1,15 @@
 /**
  * Grouped Listings Firestore Document Types & Constants
  *
- * A grouped listing bundles multiple products together, optionally at a
- * discounted bundle price. Standard products and pre-orders only — auctions
- * are excluded per GP1 spec. Displayed as a horizontal scroller of circular
- * thumbnail cards between the buy-box and the TABS row on the detail page.
+ * SB-UNI-V re-scoped this from a "bundle-like" pricing construct (with
+ * `bundlePrice` / `originalPrice` / `discountPercent`) to a **theme group**
+ * — a horizontal scroller that links related listings on the detail page
+ * without any pricing semantics. Pricing-aware bundles now live on the
+ * categories collection with `categoryType:"bundle"` (SB-UNI-D).
  *
- * Used in Session 86 (GP1–GP2).
+ * A grouped listing survives partial sellout: when the count of currently-
+ * active members drops below `minActiveMembers`, `visibilityStatus` flips
+ * to "hidden" (recomputed by `onProductStockChange`).
  */
 export const GROUPED_LISTINGS_COLLECTION = "groupedListings";
 export const GROUPED_LISTINGS_INDEXED_FIELDS = [
@@ -15,5 +18,7 @@ export const GROUPED_LISTINGS_INDEXED_FIELDS = [
     "categorySlug",
     "isActive",
     "isFeatured",
+    "groupTheme",
+    "visibilityStatus",
     "createdAt",
 ];

package/dist/features/history/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/history/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for history.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `history: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

package/dist/features/homepage/hooks/useFeaturedAuctions.js

@@ -10,12 +10,12 @@ export function useFeaturedAuctions(options) {
         queryKey: ["auctions", "featured", options?.filterByBrand ?? "all"],
         initialData: options?.initialData,
         queryFn: async () => {
-            const promotedRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isAuction%3D%3Dtrue%2Cstatus%3D%3Dpublished%2CisPromoted%3D%3Dtrue${brandFilter}&pageSize=18`);
+            const promotedRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=listingType%3D%3Dauction%2Cstatus%3D%3Dpublished%2CisPromoted%3D%3Dtrue${brandFilter}&pageSize=18`);
             const promoted = promotedRes?.items ?? [];
             if (promoted.length >= MIN_COUNT)
                 return promoted;
             const remaining = MIN_COUNT - promoted.length;
-            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isAuction%3D%3Dtrue%2Cstatus%3D%3Dpublished${brandFilter}&sorts=-createdAt&pageSize=${remaining + promoted.length}`);
+            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=listingType%3D%3Dauction%2Cstatus%3D%3Dpublished${brandFilter}&sorts=-createdAt&pageSize=${remaining + promoted.length}`);
             const latest = latestRes?.items ?? [];
             const existingIds = new Set(promoted.map((a) => a.id));
             const filler = latest

package/dist/features/homepage/hooks/useFeaturedPreOrders.js

@@ -10,12 +10,12 @@ export function useFeaturedPreOrders(options) {
         queryKey: ["pre-orders", "featured", options?.filterByBrand ?? "all"],
         initialData: options?.initialData,
         queryFn: async () => {
-            const featuredRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isPreOrder%3D%3Dtrue%2Cstatus%3D%3Dpublished${brandFilter}&sorts=preOrderDeliveryDate&pageSize=6`);
+            const featuredRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=listingType%3D%3Dpre-order%2Cstatus%3D%3Dpublished${brandFilter}&sorts=preOrderDeliveryDate&pageSize=6`);
             const featured = featuredRes?.items ?? [];
             if (featured.length >= MIN_COUNT)
                 return featured;
             const remaining = MIN_COUNT - featured.length;
-            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=isPreOrder%3D%3Dtrue%2Cstatus%3D%3Dpublished${brandFilter}&sorts=-createdAt&pageSize=${remaining + featured.length}`);
+            const latestRes = await apiClient.get(`${PRODUCT_ENDPOINTS.LIST}?filters=listingType%3D%3Dpre-order%2Cstatus%3D%3Dpublished${brandFilter}&sorts=-createdAt&pageSize=${remaining + featured.length}`);
             const latest = latestRes?.items ?? [];
             const existingIds = new Set(featured.map((p) => p.id));
             const filler = latest

package/dist/features/homepage/lib/section-renderer.js

@@ -25,7 +25,8 @@ import { BrandsSection } from "../components/BrandsSection";
 import { SocialFeedSection } from "../components/SocialFeedSection";
 import { CustomCardsSection } from "../components/CustomCardsSection";
 import { GoogleReviewsSection } from "../components/GoogleReviewsSection";
-import { FeaturedBundlesSection } from "../../bundles/components/FeaturedBundlesSection";
+// SB-UNI-V — FeaturedBundlesSection deleted; bundle homepage section to be
+// rebuilt against categoryType:"bundle" queries in a follow-up cohort.
 import { PrizeDrawsSection } from "../../products/components/PrizeDrawsSection";
 import { EventRafflesSection } from "../../events/components/EventRafflesSection";
 import { CollectionCardsSection } from "../components/CollectionCardsSection";
@@ -174,8 +175,9 @@ function renderSectionElement(section, newsletterFormSlot, faqItems, slides, liv
             return (_jsx(GoogleReviewsSection, { placeId: cfg?.placeId ?? "", maxReviews: cfg?.maxReviews ?? 6, minRating: cfg?.minRating ?? 0, layout: cfg?.layout ?? "grid", showRating: cfg?.showRating ?? true, showDate: cfg?.showDate ?? true, linkToGoogleMaps: cfg?.linkToGoogleMaps ?? true, googleMapsUrl: cfg?.googleMapsUrl }));
         }
         case "featured-bundles": {
-            const cfg = config;
-            return _jsx(FeaturedBundlesSection, { config: cfg ?? {} });
+            // SB-UNI-V — FeaturedBundlesSection deleted with features/bundles/. The
+            // category-based replacement lands in a follow-up.
+            return null;
         }
         case "prize-draws": {
             const cfg = config;

package/dist/features/media/AvatarUpload.js

@@ -24,7 +24,7 @@ export function AvatarUpload({ currentPhotoURL, currentCropData, userId, display
     const [pendingUploadFile, setPendingUploadFile] = useState(null);
     const fileInputRef = useRef(null);
     const { showToast } = useToast();
-    const { mutateAsync: uploadMedia, isPending: isUploading, error: uploadApiError, } = useMediaUpload();
+    const { upload: uploadMedia, isPending: isUploading, error: uploadApiError, } = useMediaUpload();
     useEffect(() => {
         const hasPending = pendingCropData !== null && pendingUploadFile !== null;
         onPendingStateChange?.(hasPending);
@@ -53,37 +53,15 @@ export function AvatarUpload({ currentPhotoURL, currentCropData, userId, display
     const handleConfirmSave = async () => {
         if (!pendingUploadFile || !pendingCropData)
             return;
-        const formData = new FormData();
-        formData.append("file", pendingUploadFile);
         const nameParts = (displayName ?? "").trim().split(/\s+/).filter(Boolean);
         const firstName = nameParts[0] || userId;
         const lastName = nameParts.slice(1).join("-") || firstName;
-        formData.append("context", JSON.stringify({
-            type: "user-avatar",
-            firstName,
-            lastName,
-        }));
-        formData.append("folder", "users");
-        formData.append("public", "true");
-        formData.append("metadata", JSON.stringify({
-            cropX: 0,
-            cropY: 0,
-            cropWidth: 400,
-            cropHeight: 400,
-            zoom: pendingCropData.zoom ?? 1,
-            focalX: (pendingCropData.position?.x ?? 50) / 100,
-            focalY: (pendingCropData.position?.y ?? 50) / 100,
-            aspectRatio: "1:1",
-            objectFit: "cover",
-            displayMode: "avatar",
-            originalWidth: 400,
-            originalHeight: 400,
-            mimeType: pendingUploadFile.type,
-            fileSize: pendingUploadFile.size,
-        }));
         try {
-            const result = await uploadMedia(formData);
-            const downloadURL = result.url;
+            const downloadURL = await uploadMedia(pendingUploadFile, "users", true, {
+                type: "user-avatar",
+                firstName,
+                lastName,
+            });
             await onUploadSuccess?.(downloadURL, pendingCropData);
             setPreviewUrl(downloadURL);
             setCropData(pendingCropData);

package/dist/features/media/hooks/useMedia.d.ts

@@ -1,8 +1,14 @@
 /**
  * useMedia — upload/crop/trim hooks for @mohasinac/feat-media.
  *
- * Wraps @mohasinac/http apiClient via TanStack Query mutations.
- * Endpoint paths can be overridden per call for non-standard deployments.
+ * useMediaUpload uses the signed-URL flow:
+ *   1. POST /api/media/sign — server issues v4 signed PUT URL
+ *   2. PUT directly to GCS — bytes bypass the Vercel function (Rule #6)
+ *   3. POST /api/media/finalize — server runs magic-byte check + returns URL
+ *
+ * The hook surface (`upload(file, folder, isPublic, context) => Promise<string>`)
+ * is unchanged so existing field components (MediaUploadField, MediaUploadList,
+ * ImageUpload, MediaPickerModal) keep working without modification.
  */
 import type { MediaFilenameContext } from "../../../utils/id-generators";
 export interface MediaUploadResult {
@@ -12,6 +18,12 @@ export interface MediaUploadResult {
     size?: number;
     type?: string;
 }
+interface UploadVariables {
+    file: File;
+    folder: string;
+    isPublic: boolean;
+    context?: MediaFilenameContext | Record<string, unknown>;
+}
 export interface MediaCropInput {
     sourceUrl: string;
     x: number;
@@ -31,13 +43,16 @@ export interface MediaTrimInput {
     quality?: "low" | "medium" | "high";
 }
 /**
- * useMediaUpload — uploads a file via FormData to /api/media/upload.
+ * useMediaUpload — uploads a file via the signed-URL flow.
  *
  * @example
  * const { upload, isPending } = useMediaUpload();
  * const url = await upload(file, "products", true);
  */
-export declare function useMediaUpload(endpoint?: string): {
+export declare function useMediaUpload(endpoints?: {
+    sign?: string;
+    finalize?: string;
+}): {
     upload: (file: File, folder?: string, isPublic?: boolean, context?: MediaFilenameContext | Record<string, unknown>) => Promise<string>;
     data: undefined;
     variables: undefined;
@@ -47,68 +62,68 @@ export declare function useMediaUpload(endpoint?: string): {
     isPending: false;
     isSuccess: false;
     status: "idle";
-    mutate: import("@tanstack/react-query").UseMutateFunction<MediaUploadResult, Error, FormData, unknown>;
+    mutate: import("@tanstack/react-query").UseMutateFunction<MediaUploadResult, Error, UploadVariables, unknown>;
     reset: () => void;
     context: unknown;
     failureCount: number;
     failureReason: Error | null;
     isPaused: boolean;
     submittedAt: number;
-    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<MediaUploadResult, Error, FormData, unknown>;
+    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<MediaUploadResult, Error, UploadVariables, unknown>;
 } | {
     upload: (file: File, folder?: string, isPublic?: boolean, context?: MediaFilenameContext | Record<string, unknown>) => Promise<string>;
     data: undefined;
-    variables: FormData;
+    variables: UploadVariables;
     error: null;
     isError: false;
     isIdle: false;
     isPending: true;
     isSuccess: false;
     status: "pending";
-    mutate: import("@tanstack/react-query").UseMutateFunction<MediaUploadResult, Error, FormData, unknown>;
+    mutate: import("@tanstack/react-query").UseMutateFunction<MediaUploadResult, Error, UploadVariables, unknown>;
     reset: () => void;
     context: unknown;
     failureCount: number;
     failureReason: Error | null;
     isPaused: boolean;
     submittedAt: number;
-    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<MediaUploadResult, Error, FormData, unknown>;
+    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<MediaUploadResult, Error, UploadVariables, unknown>;
 } | {
     upload: (file: File, folder?: string, isPublic?: boolean, context?: MediaFilenameContext | Record<string, unknown>) => Promise<string>;
     data: undefined;
     error: Error;
-    variables: FormData;
+    variables: UploadVariables;
     isError: true;
     isIdle: false;
     isPending: false;
     isSuccess: false;
     status: "error";
-    mutate: import("@tanstack/react-query").UseMutateFunction<MediaUploadResult, Error, FormData, unknown>;
+    mutate: import("@tanstack/react-query").UseMutateFunction<MediaUploadResult, Error, UploadVariables, unknown>;
     reset: () => void;
     context: unknown;
     failureCount: number;
     failureReason: Error | null;
     isPaused: boolean;
     submittedAt: number;
-    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<MediaUploadResult, Error, FormData, unknown>;
+    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<MediaUploadResult, Error, UploadVariables, unknown>;
 } | {
     upload: (file: File, folder?: string, isPublic?: boolean, context?: MediaFilenameContext | Record<string, unknown>) => Promise<string>;
     data: MediaUploadResult;
     error: null;
-    variables: FormData;
+    variables: UploadVariables;
     isError: false;
     isIdle: false;
     isPending: false;
     isSuccess: true;
     status: "success";
-    mutate: import("@tanstack/react-query").UseMutateFunction<MediaUploadResult, Error, FormData, unknown>;
+    mutate: import("@tanstack/react-query").UseMutateFunction<MediaUploadResult, Error, UploadVariables, unknown>;
     reset: () => void;
     context: unknown;
     failureCount: number;
     failureReason: Error | null;
     isPaused: boolean;
     submittedAt: number;
-    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<MediaUploadResult, Error, FormData, unknown>;
+    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<MediaUploadResult, Error, UploadVariables, unknown>;
 };
 /**
  * useMediaCrop — sends pixel-crop params to /api/media/crop.
@@ -202,3 +217,4 @@ export declare function useMediaCleanup(endpoint?: string): {
     submittedAt: number;
     mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, string[], unknown>;
 };
+export {};

package/dist/features/media/hooks/useMedia.js

@@ -1,33 +1,68 @@
 /**
  * useMedia — upload/crop/trim hooks for @mohasinac/feat-media.
  *
- * Wraps @mohasinac/http apiClient via TanStack Query mutations.
- * Endpoint paths can be overridden per call for non-standard deployments.
+ * useMediaUpload uses the signed-URL flow:
+ *   1. POST /api/media/sign — server issues v4 signed PUT URL
+ *   2. PUT directly to GCS — bytes bypass the Vercel function (Rule #6)
+ *   3. POST /api/media/finalize — server runs magic-byte check + returns URL
+ *
+ * The hook surface (`upload(file, folder, isPublic, context) => Promise<string>`)
+ * is unchanged so existing field components (MediaUploadField, MediaUploadList,
+ * ImageUpload, MediaPickerModal) keep working without modification.
  */
 import { useMutation } from "@tanstack/react-query";
 import { apiClient } from "../../../http";
+import { classifyMime, MAX_BYTES, MAX_LABEL, isAllowedMime, } from "../../../_internal/shared/media/limits";
 import { MEDIA_ENDPOINTS } from "../../../constants/api-endpoints";
 // --- Hooks --------------------------------------------------------------------
 /**
- * useMediaUpload — uploads a file via FormData to /api/media/upload.
+ * useMediaUpload — uploads a file via the signed-URL flow.
  *
  * @example
  * const { upload, isPending } = useMediaUpload();
  * const url = await upload(file, "products", true);
  */
-export function useMediaUpload(endpoint = MEDIA_ENDPOINTS.UPLOAD) {
+export function useMediaUpload(endpoints = {}) {
+    const signEndpoint = endpoints.sign ?? MEDIA_ENDPOINTS.SIGN;
+    const finalizeEndpoint = endpoints.finalize ?? MEDIA_ENDPOINTS.FINALIZE;
     const mutation = useMutation({
-        mutationFn: (formData) => apiClient.upload(endpoint, formData),
+        mutationFn: async ({ file, folder, isPublic, context }) => {
+            const contentType = file.type;
+            // Client-side precheck — fail fast before any network call. Catches
+            // image-vs-video kind mismatch and oversize files with the same
+            // user-facing message the server would have returned.
+            if (!isAllowedMime(contentType)) {
+                throw new Error(`Unsupported file type: ${contentType || "unknown"}`);
+            }
+            const kind = classifyMime(contentType);
+            if (file.size > MAX_BYTES[kind]) {
+                throw new Error(`File too large — ${kind} uploads must be ≤ ${MAX_LABEL[kind]}`);
+            }
+            const signResponse = await apiClient.post(signEndpoint, {
+                contentType,
+                size: file.size,
+                folder,
+                isPublic,
+                context,
+            });
+            // PUT bytes directly to Cloud Storage. The browser does NOT send
+            // credentials and the bucket must allow the request origin via CORS.
+            const putResponse = await fetch(signResponse.uploadUrl, {
+                method: "PUT",
+                body: file,
+                headers: { "Content-Type": signResponse.contentType },
+            });
+            if (!putResponse.ok) {
+                throw new Error(`Storage PUT failed with status ${putResponse.status}`);
+            }
+            return apiClient.post(finalizeEndpoint, {
+                storagePath: signResponse.storagePath,
+                isPublic,
+            });
+        },
     });
     const upload = async (file, folder = "uploads", isPublic = true, context) => {
-        const formData = new FormData();
-        formData.append("file", file);
-        formData.append("folder", folder);
-        formData.append("public", isPublic.toString());
-        if (context) {
-            formData.append("context", JSON.stringify(context));
-        }
-        const data = await mutation.mutateAsync(formData);
+        const data = await mutation.mutateAsync({ file, folder, isPublic, context });
         return data.url;
     };
     return { ...mutation, upload };

package/dist/features/media/upload/ImageUpload.js

@@ -3,7 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 /**
  * ImageUpload — canonical image upload component for @mohasinac/feat-media.
  *
- * Stage locally → caller-provided onUpload() → /api/media/upload.
+ * Stage locally → caller-provided onUpload() → sign+PUT+finalize signed-URL flow.
  * Optional focal-point crop (enableCrop, default true).
  * Optional camera capture (captureSource="both").
  */

package/dist/features/media/upload/MediaUploadField.js

@@ -4,7 +4,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * MediaUploadField — single-file upload field for @mohasinac/feat-media.
  *
  * For video: optionally opens VideoTrimModal then VideoThumbnailSelector after upload.
- * Stage locally → caller-provided onUpload() → /api/media/upload.
+ * Stage locally → caller-provided onUpload() → sign+PUT+finalize signed-URL flow.
  */
 import { useState, useRef, useEffect } from "react";
 import { useTranslations } from "next-intl";

package/dist/features/messages/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/messages/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for conversation.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `messages: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};

package/dist/features/orders/components/OrdersList.js

@@ -23,9 +23,18 @@ export function OrderCard({ order, onClick, labels = {} }) {
         })
         : "";
     const statusColor = STATUS_COLORS[order.orderStatus] ?? "bg-neutral-100 text-neutral-700";
+    // SB8-F — count unrevealed prize-draw entries to surface a "reveals pending" badge.
+    const unrevealedPrizeDraws = order.items.filter((it) => it.listingType === "prize-draw" &&
+        it.prizeRevealStatus !== undefined &&
+        it.prizeRevealStatus !== "revealed");
+    const revealsRemaining = unrevealedPrizeDraws.length;
+    const earliestDeadline = unrevealedPrizeDraws
+        .map((it) => it.prizeRevealDeadline)
+        .filter((d) => !!d)
+        .sort()[0];
     return (_jsxs(Div, { role: onClick ? "button" : undefined, tabIndex: onClick ? 0 : undefined, onKeyDown: onClick
             ? (e) => (e.key === "Enter" || e.key === " ") && onClick(order)
-            : undefined, onClick: onClick ? () => onClick(order) : undefined, className: `rounded-xl border border-neutral-200 dark:border-slate-700 bg-white dark:bg-slate-900 p-5 ${onClick ? "cursor-pointer transition hover:shadow-md" : ""}`, children: [_jsxs(Row, { wrap: true, align: "start", justify: "between", gap: "3", children: [_jsxs(Div, { children: [_jsxs(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: ["Order #", order.id.slice(-8).toUpperCase()] }), date && (_jsx(Text, { className: "mt-0.5 text-xs text-neutral-400 dark:text-zinc-500", children: date }))] }), _jsx(Span, { className: `rounded-full px-3 py-1 text-xs font-semibold capitalize ${statusColor}`, children: labels[order.orderStatus] ?? order.orderStatus.replace(/_/g, " ") })] }), _jsxs(Row, { wrap: true, gap: "3", className: "mt-4", children: [order.items.slice(0, 3).map((item, i) => (_jsxs(Row, { className: "gap-2", children: [item.image && (_jsx(Div, { role: "img", "aria-label": item.title, className: "h-10 w-10 rounded-lg bg-center bg-cover", style: { backgroundImage: `url(${item.image})` } })), _jsxs(Div, { children: [_jsx(Text, { className: `text-sm font-medium text-neutral-900 dark:text-zinc-100 ${THEME_CONSTANTS.utilities.textClamp1}`, children: item.title }), _jsxs(Text, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: ["\u00D7", item.quantity] })] })] }, i))), order.items.length > 3 && (_jsxs(Span, { className: "self-center text-xs text-neutral-400 dark:text-zinc-500", children: ["+", order.items.length - 3, " more"] }))] }), _jsxs(Row, { justify: "between", className: "mt-4 border-t border-neutral-100 dark:border-slate-700 pt-3", children: [_jsxs(Span, { className: "text-sm text-neutral-500 dark:text-zinc-400", children: [order.currency ?? "", " Total"] }), _jsx(Span, { className: "font-semibold text-neutral-900 dark:text-zinc-100", children: formatCurrency(order.total, order.currency) })] })] }));
+            : undefined, onClick: onClick ? () => onClick(order) : undefined, className: `rounded-xl border border-neutral-200 dark:border-slate-700 bg-white dark:bg-slate-900 p-5 ${onClick ? "cursor-pointer transition hover:shadow-md" : ""}`, children: [_jsxs(Row, { wrap: true, align: "start", justify: "between", gap: "3", children: [_jsxs(Div, { children: [_jsxs(Text, { className: "text-xs text-neutral-500 dark:text-zinc-400", children: ["Order #", order.id.slice(-8).toUpperCase()] }), date && (_jsx(Text, { className: "mt-0.5 text-xs text-neutral-400 dark:text-zinc-500", children: date }))] }), _jsx(Span, { className: `rounded-full px-3 py-1 text-xs font-semibold capitalize ${statusColor}`, children: labels[order.orderStatus] ?? order.orderStatus.replace(/_/g, " ") })] }), revealsRemaining > 0 && (_jsxs(Row, { gap: "sm", className: "mt-2", children: [_jsxs(Span, { className: "inline-flex items-center rounded-full bg-fuchsia-100 dark:bg-fuchsia-900/30 px-2.5 py-0.5 text-xs font-semibold text-fuchsia-700 dark:text-fuchsia-300", children: [revealsRemaining, " ", revealsRemaining === 1 ? "reveal" : "reveals", " pending"] }), earliestDeadline && (_jsxs(Span, { className: "text-xs text-zinc-500 dark:text-zinc-400", children: ["before ", new Date(earliestDeadline).toLocaleDateString(getDefaultLocale(), { month: "short", day: "numeric" })] }))] })), _jsxs(Row, { wrap: true, gap: "3", className: "mt-4", children: [order.items.slice(0, 3).map((item, i) => (_jsxs(Row, { className: "gap-2", children: [item.image && (_jsx(Div, { role: "img", "aria-label": item.title, className: "h-10 w-10 rounded-lg bg-center bg-cover", style: { backgroundImage: `url(${item.image})` } })), _jsxs(Div, { children: [_jsx(Text, { className: `text-sm font-medium text-neutral-900 dark:text-zinc-100 ${THEME_CONSTANTS.utilities.textClamp1}`, children: item.title }), _jsxs(Text, { className: "text-xs text-neutral-400 dark:text-zinc-500", children: ["\u00D7", item.quantity] })] })] }, i))), order.items.length > 3 && (_jsxs(Span, { className: "self-center text-xs text-neutral-400 dark:text-zinc-500", children: ["+", order.items.length - 3, " more"] }))] }), _jsxs(Row, { justify: "between", className: "mt-4 border-t border-neutral-100 dark:border-slate-700 pt-3", children: [_jsxs(Span, { className: "text-sm text-neutral-500 dark:text-zinc-400", children: [order.currency ?? "", " Total"] }), _jsx(Span, { className: "font-semibold text-neutral-900 dark:text-zinc-100", children: formatCurrency(order.total, order.currency) })] })] }));
 }
 export function OrdersList({ orders, isLoading, onOrderClick, totalPages = 1, currentPage = 1, onPageChange, emptyLabel = "No orders found", }) {
     if (isLoading) {

package/dist/features/orders/migrations.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationStep } from "../../_internal/shared/schema-versions";
+export declare const migrations: Record<number, MigrationStep<any>>;

package/dist/features/orders/migrations.js

@@ -0,0 +1,10 @@
+// SB-UNI X3 — migrations shell for order.
+// v1 schema is current; no migrations needed yet.
+//
+// To add a migration:
+//   1. Bump the relevant SCHEMA_VERSIONS entry in
+//      `_internal/shared/schema-versions.ts` (e.g. `orders: 2`)
+//   2. Add a row below keyed by the FROM-version, returning the upgraded doc
+//   3. Repository wraps reads with `migrateDocument(doc, current, migrations)`
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const migrations = {};