@mohasinac/appkit 2.7.49 → 2.7.52

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

@@ -41,6 +41,10 @@ export const DEFAULT_ROUTE_MAP = {
         CONTACT: "/contact",
         BLOG: "/blog",
         HELP: "/help",
+        HELP_SHOPPING: "/help/shopping",
+        HELP_AUCTIONS: "/help/auctions",
+        HELP_ORDERS: "/help/orders",
+        HELP_ACCOUNT: "/help/account",
         TERMS: "/terms",
         PRIVACY: "/privacy",
         SECURITY: "/security",
@@ -68,6 +72,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 +112,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 +185,32 @@ 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",
+        GROUPED_LISTINGS: "/store/grouped-listings",
+        GROUPED_LISTINGS_NEW: "/store/grouped-listings/new",
+        GROUPED_LISTINGS_EDIT: (id) => `/store/grouped-listings/${id}/edit`,
+        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",
+        // GD1–GD6 — Store Guide Hub + sub-pages
+        GUIDE: "/store/guide",
+        GUIDE_LISTINGS: "/store/guide/listings",
+        GUIDE_ORDERS: "/store/guide/orders",
+        GUIDE_FINANCE: "/store/guide/finance",
+        GUIDE_CAPABILITIES: "/store/guide/capabilities",
+        GUIDE_SETTINGS: "/store/guide/settings",
     },
     ADMIN: {
         DASHBOARD: "/admin/dashboard",
@@ -258,6 +294,29 @@ 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",
+        // GD13–GD22 — Admin Guide Hub + sub-pages
+        GUIDE: "/admin/guide",
+        GUIDE_USERS: "/admin/guide/users",
+        GUIDE_CATALOG: "/admin/guide/catalog",
+        GUIDE_STORES: "/admin/guide/stores",
+        GUIDE_ORDERS: "/admin/guide/orders",
+        GUIDE_CONTENT: "/admin/guide/content",
+        GUIDE_SITE: "/admin/guide/site",
+        GUIDE_TEAM: "/admin/guide/team",
+        GUIDE_ANALYTICS: "/admin/guide/analytics",
+        GUIDE_TRUST: "/admin/guide/trust",
     },
     DEMO: {
         SEED: "/demo/seed",

package/dist/providers/db-firebase/__tests__/filter-aliases.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/providers/db-firebase/__tests__/filter-aliases.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect } from "vitest";
+import { expandFilterAliases } from "../filter-aliases";
+describe("expandFilterAliases", () => {
+    it("returns undefined when filters is undefined", () => {
+        const aliases = { scope: () => "status==active" };
+        expect(expandFilterAliases(undefined, aliases)).toBeUndefined();
+    });
+    it("returns filters unchanged when aliases is undefined", () => {
+        expect(expandFilterAliases("status==active", undefined)).toBe("status==active");
+    });
+    it("returns filters unchanged when aliases is empty object", () => {
+        expect(expandFilterAliases("status==active", {})).toBe("status==active");
+    });
+    it("expands a single alias clause", () => {
+        const aliases = {
+            scope: (value) => value === "publicAuctions" ? "status==published,listingType==auction" : "",
+        };
+        expect(expandFilterAliases("scope==publicAuctions", aliases)).toBe("status==published,listingType==auction");
+    });
+    it("passes the operator to the alias function", () => {
+        const received = [];
+        const aliases = {
+            myField: (value, op) => {
+                received.push({ value, op });
+                return "x==1";
+            },
+        };
+        expandFilterAliases("myField!=foo", aliases);
+        expect(received).toEqual([{ value: "foo", op: "!=" }]);
+    });
+    it("expands an alias and passes through unknown clauses", () => {
+        const aliases = {
+            scope: () => "status==published,listingType==auction",
+        };
+        const result = expandFilterAliases("scope==publicAuctions,storeId==store-abc", aliases);
+        expect(result).toBe("status==published,listingType==auction,storeId==store-abc");
+    });
+    it("passes through a clause whose field has no alias", () => {
+        const aliases = { scope: () => "status==active" };
+        expect(expandFilterAliases("category==brand-pokemon", aliases)).toBe("category==brand-pokemon");
+    });
+    it("drops a clause when the alias returns empty string", () => {
+        const aliases = {
+            scope: () => "",
+        };
+        expect(expandFilterAliases("scope==unknown", aliases)).toBe("");
+    });
+    it("drops an empty-expansion clause while keeping other clauses", () => {
+        const aliases = {
+            scope: (value) => (value === "known" ? "status==active" : ""),
+        };
+        const result = expandFilterAliases("scope==notknown,listingType==standard", aliases);
+        expect(result).toBe("listingType==standard");
+    });
+    it("handles multiple alias fields in one filter string", () => {
+        const aliases = {
+            scope: () => "status==active",
+            type: () => "listingType==auction",
+        };
+        const result = expandFilterAliases("scope==any,type==any", aliases);
+        expect(result).toBe("status==active,listingType==auction");
+    });
+    it("trims whitespace around clauses", () => {
+        const aliases = { scope: () => "status==active" };
+        const result = expandFilterAliases(" scope==x , name==foo ", aliases);
+        expect(result).toBe("status==active,name==foo");
+    });
+    it("passes through a clause that does not match the operator pattern", () => {
+        const aliases = { scope: () => "status==active" };
+        // A malformed clause has no operator — should pass through unchanged
+        expect(expandFilterAliases("malformed", aliases)).toBe("malformed");
+    });
+    it("handles @= operator", () => {
+        const received = [];
+        const aliases = {
+            tags: (_v, op) => { received.push(op); return "tags@=value"; },
+        };
+        expandFilterAliases("tags@=value", aliases);
+        expect(received[0]).toBe("@=");
+    });
+    it("handles @=* operator", () => {
+        const received = [];
+        const aliases = {
+            tags: (_v, op) => { received.push(op); return "tags@=*value"; },
+        };
+        expandFilterAliases("tags@=*value", aliases);
+        expect(received[0]).toBe("@=*");
+    });
+    it("returns empty string when all clauses expand to empty", () => {
+        const aliases = { scope: () => "" };
+        expect(expandFilterAliases("scope==x", aliases)).toBe("");
+    });
+});

