@mohasinac/appkit 3.4.8 → 3.5.0

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

@@ -29,18 +29,18 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }>>;
     contentImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -51,18 +51,18 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }>, "many">>;
     additionalImages: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -73,18 +73,18 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }>, "many">>;
     category: z.ZodString;
@@ -107,18 +107,18 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
     metaDescription: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     status: "draft" | "published" | "archived";
-    category: string;
+    id: string;
+    title: string;
+    content: string;
     createdAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    title: string;
-    slug: string;
-    tags: string[];
-    id: string;
     updatedAt: string | Date | z.objectOutputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    content: string;
+    category: string;
+    slug: string;
+    tags: string[];
     isFeatured: boolean;
     excerpt: string;
     authorId: string;
@@ -129,46 +129,46 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
     coverImage?: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     } | undefined;
     metaTitle?: string | undefined;
     metaDescription?: string | undefined;
     contentImages?: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
     additionalImages?: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
     authorAvatar?: string | undefined;
 }, {
     status: "draft" | "published" | "archived";
-    category: string;
+    id: string;
+    title: string;
+    content: string;
     createdAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    title: string;
-    slug: string;
-    tags: string[];
-    id: string;
     updatedAt: string | Date | z.objectInputType<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough">;
-    content: string;
+    category: string;
+    slug: string;
+    tags: string[];
     isFeatured: boolean;
     excerpt: string;
     authorId: string;
@@ -179,29 +179,29 @@ export declare const blogPostFirestoreSchema: z.ZodObject<{
         toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
     coverImage?: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     } | undefined;
     metaTitle?: string | undefined;
     metaDescription?: string | undefined;
     contentImages?: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
     additionalImages?: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
     authorAvatar?: string | undefined;
@@ -236,38 +236,38 @@ export declare const blogPostSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }>, z.ZodEffects<z.ZodString, {
         url: string;
         type: "image";
     }, string>]>>>, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     } | {
         url: string;
         type: "image";
     } | null, string | {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     } | null | undefined>;
     contentImages: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -278,18 +278,18 @@ export declare const blogPostSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }>, "many">>>;
     additionalImages: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -300,18 +300,18 @@ export declare const blogPostSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodEnum<["upload", "youtube", "external"]>>;
         youtubeId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }, {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }>, "many">>>;
     category: z.ZodEnum<["news", "tips", "guides", "updates", "community"]>;
@@ -330,41 +330,41 @@ export declare const blogPostSchema: z.ZodObject<{
     updatedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     status: "draft" | "published" | "archived";
-    category: "news" | "tips" | "guides" | "updates" | "community";
+    id: string;
     title: string;
+    category: "news" | "tips" | "guides" | "updates" | "community";
     slug: string;
-    id: string;
     coverImage: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     } | {
         url: string;
         type: "image";
     } | null;
     contentImages: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[];
     additionalImages: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[];
+    content?: string | undefined;
     createdAt?: string | undefined;
-    tags?: string[] | undefined;
     updatedAt?: string | undefined;
-    content?: string | undefined;
+    tags?: string[] | undefined;
     isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
     excerpt?: string | undefined;
