@mohasinac/appkit 2.7.49 → 2.7.50

package/dist/features/stores/components/StoreProductsListing.js

@@ -77,19 +77,15 @@ export function StoreProductsListing({ storeId, initialData }) {
         });
     }, [wishlistedIds, localWishlist, showToast, requireAuth]);
     const handleAddToCart = useCallback((product) => {
-        localCart.add(product.id, 1, {
+        const snapshot = {
             productTitle: product.title,
             productImage: product.mainImage,
             price: product.price,
-        });
-        pushCartOp({
-            op: "add",
-            productId: product.id,
-            quantity: 1,
-            productTitle: product.title,
-            productImage: product.mainImage,
-            price: product.price,
-        });
+            storeId: product.storeId,
+            storeName: product.storeName,
+        };
+        localCart.add(product.id, 1, snapshot);
+        pushCartOp({ op: "add", productId: product.id, quantity: 1, ...snapshot });
         showToast("Added to cart", "success");
     }, [localCart, showToast]);
     return (_jsxs("div", { className: "min-h-[200px]", children: [_jsx(ListingToolbar, { filterCount: filterActiveCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: "Search store products...", onSearchChange: setSearchInput, onSearchCommit: commitSearch, sortValue: table.get("sort") || "-createdAt", sortOptions: PRODUCT_PUBLIC_SORT_OPTIONS, onSortChange: (v) => {

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

@@ -77,6 +77,8 @@ export interface StoreDocument {
         totalReviews: number;
         averageRating?: number;
     };
+    /** When the seller plans to return. Banner shows the date if set. */
+    vacationReturnDate?: Date | string;
     /**
      * Explicit capability set for this store. Defaults: ["suggest_brands", "create_coupons"].
      * Checked server-side on every relevant API route.

package/dist/index.d.ts

@@ -486,6 +486,7 @@ export type { ResolvedUser } from "./security/index";
 export type { RoleDefinition } from "./security/index";
 export type { UserRole } from "./security/index";
 export { AddressesRepository } from "./repositories/index";
+export * from "./features/store-extensions/index";
 export { BaseRepository } from "./repositories/index";
 export { BlogRepository } from "./repositories/index";
 export { CartRepository } from "./repositories/index";
@@ -519,6 +520,9 @@ export { cartRepository } from "./repositories/index";
 export { categoriesRepository } from "./repositories/index";
 export { chatRepository } from "./repositories/index";
 export { couponsRepository } from "./repositories/index";
+export { claimedCouponsRepository, ClaimedCouponsRepository } from "./repositories/index";
+export type { ClaimedCouponCreateInput } from "./repositories/index";
+export type { ClaimedCouponDocument, ClaimedCouponStatus, ClaimedCouponSource, ClaimedCouponSnapshot, } from "./features/promotions/schemas";
 export { emailVerificationTokenRepository } from "./repositories/index";
 export { eventEntryRepository } from "./repositories/index";
 export { eventRepository } from "./repositories/index";
@@ -541,6 +545,7 @@ export type { SupportTicketDocument, SupportTicketCreateInput, SupportTicketUpda
 export { ELIGIBLE_ORDER_STATUSES_FOR_TICKET, SUPPORT_TICKET_COLLECTION, ACTIVE_TICKET_STATUSES, SUPPORT_TICKET_FIELDS, TicketCategoryValues, TicketStatusValues, TicketPriorityValues, } from "./features/support/schemas/firestore";
 export { supportTicketsSeedData } from "./seed/index";
 export { offersSeedData } from "./seed/index";
+export { payoutMethodsSeedData, shippingConfigsSeedData, analyticsCardsSeedData, analyticsAlertsSeedData, storeCategoriesSeedData, listingTemplatesSeedData, moderationQueueSeedData, reportsSeedData, itemRequestsSeedData, storeWhatsAppConfigSeedData, storeGoogleConfigSeedData, } from "./seed/index";
 export { productFeaturesRepository } from "./repositories/index";
 export type { ProductFeatureListFilter } from "./repositories/index";
 export { loadProductFeaturesForStore } from "./repositories/index";
@@ -576,6 +581,7 @@ export { categoriesSeedData } from "./seed/index";
 export { couponsSeedData } from "./seed/index";
 export type { CouponUsageSeedRecord } from "./seed/index";
 export { couponUsageSeedData } from "./seed/index";
+export { claimedCouponsSeedData } from "./seed/index";
 export { eventEntriesSeedData } from "./seed/index";
 export { eventsSeedData } from "./seed/index";
 export { faqSeedData } from "./seed/index";

package/dist/index.js

@@ -932,6 +932,8 @@ export { resolvePermissions } from "./security/index";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // AddressesRepository - unified top-level addresses collection (SB-UNI-A 2026-05-13).
 export { AddressesRepository } from "./repositories/index";
+// S-STORE foundation — 14 schemas + 14 repositories + RBAC
+export * from "./features/store-extensions/index";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // BaseRepository - Shared export for base repository.
 export { BaseRepository } from "./repositories/index";
@@ -1035,6 +1037,8 @@ export { chatRepository } from "./repositories/index";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // couponsRepository - Shared export for coupons repository.
 export { couponsRepository } from "./repositories/index";
+// [DB] claimedCouponsRepository — user-wallet claims (plan §10).
+export { claimedCouponsRepository, ClaimedCouponsRepository } from "./repositories/index";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // emailVerificationTokenRepository - Shared export for email verification token repository.
 export { emailVerificationTokenRepository } from "./repositories/index";
@@ -1094,6 +1098,8 @@ export { ELIGIBLE_ORDER_STATUSES_FOR_TICKET, SUPPORT_TICKET_COLLECTION, ACTIVE_T
 // Support tickets â€" seed data
 export { supportTicketsSeedData } from "./seed/index";
 export { offersSeedData } from "./seed/index";
+// S-STORE foundation seed data
+export { payoutMethodsSeedData, shippingConfigsSeedData, analyticsCardsSeedData, analyticsAlertsSeedData, storeCategoriesSeedData, listingTemplatesSeedData, moderationQueueSeedData, reportsSeedData, itemRequestsSeedData, storeWhatsAppConfigSeedData, storeGoogleConfigSeedData, } from "./seed/index";
 // SB-UNI-B â€" sublistingCategoriesRepository + SublistingCategoryDocument deleted.
 // Use categoriesRepository.findBySlugAndType(slug, "sublisting") and CategoryDocument with categoryType:"sublisting".
 // [DB]-Database layer â€" uses firebase-admin; server-only.
@@ -1184,6 +1190,8 @@ export { categoriesSeedData } from "./seed/index";
 // couponsSeedData - Model for coupons seed data.
 export { couponsSeedData } from "./seed/index";
 export { couponUsageSeedData } from "./seed/index";
+// claimedCouponsSeedData - Plan §10 wallet seed (active/expired/used rows).
+export { claimedCouponsSeedData } from "./seed/index";
 // demoSeed has been moved to "@mohasinac/appkit/server" â€" it transitively
 // reaches firebase-admin via the seed runner, which must not leak into client
 // bundles. Import from `@mohasinac/appkit/server` in server-only code.

package/dist/next/routing/route-map.d.ts

@@ -80,6 +80,10 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly SCAMS: "/scams";
         readonly SCAM_DETAIL: (id: string) => string;
         readonly SCAM_REPORT: "/scams/report";
+        readonly REPORT_ENTITY: "/report";
+        readonly ITEM_REQUESTS: "/item-requests";
+        readonly ITEM_REQUEST_DETAIL: (id: string) => string;
+        readonly ITEM_REQUESTS_NEW: "/item-requests/new";
         readonly SCAM_TYPES: "/scams/types";
         readonly SCAM_FAQS: "/scams/faqs";
         readonly CLASSIFIED: "/classified";
@@ -116,6 +120,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly ORDER_INVOICE: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
         readonly MESSAGES: "/user/messages";
+        /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */
+        readonly CLAIMED_COUPONS: "/user/coupons";
         readonly BECOME_SELLER: "/user/become-seller";
         readonly CART: "/cart";
         readonly CHECKOUT: "/checkout";
@@ -185,6 +191,21 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly LIVE_ITEMS_EDIT: (id: string) => string;
         readonly PRINT_CENTER: "/store/print-center";
         readonly INVENTORY_PRINT: "/store/inventory/print";
+        readonly PAYOUT_METHODS: "/store/payout-methods";
+        readonly PAYOUT_METHODS_NEW: "/store/payout-methods/new";
+        readonly PAYOUT_METHODS_EDIT: (id: string) => string;
+        readonly SHIPPING_CONFIGS: "/store/shipping-configs";
+        readonly SHIPPING_CONFIGS_NEW: "/store/shipping-configs/new";
+        readonly SHIPPING_CONFIGS_EDIT: (id: string) => string;
+        readonly ANALYTICS_CARDS: "/store/analytics/cards";
+        readonly ANALYTICS_ALERTS: "/store/analytics/alerts";
+        readonly STORE_CATEGORIES: "/store/categories";
+        readonly STORE_CATEGORIES_NEW: "/store/categories/new";
+        readonly STORE_CATEGORIES_EDIT: (id: string) => string;
+        readonly LISTING_TEMPLATES: "/store/listing-templates";
+        readonly LISTING_TEMPLATES_NEW: "/store/listing-templates/new";
+        readonly LISTING_TEMPLATES_EDIT: (id: string) => string;
+        readonly GOOGLE_REVIEWS: "/store/google-reviews";
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
@@ -266,6 +287,17 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly SETTINGS_ACTIONS: "/admin/settings/actions";
         readonly SETTINGS_NAVIGATION: "/admin/settings/navigation";
         readonly PRINT_CENTER: "/admin/print-center";
+        readonly MODERATION: "/admin/moderation";
+        readonly MODERATION_DETAIL: (id: string) => string;
+        readonly REPORTS: "/admin/reports";
+        readonly REPORT_DETAIL: (id: string) => string;
+        readonly ITEM_REQUESTS: "/admin/item-requests";
+        readonly ITEM_REQUEST_DETAIL: (id: string) => string;
+        readonly ROLES: "/admin/roles";
+        readonly ROLES_NEW: "/admin/roles/new";
+        readonly ROLES_EDIT: (id: string) => string;
+        readonly PERMISSIONS: "/admin/permissions";
+        readonly ADMIN_NOTIFICATIONS: "/admin/admin-notifications";
     };
     readonly DEMO: {
         readonly SEED: "/demo/seed";
@@ -345,6 +377,10 @@ export declare const ROUTES: {
         readonly SCAMS: "/scams";
         readonly SCAM_DETAIL: (id: string) => string;
         readonly SCAM_REPORT: "/scams/report";
+        readonly REPORT_ENTITY: "/report";
+        readonly ITEM_REQUESTS: "/item-requests";
+        readonly ITEM_REQUEST_DETAIL: (id: string) => string;
+        readonly ITEM_REQUESTS_NEW: "/item-requests/new";
         readonly SCAM_TYPES: "/scams/types";
         readonly SCAM_FAQS: "/scams/faqs";
         readonly CLASSIFIED: "/classified";
@@ -381,6 +417,8 @@ export declare const ROUTES: {
         readonly ORDER_INVOICE: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
         readonly MESSAGES: "/user/messages";
+        /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */
+        readonly CLAIMED_COUPONS: "/user/coupons";
         readonly BECOME_SELLER: "/user/become-seller";
         readonly CART: "/cart";
         readonly CHECKOUT: "/checkout";
@@ -450,6 +488,21 @@ export declare const ROUTES: {
         readonly LIVE_ITEMS_EDIT: (id: string) => string;
         readonly PRINT_CENTER: "/store/print-center";
         readonly INVENTORY_PRINT: "/store/inventory/print";
+        readonly PAYOUT_METHODS: "/store/payout-methods";
+        readonly PAYOUT_METHODS_NEW: "/store/payout-methods/new";
+        readonly PAYOUT_METHODS_EDIT: (id: string) => string;
+        readonly SHIPPING_CONFIGS: "/store/shipping-configs";
+        readonly SHIPPING_CONFIGS_NEW: "/store/shipping-configs/new";
+        readonly SHIPPING_CONFIGS_EDIT: (id: string) => string;
+        readonly ANALYTICS_CARDS: "/store/analytics/cards";
+        readonly ANALYTICS_ALERTS: "/store/analytics/alerts";
+        readonly STORE_CATEGORIES: "/store/categories";
+        readonly STORE_CATEGORIES_NEW: "/store/categories/new";
+        readonly STORE_CATEGORIES_EDIT: (id: string) => string;
+        readonly LISTING_TEMPLATES: "/store/listing-templates";
+        readonly LISTING_TEMPLATES_NEW: "/store/listing-templates/new";
+        readonly LISTING_TEMPLATES_EDIT: (id: string) => string;
+        readonly GOOGLE_REVIEWS: "/store/google-reviews";
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
@@ -531,6 +584,17 @@ export declare const ROUTES: {
         readonly SETTINGS_ACTIONS: "/admin/settings/actions";
         readonly SETTINGS_NAVIGATION: "/admin/settings/navigation";
         readonly PRINT_CENTER: "/admin/print-center";
+        readonly MODERATION: "/admin/moderation";
+        readonly MODERATION_DETAIL: (id: string) => string;
+        readonly REPORTS: "/admin/reports";
+        readonly REPORT_DETAIL: (id: string) => string;
+        readonly ITEM_REQUESTS: "/admin/item-requests";
+        readonly ITEM_REQUEST_DETAIL: (id: string) => string;
+        readonly ROLES: "/admin/roles";
+        readonly ROLES_NEW: "/admin/roles/new";
+        readonly ROLES_EDIT: (id: string) => string;
+        readonly PERMISSIONS: "/admin/permissions";
+        readonly ADMIN_NOTIFICATIONS: "/admin/admin-notifications";
     };
     readonly DEMO: {
         readonly SEED: "/demo/seed";
@@ -595,6 +659,21 @@ export declare const SELLER_ROUTES: {
     readonly LIVE_ITEMS_EDIT: (id: string) => string;
     readonly PRINT_CENTER: "/store/print-center";
     readonly INVENTORY_PRINT: "/store/inventory/print";
+    readonly PAYOUT_METHODS: "/store/payout-methods";
+    readonly PAYOUT_METHODS_NEW: "/store/payout-methods/new";
+    readonly PAYOUT_METHODS_EDIT: (id: string) => string;
+    readonly SHIPPING_CONFIGS: "/store/shipping-configs";
+    readonly SHIPPING_CONFIGS_NEW: "/store/shipping-configs/new";
+    readonly SHIPPING_CONFIGS_EDIT: (id: string) => string;
+    readonly ANALYTICS_CARDS: "/store/analytics/cards";
+    readonly ANALYTICS_ALERTS: "/store/analytics/alerts";
+    readonly STORE_CATEGORIES: "/store/categories";
+    readonly STORE_CATEGORIES_NEW: "/store/categories/new";
+    readonly STORE_CATEGORIES_EDIT: (id: string) => string;
+    readonly LISTING_TEMPLATES: "/store/listing-templates";
+    readonly LISTING_TEMPLATES_NEW: "/store/listing-templates/new";
+    readonly LISTING_TEMPLATES_EDIT: (id: string) => string;
+    readonly GOOGLE_REVIEWS: "/store/google-reviews";
 };
 export declare const PUBLIC_ROUTES: readonly ["/", string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, "/unauthorized", "/auth/login", "/auth/register", "/auth/forgot-password", "/auth/reset-password", "/auth/verify-email"];
 export declare const PROTECTED_ROUTES: readonly [string, string, string, string, string, string, string];

package/dist/next/routing/route-map.js

@@ -68,6 +68,10 @@ export const DEFAULT_ROUTE_MAP = {
         SCAMS: "/scams",
         SCAM_DETAIL: (id) => `/scams/${id}`,
         SCAM_REPORT: "/scams/report",
+        REPORT_ENTITY: "/report",
+        ITEM_REQUESTS: "/item-requests",
+        ITEM_REQUEST_DETAIL: (id) => `/item-requests/${id}`,
+        ITEM_REQUESTS_NEW: "/item-requests/new",
         SCAM_TYPES: "/scams/types",
         SCAM_FAQS: "/scams/faqs",
         CLASSIFIED: "/classified",
@@ -104,6 +108,8 @@ export const DEFAULT_ROUTE_MAP = {
         ORDER_INVOICE: (id) => `/user/orders/${id}/invoice`,
         NOTIFICATIONS: "/user/notifications",
         MESSAGES: "/user/messages",
+        /** Plan §10 — claimed-coupons wallet (Active / Expired / Used tabs). */
+        CLAIMED_COUPONS: "/user/coupons",
         BECOME_SELLER: "/user/become-seller",
         CART: "/cart",
         CHECKOUT: "/checkout",
@@ -175,6 +181,22 @@ export const DEFAULT_ROUTE_MAP = {
         LIVE_ITEMS_EDIT: (id) => `/store/live/${id}/edit`,
         PRINT_CENTER: "/store/print-center",
         INVENTORY_PRINT: "/store/inventory/print",
+        // S-STORE Tier — new extension routes
+        PAYOUT_METHODS: "/store/payout-methods",
+        PAYOUT_METHODS_NEW: "/store/payout-methods/new",
+        PAYOUT_METHODS_EDIT: (id) => `/store/payout-methods/${id}/edit`,
+        SHIPPING_CONFIGS: "/store/shipping-configs",
+        SHIPPING_CONFIGS_NEW: "/store/shipping-configs/new",
+        SHIPPING_CONFIGS_EDIT: (id) => `/store/shipping-configs/${id}/edit`,
+        ANALYTICS_CARDS: "/store/analytics/cards",
+        ANALYTICS_ALERTS: "/store/analytics/alerts",
+        STORE_CATEGORIES: "/store/categories",
+        STORE_CATEGORIES_NEW: "/store/categories/new",
+        STORE_CATEGORIES_EDIT: (id) => `/store/categories/${id}/edit`,
+        LISTING_TEMPLATES: "/store/listing-templates",
+        LISTING_TEMPLATES_NEW: "/store/listing-templates/new",
+        LISTING_TEMPLATES_EDIT: (id) => `/store/listing-templates/${id}/edit`,
+        GOOGLE_REVIEWS: "/store/google-reviews",
     },
     ADMIN: {
         DASHBOARD: "/admin/dashboard",
@@ -258,6 +280,18 @@ export const DEFAULT_ROUTE_MAP = {
         SETTINGS_ACTIONS: "/admin/settings/actions",
         SETTINGS_NAVIGATION: "/admin/settings/navigation",
         PRINT_CENTER: "/admin/print-center",
+        // S-STORE Tier — admin moderation + reports + item requests
+        MODERATION: "/admin/moderation",
+        MODERATION_DETAIL: (id) => `/admin/moderation/${id}`,
+        REPORTS: "/admin/reports",
+        REPORT_DETAIL: (id) => `/admin/reports/${id}`,
+        ITEM_REQUESTS: "/admin/item-requests",
+        ITEM_REQUEST_DETAIL: (id) => `/admin/item-requests/${id}`,
+        ROLES: "/admin/roles",
+        ROLES_NEW: "/admin/roles/new",
+        ROLES_EDIT: (id) => `/admin/roles/${id}/edit`,
+        PERMISSIONS: "/admin/permissions",
+        ADMIN_NOTIFICATIONS: "/admin/admin-notifications",
     },
     DEMO: {
         SEED: "/demo/seed",

package/dist/react/hooks/useFormStatePreservation.d.ts

@@ -0,0 +1,17 @@
+export interface FormStatePreservationOptions<TValues> {
+    /** Current form values to persist. */
+    values: TValues;
+    /** Callback invoked with restored values on mount (if any). */
+    onRestore: (values: TValues) => void;
+    /** Field paths whose values are stripped before encoding (PII). */
+    stripFields?: string[];
+    /** URL query-param name. Default: "_s". */
+    paramName?: string;
+    /** Debounce in ms. Default: 500. */
+    debounceMs?: number;
+    /** Disable persistence (e.g. while submitting). */
+    enabled?: boolean;
+}
+export declare function useFormStatePreservation<TValues extends Record<string, unknown>>({ values, onRestore, stripFields, paramName, debounceMs, enabled, }: FormStatePreservationOptions<TValues>): {
+    clearPreservedState: () => void;
+};

package/dist/react/hooks/useFormStatePreservation.js

@@ -0,0 +1,62 @@
+"use client";
+import { useEffect, useRef, useCallback } from "react";
+const PARAM_DEFAULT = "_s";
+function stripPii(values, stripFields) {
+    if (!stripFields.length || typeof values !== "object" || values === null) {
+        return values;
+    }
+    const clone = { ...values };
+    for (const path of stripFields) {
+        if (path in clone) {
+            delete clone[path];
+        }
+    }
+    return clone;
+}
+export function useFormStatePreservation({ values, onRestore, stripFields = [], paramName = PARAM_DEFAULT, debounceMs = 500, enabled = true, }) {
+    const restoredRef = useRef(false);
+    const timerRef = useRef(null);
+    useEffect(() => {
+        if (restoredRef.current || typeof window === "undefined")
+            return;
+        restoredRef.current = true;
+        const url = new URL(window.location.href);
+        const encoded = url.searchParams.get(paramName);
+        if (!encoded)
+            return;
+        try {
+            const decoded = JSON.parse(atob(encoded));
+            onRestore(decoded);
+        }
+        catch {
+            // ignore corrupt payloads
+        }
+    }, [paramName, onRestore]);
+    useEffect(() => {
+        if (!enabled || typeof window === "undefined" || !restoredRef.current)
+            return;
+        if (timerRef.current)
+            clearTimeout(timerRef.current);
+        timerRef.current = setTimeout(() => {
+            const stripped = stripPii(values, stripFields);
+            const encoded = btoa(JSON.stringify(stripped));
+            const url = new URL(window.location.href);
+            url.searchParams.set(paramName, encoded);
+            window.history.replaceState({}, "", url.toString());
+        }, debounceMs);
+        return () => {
+            if (timerRef.current)
+                clearTimeout(timerRef.current);
+        };
+    }, [values, enabled, paramName, debounceMs, stripFields]);
+    const clearPreservedState = useCallback(() => {
+        if (typeof window === "undefined")
+            return;
+        const url = new URL(window.location.href);
+        if (url.searchParams.has(paramName)) {
+            url.searchParams.delete(paramName);
+            window.history.replaceState({}, "", url.toString());
+        }
+    }, [paramName]);
+    return { clearPreservedState };
+}

package/dist/react/hooks/useInlineRowEdit.d.ts

@@ -0,0 +1,24 @@
+export interface InlineEditOptions<TValue> {
+    rowId: string;
+    field: string;
+    initialValue: TValue;
+    save: (rowId: string, field: string, value: TValue) => Promise<unknown>;
+    onError?: (err: unknown, previous: TValue) => void;
+}
+export interface InlineToggleResult {
+    value: boolean;
+    isSaving: boolean;
+    toggle: () => Promise<void>;
+}
+export declare function useInlineToggle({ rowId, field, initialValue, save, onError, }: InlineEditOptions<boolean>): InlineToggleResult;
+export interface InlineTextResult {
+    value: string;
+    draft: string;
+    isEditing: boolean;
+    isSaving: boolean;
+    startEdit: () => void;
+    cancelEdit: () => void;
+    commitEdit: () => Promise<void>;
+    setDraft: (next: string) => void;
+}
+export declare function useInlineTextEdit({ rowId, field, initialValue, save, onError, }: InlineEditOptions<string>): InlineTextResult;

package/dist/react/hooks/useInlineRowEdit.js

@@ -0,0 +1,68 @@
+"use client";
+import { useCallback, useState } from "react";
+export function useInlineToggle({ rowId, field, initialValue, save, onError, }) {
+    const [value, setValue] = useState(initialValue);
+    const [isSaving, setIsSaving] = useState(false);
+    const toggle = useCallback(async () => {
+        const previous = value;
+        const next = !previous;
+        setValue(next);
+        setIsSaving(true);
+        try {
+            await save(rowId, field, next);
+        }
+        catch (err) {
+            setValue(previous);
+            onError?.(err, previous);
+        }
+        finally {
+            setIsSaving(false);
+        }
+    }, [value, save, rowId, field, onError]);
+    return { value, isSaving, toggle };
+}
+export function useInlineTextEdit({ rowId, field, initialValue, save, onError, }) {
+    const [value, setValue] = useState(initialValue);
+    const [draft, setDraft] = useState(initialValue);
+    const [isEditing, setIsEditing] = useState(false);
+    const [isSaving, setIsSaving] = useState(false);
+    const startEdit = useCallback(() => {
+        setDraft(value);
+        setIsEditing(true);
+    }, [value]);
+    const cancelEdit = useCallback(() => {
+        setDraft(value);
+        setIsEditing(false);
+    }, [value]);
+    const commitEdit = useCallback(async () => {
+        if (draft === value) {
+            setIsEditing(false);
+            return;
+        }
+        const previous = value;
+        setValue(draft);
+        setIsEditing(false);
+        setIsSaving(true);
+        try {
+            await save(rowId, field, draft);
+        }
+        catch (err) {
+            setValue(previous);
+            setDraft(previous);
+            onError?.(err, previous);
+        }
+        finally {
+            setIsSaving(false);
+        }
+    }, [draft, value, save, rowId, field, onError]);
+    return {
+        value,
+        draft,
+        isEditing,
+        isSaving,
+        startEdit,
+        cancelEdit,
+        commitEdit,
+        setDraft,
+    };
+}

package/dist/react/index.d.ts

@@ -30,6 +30,10 @@ export type { UseBulkSelectionOptions, UseBulkSelectionReturn, } from "./hooks/u
 export { useSyncManager } from "../core/hooks/useSyncManager";
 export { useUrlTable } from "./hooks/useUrlTable";
 export type { UseUrlTableOptions } from "./hooks/useUrlTable";
+export { useInlineToggle, useInlineTextEdit, } from "./hooks/useInlineRowEdit";
+export type { InlineEditOptions, InlineToggleResult, InlineTextResult, } from "./hooks/useInlineRowEdit";
+export { useFormStatePreservation } from "./hooks/useFormStatePreservation";
+export type { FormStatePreservationOptions } from "./hooks/useFormStatePreservation";
 export { usePendingFilters } from "./hooks/usePendingFilters";
 export type { UsePendingFiltersOptions, UsePendingFiltersReturn, } from "./hooks/usePendingFilters";
 export { usePendingTable } from "./hooks/usePendingTable";

package/dist/react/index.js

@@ -28,6 +28,10 @@ export { useBulkSelection } from "./hooks/useBulkSelection";
 export { useSyncManager } from "../core/hooks/useSyncManager";
 // URL-driven table / list state
 export { useUrlTable } from "./hooks/useUrlTable";
+// Inline row editing (S-STORE-CROSS-B)
+export { useInlineToggle, useInlineTextEdit, } from "./hooks/useInlineRowEdit";
+// Form state preservation in URL (S-STORE-CROSS-C)
+export { useFormStatePreservation } from "./hooks/useFormStatePreservation";
 // Staged (pending) filter management
 export { usePendingFilters } from "./hooks/usePendingFilters";
 export { usePendingTable } from "./hooks/usePendingTable";

package/dist/repositories/index.d.ts

@@ -24,9 +24,13 @@ export { carouselsRepository, CarouselsRepository } from "../features/homepage/r
 export { homepageSectionsRepository } from "../features/homepage/repository/homepage-sections.repository";
 export { CategoriesRepository, categoriesRepository, } from "../features/categories/repository/categories.repository";
 export { couponsRepository } from "../features/promotions/repository/coupons.repository";
+export { ClaimedCouponsRepository, claimedCouponsRepository, } from "../features/promotions/repository/claimed-coupons.repository";
+export type { ClaimedCouponCreateInput } from "../features/promotions/repository/claimed-coupons.repository";
 export { FAQsRepository, FirebaseFAQsRepository, faqsRepository, } from "../features/faq/repository/faqs.repository";
 export { BlogRepository, blogRepository, } from "../features/blog/repository/blog.repository";
 export { payoutRepository } from "../features/payments/repository/payout.repository";
+export { payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, itemRequestsRepository, storeWhatsAppConfigRepository, storeGoogleConfigRepository, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, ItemRequestsRepository, StoreWhatsAppConfigRepository, StoreGoogleConfigRepository, } from "../features/store-extensions/repository/store-extensions.repositories";
+export { roleOverridesRepository, customRolesRepository, adminNotificationsRepository, RoleOverridesRepository, CustomRolesRepository, AdminNotificationsRepository, } from "../features/store-extensions/repository/rbac.repositories";
 export { OfferRepository, offerRepository, } from "../features/seller/repository/offer.repository";
 export { wishlistRepository, type UserWishlistItem as WishlistItem, WishlistFullError, } from "../features/wishlist/repository/user-wishlist.repository";
 export { historyRepository, type UserHistoryItem, type HistoryProductType, } from "../features/history/repository/user-history.repository";

package/dist/repositories/index.js

@@ -31,9 +31,14 @@ export { carouselsRepository, CarouselsRepository } from "../features/homepage/r
 export { homepageSectionsRepository } from "../features/homepage/repository/homepage-sections.repository";
 export { CategoriesRepository, categoriesRepository, } from "../features/categories/repository/categories.repository";
 export { couponsRepository } from "../features/promotions/repository/coupons.repository";
+export { ClaimedCouponsRepository, claimedCouponsRepository, } from "../features/promotions/repository/claimed-coupons.repository";
 export { FAQsRepository, FirebaseFAQsRepository, faqsRepository, } from "../features/faq/repository/faqs.repository";
 export { BlogRepository, blogRepository, } from "../features/blog/repository/blog.repository";
 export { payoutRepository } from "../features/payments/repository/payout.repository";
+// S-STORE-CROSS — 11 new collection repositories
+export { payoutMethodsRepository, shippingConfigsRepository, analyticsCardsRepository, analyticsAlertsRepository, storeCategoriesRepository, listingTemplatesRepository, moderationQueueRepository, reportsRepository, itemRequestsRepository, storeWhatsAppConfigRepository, storeGoogleConfigRepository, PayoutMethodsRepository, ShippingConfigsRepository, AnalyticsCardsRepository, AnalyticsAlertsRepository, StoreCategoriesRepository, ListingTemplatesRepository, ModerationQueueRepository, ReportsRepository, ItemRequestsRepository, StoreWhatsAppConfigRepository, StoreGoogleConfigRepository, } from "../features/store-extensions/repository/store-extensions.repositories";
+// S-STORE RBAC + admin notifications
+export { roleOverridesRepository, customRolesRepository, adminNotificationsRepository, RoleOverridesRepository, CustomRolesRepository, AdminNotificationsRepository, } from "../features/store-extensions/repository/rbac.repositories";
 export { OfferRepository, offerRepository, } from "../features/seller/repository/offer.repository";
 export { wishlistRepository, WishlistFullError, } from "../features/wishlist/repository/user-wishlist.repository";
 export { historyRepository, } from "../features/history/repository/user-history.repository";

package/dist/seed/actions/demo-seed-actions.d.ts

@@ -6,7 +6,7 @@
  * the actual collection-specific seeding logic (800+ lines with PII encryption,
  * Auth user creation, subcollection handling, etc.).
  */
-export type SeedCollectionName = "users" | "addresses" | "categories" | "stores" | "products" | "orders" | "reviews" | "bids" | "coupons" | "carousels" | "carouselSlides" | "homepageSections" | "siteSettings" | "faqs" | "notifications" | "payouts" | "blogPosts" | "events" | "eventEntries" | "sessions" | "carts" | "wishlists" | "history" | "conversations" | "groupedListings" | "scammerProfiles" | "supportTickets" | "productFeatures" | "offers";
+export type SeedCollectionName = "users" | "addresses" | "categories" | "stores" | "products" | "orders" | "reviews" | "bids" | "coupons" | "carousels" | "carouselSlides" | "homepageSections" | "siteSettings" | "faqs" | "notifications" | "payouts" | "blogPosts" | "events" | "eventEntries" | "sessions" | "carts" | "wishlists" | "history" | "conversations" | "groupedListings" | "scammerProfiles" | "supportTickets" | "productFeatures" | "offers" | "payoutMethods" | "shippingConfigs" | "analyticsCards" | "analyticsAlerts" | "storeCategories" | "listingTemplates" | "moderationQueue" | "reports" | "itemRequests" | "storeWhatsAppConfig" | "storeGoogleConfig" | "roleOverrides" | "customRoles" | "adminNotifications";
 export interface SeedOperationResult {
     success?: boolean;
     message: string;

package/dist/seed/claimed-coupons-seed-data.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Claimed Coupons Seed Data — plan §10.
+ *
+ * Top-level `claimedCoupons` collection (one doc per user × coupon). These
+ * rows populate the /user/coupons wallet with one example per status so the
+ * tabs (Active / Expired / Used) all have something to render in demo.
+ *
+ * Coupon snapshots mirror coupons-seed-data.ts (WELCOME10, POKEMON25,
+ * FREESHIP999) so the discount badge labels render correctly. Seed user is
+ * `user-mohsin-c` to match the dev-account convention used elsewhere.
+ */
+import type { ClaimedCouponDocument } from "../features/promotions/schemas";
+export declare const claimedCouponsSeedData: ClaimedCouponDocument[];