package/dist/providers/db-firebase/sieve.d.ts

@@ -16,6 +16,55 @@
  *   }, { baseQuery });
  * }
  * ```
+ *
+ * ## Known Sieve ↔ Firestore incompatibilities
+ *
+ * These Sieve DSL features are silently unsupported or produce wrong results
+ * when translated to Firestore queries. Document them here to avoid surprise.
+ *
+ * ### 1. String-contains `@=*` (case-insensitive full-text)
+ * Sieve's `title@=*query` is a substring/CI match. Firestore has no native
+ * LIKE or ILIKE operator. The Firebase adapter maps it to `>=` / `<` prefix
+ * range tricks that only work for prefix matches on ASCII strings, not
+ * arbitrary substrings. Use a Firebase Function or in-memory post-filter for
+ * real substring search; never rely on `@=*` to match mid-string.
+ *
+ * ### 2. OR across different fields (`|` pipe between clauses)
+ * Sieve's `field1==v1|field2==v2` (OR across two different fields) is
+ * translated to `whereOr` by the stock Firebase adapter. Firestore's Admin SDK
+ * v6+ supports `Query.where(Filter.or(...))`, but the stock adapter version
+ * bundled with sievejs may emit an unsupported form. The enhanced adapter in
+ * this file only upgrades single-field OR groups (same-field equality → `in`
+ * query). Multi-field OR is still unsupported — apply it in memory.
+ *
+ * ### 3. OR on the same field (`field==v1|v2`) → Firestore `in`
+ * The custom `createEnhancedFirebaseAdapter` in this file upgrades these to
+ * Firestore `.where(field, "in", [v1, v2])`. Firestore supports up to 30
+ * values in an `in` clause. More than 30 values will throw. The stock adapter
+ * would have emitted a `whereOr` call that fails entirely.
+ *
+ * ### 4. Multi-field `orderBy` without a matching composite index
+ * Firestore requires a composite index for every combination of `where` +
+ * `orderBy` fields. Sieve sorts like `-createdAt,price` translate to two
+ * `orderBy` calls; if the Firestore collection has no index for that
+ * combination the query throws `FAILED_PRECONDITION`. Add the index to
+ * `appkit/firebase/base/firestore.indexes.json` and deploy before shipping.
+ *
+ * ### 5. Inequality filter + `orderBy` on a different field
+ * Firestore's rule: if you have an inequality filter (`!=`, `<`, `>`, `<=`,
+ * `>=`) on field A, the first `orderBy` must also be on field A. Sieve queries
+ * like `price>=100 & sorts=-createdAt` translate to an inequality on `price`
+ * with `orderBy createdAt`, which Firestore rejects. Work-arounds:
+ *   (a) move the inequality filter to the Firebase Function path where it can
+ *       be handled server-side, (b) apply it in-memory in the fallback path,
+ *       (c) restructure the sort to use the same field as the filter.
+ *
+ * ### 6. Dot-notation nested field filters (`address.city==Delhi`)
+ * Sieve parses the field name verbatim; the Firebase adapter passes it as the
+ * Firestore field path. Firestore Admin SDK supports dot-notation for nested
+ * fields, so `address.city==Delhi` works — but only if the field is indexed.
+ * Add nested-field indexes explicitly; Firestore does not auto-index nested
+ * paths in composite indexes declared at the root level.
  */
 import type { CollectionReference, DocumentData, Query } from "firebase-admin/firestore";
 import { FirebaseRepository } from "./base";

package/dist/providers/db-firebase/sieve.js

@@ -16,6 +16,55 @@
  *   }, { baseQuery });
  * }
  * ```