@@ -377,23 +377,23 @@ export declare const blogPostSchema: z.ZodObject<{
     authorAvatar?: string | undefined;
 }, {
     status: "draft" | "published" | "archived";
-    category: "news" | "tips" | "guides" | "updates" | "community";
+    id: string;
     title: string;
+    category: "news" | "tips" | "guides" | "updates" | "community";
     slug: string;
-    id: string;
+    content?: string | undefined;
     createdAt?: string | undefined;
-    tags?: string[] | undefined;
     updatedAt?: string | undefined;
-    content?: string | undefined;
+    tags?: string[] | undefined;
     isFeatured?: boolean | undefined;
     publishedAt?: string | undefined;
     excerpt?: string | undefined;
     coverImage?: string | {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     } | null | undefined;
     authorId?: string | undefined;
@@ -403,19 +403,19 @@ export declare const blogPostSchema: z.ZodObject<{
     metaTitle?: string | undefined;
     metaDescription?: string | undefined;
     contentImages?: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
     additionalImages?: {
+        type: "video" | "image" | "file";
         url: string;
-        type: "image" | "video" | "file";
+        source?: "upload" | "youtube" | "external" | undefined;
         alt?: string | undefined;
         thumbnailUrl?: string | undefined;
-        source?: "upload" | "youtube" | "external" | undefined;
         youtubeId?: string | undefined;
     }[] | undefined;
     authorAvatar?: string | undefined;
@@ -431,18 +431,18 @@ export declare const blogListParamsSchema: z.ZodObject<{
     featured: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     sort?: string | undefined;
-    category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
-    featured?: boolean | undefined;
-    tags?: string | undefined;
     page?: number | undefined;
     q?: string | undefined;
     perPage?: number | undefined;
-}, {
-    sort?: string | undefined;
     category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
     featured?: boolean | undefined;
     tags?: string | undefined;
+}, {
+    sort?: string | undefined;
     page?: number | undefined;
     q?: string | undefined;
     perPage?: number | undefined;
+    category?: "news" | "tips" | "guides" | "updates" | "community" | undefined;
+    featured?: boolean | undefined;
+    tags?: string | undefined;
 }>;

package/dist/features/cart/components/CartDrawer.js

@@ -4,7 +4,7 @@ import { MediaImage } from "../../media/MediaImage";
 import { formatCurrency } from "../../../utils/number.formatter";
 import { ACTIONS } from "../../../_internal/shared/actions/action-registry";
 const __P = {
-    p4: "p-4",
+    p4: "p-[var(--appkit-space-4)]",
 };
 const __O = {
     hidden: "overflow-hidden",
@@ -15,7 +15,7 @@ export function CartItemRow({ item, onQtyChange, onRemove, href, isOutOfStock =
     return (_jsxs(Div, { layout: "flex", gap: "4", surface: "card", padding: "sm", className: `transition-opacity ${isOutOfStock ? "opacity-60" : ""}`, children: [_jsx(Div, { surface: "muted", className: `relative h-20 w-20 flex-shrink-0 ${__O.hidden}`, rounded: "lg", children: item.meta.image && (_jsx(MediaImage, { src: item.meta.image, alt: item.meta.title, size: "thumbnail" })) }), _jsxs(Stack, { justify: "between", className: "flex-1", children: [_jsxs(Row, { gap: "xs", className: "", align: "start", children: [href ? (_jsx(TextLink, { href: href, target: "_blank", rel: "noopener noreferrer", weight: "medium", className: "text-[var(--appkit-color-text)] hover:underline underline-offset-2 line-clamp-2", children: item.meta.title })) : (_jsx(Text, { truncate: 2, weight: "medium", color: "primary", children: item.meta.title })), isOutOfStock && (_jsx(Span, { padding: "pill-2xs", color: "error", surface: "danger-surface", weight: "semibold", className: "flex-shrink-0 text-[10px] tracking-wide", rounded: "default", transform: "uppercase", children: "Out of Stock" }))] }), item.meta.attributes &&
                         Object.keys(item.meta.attributes).length > 0 && (_jsx(Text, { className: "text-[var(--appkit-color-text-muted)]", size: "xs", children: Object.entries(item.meta.attributes)
                             .map(([k, v]) => `${k}: ${v}`)
-                            .join(", ") })), _jsxs(Row, { justify: "between", children: [_jsx(Text, { className: "text-[var(--appkit-color-text)]", weight: "semibold", children: formatCurrency(item.meta.price * item.quantity, item.meta.currency) }), onQtyChange && !isOutOfStock && (_jsxs(Row, { gap: "sm", children: [_jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity - 1), disabled: item.quantity <= 1, variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 border-[var(--appkit-color-border)] text-sm disabled:opacity-40", children: "\u2212" }), _jsx(Span, { size: "sm", className: "min-w-[1.5rem]", align: "center", children: item.quantity }), _jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity + 1), variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 border-[var(--appkit-color-border)] text-sm", children: "+" })] })), isOutOfStock && (_jsxs(Span, { size: "xs", color: "muted", children: ["Qty: ", item.quantity] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": ACTIONS.CART["remove-item"].ariaLabel, className: CLS_REMOVE_BTN, children: "\u2715" }))] }));
+                            .join(", ") })), _jsxs(Row, { justify: "between", children: [_jsx(Text, { className: "text-[var(--appkit-color-text)]", weight: "semibold", children: formatCurrency(item.meta.price * item.quantity, item.meta.currency) }), onQtyChange && !isOutOfStock && (_jsxs(Row, { gap: "sm", children: [_jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity - 1), disabled: item.quantity <= 1, variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 border-[var(--appkit-color-border)] text-[length:var(--appkit-text-sm)] disabled:opacity-40", children: "\u2212" }), _jsx(Span, { size: "sm", className: "min-w-[1.5rem]", align: "center", children: item.quantity }), _jsx(Button, { rounded: "full", onClick: () => onQtyChange(item.id, item.quantity + 1), variant: "outline", size: "sm", className: "h-7 w-7 justify-center border border-neutral-200 border-[var(--appkit-color-border)] text-[length:var(--appkit-text-sm)]", children: "+" })] })), isOutOfStock && (_jsxs(Span, { size: "xs", color: "muted", children: ["Qty: ", item.quantity] }))] })] }), onRemove && (_jsx(Button, { onClick: () => onRemove(item.id), variant: "ghost", size: "sm", "aria-label": ACTIONS.CART["remove-item"].ariaLabel, className: CLS_REMOVE_BTN, children: "\u2715" }))] }));
 }
 export function CartDrawer({ isOpen, onClose, items, subtotal = 0, currency, isLoading, onQtyChange, onRemove, onCheckout, labels = {}, }) {
     if (!isOpen)

package/dist/features/catalogue/actions/approve-catalogue-listing.d.ts

@@ -0,0 +1,12 @@
+import { type ActionResult } from "@mohasinac/appkit/server";
+/**
+ * Admin path — approves a buyer's "Request to sell", creating the product
+ * under the platform's own consignment store (not the buyer's, since a
+ * buyer has none) and preserving `sourceCatalogueOwnerId` for future
+ * consignment/payout traceability.
+ */
+export declare function approveCatalogueListingAction(itemId: string): Promise<ActionResult<{
+    productId: string;
+    productSlug: string;
+}>>;
+export declare function rejectCatalogueListingAction(itemId: string, reason: string): Promise<ActionResult<void>>;

package/dist/features/catalogue/actions/approve-catalogue-listing.js

@@ -0,0 +1,50 @@
+"use server";
+import { wrapAction } from "@mohasinac/appkit/server";
+import { catalogueRepository } from "../../../repositories";
+import { requireRoleUser } from "../../../providers/auth-firebase/helpers";
+import { isAdminUser } from "../../../features/auth/role-predicates";
+import { ValidationError, AuthorizationError } from "../../../errors";
+import { createProductFromCatalogueItem, CONSIGNMENT_STORE_ID } from "../utils/product-from-item";
+/**
+ * Admin path — approves a buyer's "Request to sell", creating the product
+ * under the platform's own consignment store (not the buyer's, since a
+ * buyer has none) and preserving `sourceCatalogueOwnerId` for future
+ * consignment/payout traceability.
+ */
+export async function approveCatalogueListingAction(itemId) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["admin"]);
+        if (!isAdminUser(user))
+            throw new AuthorizationError("Only admin can approve catalogue listings");
+        const item = await catalogueRepository.findById(itemId);
+        if (!item)
+            throw new ValidationError("Catalogue item not found");
+        if (item.listingStatus !== "pending_admin_approval") {
+            throw new ValidationError("Only items pending approval can be approved");
+        }
+        const product = await createProductFromCatalogueItem(item, CONSIGNMENT_STORE_ID);
+        await catalogueRepository.update(itemId, {
+            listingStatus: "listed",
+            linkedProductId: product.id,
+            linkedProductSlug: product.slug ?? product.id,
+        });
+        return { productId: product.id, productSlug: product.slug ?? product.id };
+    });
+}
+export async function rejectCatalogueListingAction(itemId, reason) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["admin"]);
+        if (!isAdminUser(user))
+            throw new AuthorizationError("Only admin can reject catalogue listings");
+        const item = await catalogueRepository.findById(itemId);
+        if (!item)
+            throw new ValidationError("Catalogue item not found");
+        if (item.listingStatus !== "pending_admin_approval") {
+            throw new ValidationError("Only items pending approval can be rejected");
+        }
+        await catalogueRepository.update(itemId, {
+            listingStatus: "rejected",
+            rejectionReason: reason,
+        });
+    });
+}

package/dist/features/catalogue/actions/list-from-catalogue.d.ts

@@ -0,0 +1,17 @@
+import { type ActionResult } from "@mohasinac/appkit/server";
+/**
+ * Direct-listing path — turns a catalogue item straight into a real listing,
+ * no approval queue. Two callers:
+ *   - **Seller**: listed under their own store.
+ *   - **Admin**: admins are buyers too and have no personal seller store of
+ *     their own, so their catalogue lists under the platform's consignment
+ *     store (`store-letitrip-official`) — the same store the buyer-approval
+ *     path uses. An admin approving their own "Request to sell" would be a
+ *     pointless round trip, so admins get the direct path instead.
+ * Freshness-gated (req: photos must be < 30 days old) — see
+ * `assertCatalogueImagesFresh`.
+ */
+export declare function listFromCatalogueAction(itemId: string): Promise<ActionResult<{
+    productId: string;
+    productSlug: string;
+}>>;

package/dist/features/catalogue/actions/list-from-catalogue.js

@@ -0,0 +1,50 @@
+"use server";
+import { wrapAction } from "@mohasinac/appkit/server";
+import { catalogueRepository, storeRepository } from "../../../repositories";
+import { requireRoleUser } from "../../../providers/auth-firebase/helpers";
+import { isAdminUser } from "../../../features/auth/role-predicates";
+import { ValidationError, AuthorizationError } from "../../../errors";
+import { assertCatalogueImagesFresh } from "../utils/freshness";
+import { createProductFromCatalogueItem, CONSIGNMENT_STORE_ID } from "../utils/product-from-item";
+/**
+ * Direct-listing path — turns a catalogue item straight into a real listing,
+ * no approval queue. Two callers:
+ *   - **Seller**: listed under their own store.
+ *   - **Admin**: admins are buyers too and have no personal seller store of
+ *     their own, so their catalogue lists under the platform's consignment
+ *     store (`store-letitrip-official`) — the same store the buyer-approval
+ *     path uses. An admin approving their own "Request to sell" would be a
+ *     pointless round trip, so admins get the direct path instead.
+ * Freshness-gated (req: photos must be < 30 days old) — see
+ * `assertCatalogueImagesFresh`.
+ */
+export async function listFromCatalogueAction(itemId) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["seller", "admin"]);
+        const item = await catalogueRepository.findById(itemId);
+        if (!item)
+            throw new ValidationError("Catalogue item not found");
+        if (item.ownerId !== user.uid)
+            throw new AuthorizationError("You do not own this catalogue item");
+        if (item.listingStatus === "listed")
+            throw new ValidationError("This item is already listed");
+        assertCatalogueImagesFresh(item);
+        let storeId;
+        if (isAdminUser(user)) {
+            storeId = CONSIGNMENT_STORE_ID;
+        }
+        else {
+            const store = await storeRepository.findByOwnerId(user.uid);
+            if (!store)
+                throw new ValidationError("You need a store before listing from your catalogue");
+            storeId = store.id;
+        }
+        const product = await createProductFromCatalogueItem(item, storeId);
+        await catalogueRepository.update(itemId, {
+            listingStatus: "listed",
+            linkedProductId: product.id,
+            linkedProductSlug: product.slug ?? product.id,
+        });
+        return { productId: product.id, productSlug: product.slug ?? product.id };
+    });
+}

package/dist/features/catalogue/actions/submit-for-approval.d.ts

@@ -0,0 +1,8 @@
+import { type ActionResult } from "@mohasinac/appkit/server";
+/**
+ * Buyer path — requests admin list the item on their behalf. Flips
+ * listingStatus to "pending_admin_approval"; the admin-notification fan-out
+ * happens in the onCatalogueSubmittedForApproval Firestore trigger, keeping
+ * this action fast (Rule #6) regardless of how many admins exist.
+ */
+export declare function submitCatalogueItemForApprovalAction(itemId: string): Promise<ActionResult<void>>;

package/dist/features/catalogue/actions/submit-for-approval.js

@@ -0,0 +1,30 @@
+"use server";
+import { wrapAction } from "@mohasinac/appkit/server";
+import { catalogueRepository } from "../../../repositories";
+import { requireRoleUser } from "../../../providers/auth-firebase/helpers";
+import { ValidationError, AuthorizationError } from "../../../errors";
+import { assertCatalogueImagesFresh } from "../utils/freshness";
+/**
+ * Buyer path — requests admin list the item on their behalf. Flips
+ * listingStatus to "pending_admin_approval"; the admin-notification fan-out
+ * happens in the onCatalogueSubmittedForApproval Firestore trigger, keeping
+ * this action fast (Rule #6) regardless of how many admins exist.
+ */
+export async function submitCatalogueItemForApprovalAction(itemId) {
+    return wrapAction(async () => {
+        const user = await requireRoleUser(["user", "seller", "admin"]);
+        const item = await catalogueRepository.findById(itemId);
+        if (!item)
+            throw new ValidationError("Catalogue item not found");
+        if (item.ownerId !== user.uid)
+            throw new AuthorizationError("You do not own this catalogue item");
+        if (item.listingStatus !== "not_listed") {
+            throw new ValidationError("Only items not yet submitted can be requested for listing");
+        }
+        assertCatalogueImagesFresh(item);
+        await catalogueRepository.update(itemId, {
+            listingStatus: "pending_admin_approval",
+            submittedForApprovalAt: new Date(),
+        });
+    });
+}

package/dist/features/catalogue/components/AdminCatalogueApprovalsView.d.ts

@@ -0,0 +1,2 @@
+import React from "react";
+export declare function AdminCatalogueApprovalsView(): React.JSX.Element;