+ *
+ * ## Known Sieve ↔ Firestore incompatibilities
+ *
+ * These Sieve DSL features are silently unsupported or produce wrong results
+ * when translated to Firestore queries. Document them here to avoid surprise.
+ *
+ * ### 1. String-contains `@=*` (case-insensitive full-text)
+ * Sieve's `title@=*query` is a substring/CI match. Firestore has no native
+ * LIKE or ILIKE operator. The Firebase adapter maps it to `>=` / `<` prefix
+ * range tricks that only work for prefix matches on ASCII strings, not
+ * arbitrary substrings. Use a Firebase Function or in-memory post-filter for
+ * real substring search; never rely on `@=*` to match mid-string.
+ *
+ * ### 2. OR across different fields (`|` pipe between clauses)
+ * Sieve's `field1==v1|field2==v2` (OR across two different fields) is
+ * translated to `whereOr` by the stock Firebase adapter. Firestore's Admin SDK
+ * v6+ supports `Query.where(Filter.or(...))`, but the stock adapter version
+ * bundled with sievejs may emit an unsupported form. The enhanced adapter in
+ * this file only upgrades single-field OR groups (same-field equality → `in`
+ * query). Multi-field OR is still unsupported — apply it in memory.
+ *
+ * ### 3. OR on the same field (`field==v1|v2`) → Firestore `in`
+ * The custom `createEnhancedFirebaseAdapter` in this file upgrades these to
+ * Firestore `.where(field, "in", [v1, v2])`. Firestore supports up to 30
+ * values in an `in` clause. More than 30 values will throw. The stock adapter
+ * would have emitted a `whereOr` call that fails entirely.
+ *
+ * ### 4. Multi-field `orderBy` without a matching composite index
+ * Firestore requires a composite index for every combination of `where` +
+ * `orderBy` fields. Sieve sorts like `-createdAt,price` translate to two
+ * `orderBy` calls; if the Firestore collection has no index for that
+ * combination the query throws `FAILED_PRECONDITION`. Add the index to
+ * `appkit/firebase/base/firestore.indexes.json` and deploy before shipping.
+ *
+ * ### 5. Inequality filter + `orderBy` on a different field
+ * Firestore's rule: if you have an inequality filter (`!=`, `<`, `>`, `<=`,
+ * `>=`) on field A, the first `orderBy` must also be on field A. Sieve queries
+ * like `price>=100 & sorts=-createdAt` translate to an inequality on `price`
+ * with `orderBy createdAt`, which Firestore rejects. Work-arounds:
+ *   (a) move the inequality filter to the Firebase Function path where it can
+ *       be handled server-side, (b) apply it in-memory in the fallback path,
+ *       (c) restructure the sort to use the same field as the filter.
+ *
+ * ### 6. Dot-notation nested field filters (`address.city==Delhi`)
+ * Sieve parses the field name verbatim; the Firebase adapter passes it as the
+ * Firestore field path. Firestore Admin SDK supports dot-notation for nested
+ * fields, so `address.city==Delhi` works — but only if the field is indexed.
+ * Add nested-field indexes explicitly; Firestore does not auto-index nested
+ * paths in composite indexes declared at the root level.
  */
 import { SieveProcessorBase } from "@mohasinac/sievejs/services";
 import { createFirebaseAdapter } from "@mohasinac/sievejs/adapters/firebase";
@@ -81,15 +130,18 @@ export async function applySieveToFirestore(params) {
         options: merged,
         fields,
     });
+    const page = Math.max(1, Number(model.page ?? 1));
+    const pageSize = Math.min(merged.maxPageSize, Math.max(1, Number(model.pageSize ?? merged.defaultPageSize)));
+    // Apply filters + sorts once; count without reading docs.
     const filteredQ = processor.apply(effective, baseQuery, {
         applyPagination: false,
     });
     const total = await getFirestoreCount(filteredQ);
-    const pagedQ = processor.apply(effective, baseQuery);
+    // Apply pagination on top of the already-filtered query — avoids re-applying
+    // the full Sieve DSL from the base.
+    const pagedQ = filteredQ.offset((page - 1) * pageSize).limit(pageSize);
     const snap = await pagedQ.get();
     const items = snap.docs.map((d) => deserializeTimestamps({ id: d.id, ...d.data() }));
-    const page = Math.max(1, Number(model.page ?? 1));
-    const pageSize = Math.min(merged.maxPageSize, Math.max(1, Number(model.pageSize ?? merged.defaultPageSize)));
     const totalPages = total === 0 ? 0 : Math.max(1, Math.ceil(total / pageSize));
     return {
         items,
@@ -120,17 +172,18 @@ export class FirebaseSieveRepository extends FirebaseRepository {
             options: merged,
             fields,
         });
-        // Count (no docs fetched)
+        const page = Math.max(1, Number(model.page ?? 1));
+        const pageSize = Math.min(merged.maxPageSize, Math.max(1, Number(model.pageSize ?? merged.defaultPageSize)));
+        // Apply filters + sorts once; count without reading docs.
         const filteredQ = processor.apply(effective, base, {
             applyPagination: false,
         });
         const total = await getFirestoreCount(filteredQ);
-        // Paginated result
-        const pagedQ = processor.apply(effective, base);
+        // Apply pagination on top of the already-filtered query — avoids re-applying
+        // the full Sieve DSL from the base.
+        const pagedQ = filteredQ.offset((page - 1) * pageSize).limit(pageSize);
         const snap = await pagedQ.get();
         const items = snap.docs.map((d) => deserializeTimestamps({ id: d.id, ...d.data() }));
-        const page = Math.max(1, Number(model.page ?? 1));
-        const pageSize = Math.min(merged.maxPageSize, Math.max(1, Number(model.pageSize ?? merged.defaultPageSize)));
         const totalPages = total === 0 ? 0 : Math.max(1, Math.ceil(total / pageSize));
         return {
             items,

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,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 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 { GroupedListingsRepository, groupedListingsRepository, } from "../features/grouped/repository/grouped-listings.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,16 @@ 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";
+// Grouped listings repository
+export { GroupedListingsRepository, groupedListingsRepository, } from "../features/grouped/repository/grouped-listings.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[];