@mohasinac/appkit 2.7.49 → 2.7.50

package/dist/features/store-extensions/repository/store-extensions.repositories.js

@@ -0,0 +1,127 @@
+/**
+ * S-STORE Extension Repositories
+ *
+ * 11 lightweight BaseRepository subclasses. None of these collections store
+ * PII directly so no `createWithId` override is required (Pattern #9). Uses
+ * the BaseRepository public API only: `findById`, `findBy`, `findAll`,
+ * `create`, `update`, `delete`.
+ */
+import { BaseRepository } from "../../../providers/db-firebase";
+import { ANALYTICS_ALERTS_COLLECTION, ANALYTICS_CARDS_COLLECTION, ITEM_REQUESTS_COLLECTION, LISTING_TEMPLATES_COLLECTION, MODERATION_QUEUE_COLLECTION, PAYOUT_METHODS_COLLECTION, REPORTS_COLLECTION, SHIPPING_CONFIGS_COLLECTION, STORE_CATEGORIES_COLLECTION, STORE_GOOGLE_CONFIG_COLLECTION, STORE_WHATSAPP_CONFIG_COLLECTION, } from "../schemas/firestore";
+export class PayoutMethodsRepository extends BaseRepository {
+    constructor() {
+        super(PAYOUT_METHODS_COLLECTION);
+    }
+    async listByStore(storeId) {
+        const items = await this.findBy("storeId", storeId);
+        return { items };
+    }
+}
+export class ShippingConfigsRepository extends BaseRepository {
+    constructor() {
+        super(SHIPPING_CONFIGS_COLLECTION);
+    }
+    async listByStore(storeId) {
+        const items = await this.findBy("storeId", storeId);
+        return { items };
+    }
+}
+export class AnalyticsCardsRepository extends BaseRepository {
+    constructor() {
+        super(ANALYTICS_CARDS_COLLECTION);
+    }
+    async listForOwner(scope, ownerId) {
+        const all = await this.findBy("ownerId", ownerId);
+        return { items: all.filter((d) => d.scope === scope && d.isVisible !== false) };
+    }
+}
+export class AnalyticsAlertsRepository extends BaseRepository {
+    constructor() {
+        super(ANALYTICS_ALERTS_COLLECTION);
+    }
+    async listForOwner(scope, ownerId) {
+        const all = await this.findBy("ownerId", ownerId);
+        return { items: all.filter((d) => d.scope === scope) };
+    }
+}
+export class StoreCategoriesRepository extends BaseRepository {
+    constructor() {
+        super(STORE_CATEGORIES_COLLECTION);
+    }
+    async listByStore(storeId) {
+        const items = await this.findBy("storeId", storeId);
+        return { items };
+    }
+}
+export class ListingTemplatesRepository extends BaseRepository {
+    constructor() {
+        super(LISTING_TEMPLATES_COLLECTION);
+    }
+    async listByStore(storeId) {
+        const all = await this.findBy("storeId", storeId);
+        return { items: all.filter((d) => d.isActive !== false) };
+    }
+}
+export class ModerationQueueRepository extends BaseRepository {
+    constructor() {
+        super(MODERATION_QUEUE_COLLECTION);
+    }
+    async listPending() {
+        const items = await this.findBy("status", "pending");
+        return { items };
+    }
+}
+export class ReportsRepository extends BaseRepository {
+    constructor() {
+        super(REPORTS_COLLECTION);
+    }
+    async listForEntity(entityType, entityId) {
+        const all = await this.findBy("entityId", entityId);
+        return { items: all.filter((d) => d.entityType === entityType) };
+    }
+    async listPending() {
+        const items = await this.findBy("status", "pending");
+        return { items };
+    }
+}
+export class ItemRequestsRepository extends BaseRepository {
+    constructor() {
+        super(ITEM_REQUESTS_COLLECTION);
+    }
+    async listOpen(opts) {
+        const all = await this.findBy("status", "open");
+        const limit = opts?.limit ?? 50;
+        return { items: all.slice(0, limit) };
+    }
+    async listByOwner(opUserId) {
+        const items = await this.findBy("opUserId", opUserId);
+        return { items };
+    }
+}
+export class StoreWhatsAppConfigRepository extends BaseRepository {
+    constructor() {
+        super(STORE_WHATSAPP_CONFIG_COLLECTION);
+    }
+    async getByStore(storeId) {
+        return this.findOneBy("storeId", storeId);
+    }
+}
+export class StoreGoogleConfigRepository extends BaseRepository {
+    constructor() {
+        super(STORE_GOOGLE_CONFIG_COLLECTION);
+    }
+    async getByStore(storeId) {
+        return this.findOneBy("storeId", storeId);
+    }
+}
+export const payoutMethodsRepository = new PayoutMethodsRepository();
+export const shippingConfigsRepository = new ShippingConfigsRepository();
+export const analyticsCardsRepository = new AnalyticsCardsRepository();
+export const analyticsAlertsRepository = new AnalyticsAlertsRepository();
+export const storeCategoriesRepository = new StoreCategoriesRepository();
+export const listingTemplatesRepository = new ListingTemplatesRepository();
+export const moderationQueueRepository = new ModerationQueueRepository();
+export const reportsRepository = new ReportsRepository();
+export const itemRequestsRepository = new ItemRequestsRepository();
+export const storeWhatsAppConfigRepository = new StoreWhatsAppConfigRepository();
+export const storeGoogleConfigRepository = new StoreGoogleConfigRepository();

package/dist/features/store-extensions/schemas/firestore.d.ts

@@ -0,0 +1,244 @@
+/**
+ * S-STORE Extensions — Firestore Document Types
+ *
+ * Foundational schemas for the 11 new collections introduced in Tier S-STORE.
+ * Each collection includes COLLECTION constant, document interface,
+ * INDEXED_FIELDS tuple, and DEFAULT_DATA partial.
+ *
+ * Collections covered:
+ *   1. payoutMethods         — seller payout destinations (UPI/bank/card/other)
+ *   2. shippingConfigs       — store shipping rules (free/flat/weight/express)
+ *   3. analyticsCards        — seller-defined dashboard cards
+ *   4. analyticsAlerts       — seller-defined alert thresholds
+ *   5. storeCategories       — storefront-level catalogue groupings
+ *   6. listingTemplates      — seller-defined listing templates
+ *   7. moderationQueue       — video / media moderation queue items
+ *   8. reports               — buyer-submitted reports against listings/stores
+ *   9. itemRequests          — community item request bulletin board
+ *  10. storeWhatsAppConfig   — per-store WhatsApp business catalogue + auto-replies
+ *  11. storeGoogleConfig     — per-store Google Business reviews integration
+ */
+export type PayoutMethodType = "upi" | "bank" | "card" | "other";
+export interface PayoutMethodDocument {
+    id: string;
+    sellerId: string;
+    storeId: string;
+    type: PayoutMethodType;
+    label: string;
+    isDefault: boolean;
+    isActive: boolean;
+    upiVpa?: string;
+    accountNumber?: string;
+    ifscCode?: string;
+    accountHolderName?: string;
+    bankName?: string;
+    details?: Record<string, string>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const PAYOUT_METHODS_COLLECTION: "payoutMethods";
+export declare const PAYOUT_METHOD_INDEXED_FIELDS: readonly ["sellerId", "storeId", "type", "isDefault", "isActive", "createdAt"];
+export declare const DEFAULT_PAYOUT_METHOD_DATA: Partial<PayoutMethodDocument>;
+export type ShippingMethod = "free" | "flat" | "weight" | "express" | "pickup" | "custom";
+export interface ShippingConfigDocument {
+    id: string;
+    storeId: string;
+    label: string;
+    method: ShippingMethod;
+    isDefault: boolean;
+    isActive: boolean;
+    flatRateInPaise?: number;
+    pricePerKgInPaise?: number;
+    freeAbovePaise?: number;
+    expressSurchargeInPaise?: number;
+    estimatedDays?: number;
+    zones?: string[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const SHIPPING_CONFIGS_COLLECTION: "shippingConfigs";
+export declare const SHIPPING_CONFIG_INDEXED_FIELDS: readonly ["storeId", "method", "isDefault", "isActive", "createdAt"];
+export declare const DEFAULT_SHIPPING_CONFIG_DATA: Partial<ShippingConfigDocument>;
+export type AnalyticsScope = "seller" | "admin";
+export type AnalyticsCardType = "metric" | "line" | "bar" | "pie" | "table" | "custom";
+export interface AnalyticsCardDocument {
+    id: string;
+    scope: AnalyticsScope;
+    ownerId: string;
+    title: string;
+    type: AnalyticsCardType;
+    metric: string;
+    filters: Record<string, unknown>;
+    position: number;
+    isBuiltIn: boolean;
+    isVisible: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const ANALYTICS_CARDS_COLLECTION: "analyticsCards";
+export declare const ANALYTICS_CARD_INDEXED_FIELDS: readonly ["scope", "ownerId", "isVisible", "position", "createdAt"];
+export declare const DEFAULT_ANALYTICS_CARD_DATA: Partial<AnalyticsCardDocument>;
+export type AlertOperator = ">" | "<" | ">=" | "<=" | "==" | "!=";
+export interface AnalyticsAlertDocument {
+    id: string;
+    scope: AnalyticsScope;
+    ownerId: string;
+    label: string;
+    metric: string;
+    operator: AlertOperator;
+    threshold: number;
+    windowHours: number;
+    isActive: boolean;
+    notifyChannels: Array<"in-app" | "email" | "whatsapp">;
+    lastTriggeredAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const ANALYTICS_ALERTS_COLLECTION: "analyticsAlerts";
+export declare const ANALYTICS_ALERT_INDEXED_FIELDS: readonly ["scope", "ownerId", "isActive", "metric", "createdAt"];
+export declare const DEFAULT_ANALYTICS_ALERT_DATA: Partial<AnalyticsAlertDocument>;
+export interface StoreCategoryDocument {
+    id: string;
+    storeId: string;
+    label: string;
+    slug: string;
+    displayOrder: number;
+    productIds: string[];
+    isActive: boolean;
+    description?: string;
+    coverImageUrl?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const STORE_CATEGORIES_COLLECTION: "storeCategories";
+export declare const STORE_CATEGORY_INDEXED_FIELDS: readonly ["storeId", "slug", "isActive", "displayOrder", "createdAt"];
+export declare const DEFAULT_STORE_CATEGORY_DATA: Partial<StoreCategoryDocument>;
+export type ListingTemplateType = "standard" | "auction" | "pre-order" | "prize-draw" | "bundle" | "classified" | "digital-code" | "live";
+export interface ListingTemplateDocument {
+    id: string;
+    storeId: string;
+    ownerId: string;
+    name: string;
+    description?: string;
+    listingType: ListingTemplateType;
+    /** JSON-shaped default fields applied when the template is selected. */
+    defaults: Record<string, unknown>;
+    isShared: boolean;
+    isActive: boolean;
+    usageCount: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const LISTING_TEMPLATES_COLLECTION: "listingTemplates";
+export declare const LISTING_TEMPLATE_INDEXED_FIELDS: readonly ["storeId", "ownerId", "listingType", "isShared", "isActive", "createdAt"];
+export declare const DEFAULT_LISTING_TEMPLATE_DATA: Partial<ListingTemplateDocument>;
+export type ModerationStatus = "pending" | "approved" | "rejected" | "auto-approved";
+export type ModerationMediaType = "video" | "image" | "rich-text";
+export interface ModerationQueueDocument {
+    id: string;
+    mediaType: ModerationMediaType;
+    mediaUrl?: string;
+    thumbnailUrl?: string;
+    entityType: "product" | "review" | "event" | "blog" | "storefront";
+    entityId: string;
+    ownerId: string;
+    storeId?: string;
+    status: ModerationStatus;
+    reason?: string;
+    reviewerId?: string;
+    reviewedAt?: Date;
+    submittedAt: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const MODERATION_QUEUE_COLLECTION: "moderationQueue";
+export declare const MODERATION_QUEUE_INDEXED_FIELDS: readonly ["status", "mediaType", "entityType", "entityId", "storeId", "ownerId", "submittedAt", "createdAt"];
+export declare const DEFAULT_MODERATION_QUEUE_DATA: Partial<ModerationQueueDocument>;
+export type ReportEntityType = "product" | "store" | "review" | "event" | "user" | "blog" | "comment";
+export type ReportStatus = "pending" | "under-review" | "actioned" | "dismissed";
+export type ReportReason = "scam" | "counterfeit" | "prohibited" | "inappropriate" | "harassment" | "spam" | "ip-violation" | "other";
+export interface ReportDocument {
+    id: string;
+    entityType: ReportEntityType;
+    entityId: string;
+    reporterId: string;
+    reporterEmail?: string;
+    reason: ReportReason;
+    detail: string;
+    evidenceUrls: string[];
+    status: ReportStatus;
+    assignedTo?: string;
+    resolution?: string;
+    resolvedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const REPORTS_COLLECTION: "reports";
+export declare const REPORT_INDEXED_FIELDS: readonly ["entityType", "entityId", "reporterId", "reason", "status", "createdAt"];
+export declare const DEFAULT_REPORT_DATA: Partial<ReportDocument>;
+export type ItemRequestStatus = "pending-approval" | "open" | "fulfilled" | "closed" | "rejected";
+export interface ItemRequestReply {
+    id: string;
+    authorId: string;
+    authorName?: string;
+    body: string;
+    isOpInitiatedThread: boolean;
+    createdAt: Date;
+}
+export interface ItemRequestDocument {
+    id: string;
+    opUserId: string;
+    opDisplayName: string;
+    title: string;
+    description: string;
+    category?: string;
+    brand?: string;
+    maxBudgetInPaise?: number;
+    imageUrls: string[];
+    status: ItemRequestStatus;
+    replyCount: number;
+    /** Replies kept inline up to a cap; spillover lives in a sub-collection. */
+    replies: ItemRequestReply[];
+    approvedAt?: Date;
+    approvedBy?: string;
+    closedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const ITEM_REQUESTS_COLLECTION: "itemRequests";
+export declare const ITEM_REQUEST_INDEXED_FIELDS: readonly ["opUserId", "status", "category", "createdAt"];
+export declare const DEFAULT_ITEM_REQUEST_DATA: Partial<ItemRequestDocument>;
+export interface StoreWhatsAppConfigDocument {
+    id: string;
+    storeId: string;
+    isConnected: boolean;
+    isPaid: boolean;
+    phoneNumber?: string;
+    businessProfileName?: string;
+    catalogUrl?: string;
+    autoReply?: string;
+    welcomeMessage?: string;
+    /** Status of pending WhatsApp Business onboarding (Meta Cloud API). */
+    onboardingStatus?: "pending" | "approved" | "rejected";
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const STORE_WHATSAPP_CONFIG_COLLECTION: "storeWhatsAppConfig";
+export declare const STORE_WHATSAPP_CONFIG_INDEXED_FIELDS: readonly ["storeId", "isConnected", "isPaid"];
+export declare const DEFAULT_STORE_WHATSAPP_CONFIG_DATA: Partial<StoreWhatsAppConfigDocument>;
+export interface StoreGoogleConfigDocument {
+    id: string;
+    storeId: string;
+    isConnected: boolean;
+    placeId?: string;
+    businessName?: string;
+    averageRating?: number;
+    totalReviews?: number;
+    lastSyncedAt?: Date;
+    oauthRefreshToken?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const STORE_GOOGLE_CONFIG_COLLECTION: "storeGoogleConfig";
+export declare const STORE_GOOGLE_CONFIG_INDEXED_FIELDS: readonly ["storeId", "isConnected"];
+export declare const DEFAULT_STORE_GOOGLE_CONFIG_DATA: Partial<StoreGoogleConfigDocument>;

package/dist/features/store-extensions/schemas/firestore.js

@@ -0,0 +1,158 @@
+/**
+ * S-STORE Extensions — Firestore Document Types
+ *
+ * Foundational schemas for the 11 new collections introduced in Tier S-STORE.
+ * Each collection includes COLLECTION constant, document interface,
+ * INDEXED_FIELDS tuple, and DEFAULT_DATA partial.
+ *
+ * Collections covered:
+ *   1. payoutMethods         — seller payout destinations (UPI/bank/card/other)
+ *   2. shippingConfigs       — store shipping rules (free/flat/weight/express)
+ *   3. analyticsCards        — seller-defined dashboard cards
+ *   4. analyticsAlerts       — seller-defined alert thresholds
+ *   5. storeCategories       — storefront-level catalogue groupings
+ *   6. listingTemplates      — seller-defined listing templates
+ *   7. moderationQueue       — video / media moderation queue items
+ *   8. reports               — buyer-submitted reports against listings/stores
+ *   9. itemRequests          — community item request bulletin board
+ *  10. storeWhatsAppConfig   — per-store WhatsApp business catalogue + auto-replies
+ *  11. storeGoogleConfig     — per-store Google Business reviews integration
+ */
+export const PAYOUT_METHODS_COLLECTION = "payoutMethods";
+export const PAYOUT_METHOD_INDEXED_FIELDS = [
+    "sellerId",
+    "storeId",
+    "type",
+    "isDefault",
+    "isActive",
+    "createdAt",
+];
+export const DEFAULT_PAYOUT_METHOD_DATA = {
+    isDefault: false,
+    isActive: true,
+};
+export const SHIPPING_CONFIGS_COLLECTION = "shippingConfigs";
+export const SHIPPING_CONFIG_INDEXED_FIELDS = [
+    "storeId",
+    "method",
+    "isDefault",
+    "isActive",
+    "createdAt",
+];
+export const DEFAULT_SHIPPING_CONFIG_DATA = {
+    isDefault: false,
+    isActive: true,
+};
+export const ANALYTICS_CARDS_COLLECTION = "analyticsCards";
+export const ANALYTICS_CARD_INDEXED_FIELDS = [
+    "scope",
+    "ownerId",
+    "isVisible",
+    "position",
+    "createdAt",
+];
+export const DEFAULT_ANALYTICS_CARD_DATA = {
+    isBuiltIn: false,
+    isVisible: true,
+    position: 0,
+    filters: {},
+};
+export const ANALYTICS_ALERTS_COLLECTION = "analyticsAlerts";
+export const ANALYTICS_ALERT_INDEXED_FIELDS = [
+    "scope",
+    "ownerId",
+    "isActive",
+    "metric",
+    "createdAt",
+];
+export const DEFAULT_ANALYTICS_ALERT_DATA = {
+    isActive: true,
+    windowHours: 24,
+    notifyChannels: ["in-app"],
+};
+export const STORE_CATEGORIES_COLLECTION = "storeCategories";
+export const STORE_CATEGORY_INDEXED_FIELDS = [
+    "storeId",
+    "slug",
+    "isActive",
+    "displayOrder",
+    "createdAt",
+];
+export const DEFAULT_STORE_CATEGORY_DATA = {
+    isActive: true,
+    displayOrder: 0,
+    productIds: [],
+};
+export const LISTING_TEMPLATES_COLLECTION = "listingTemplates";
+export const LISTING_TEMPLATE_INDEXED_FIELDS = [
+    "storeId",
+    "ownerId",
+    "listingType",
+    "isShared",
+    "isActive",
+    "createdAt",
+];
+export const DEFAULT_LISTING_TEMPLATE_DATA = {
+    isShared: false,
+    isActive: true,
+    usageCount: 0,
+    defaults: {},
+};
+export const MODERATION_QUEUE_COLLECTION = "moderationQueue";
+export const MODERATION_QUEUE_INDEXED_FIELDS = [
+    "status",
+    "mediaType",
+    "entityType",
+    "entityId",
+    "storeId",
+    "ownerId",
+    "submittedAt",
+    "createdAt",
+];
+export const DEFAULT_MODERATION_QUEUE_DATA = {
+    status: "pending",
+};
+export const REPORTS_COLLECTION = "reports";
+export const REPORT_INDEXED_FIELDS = [
+    "entityType",
+    "entityId",
+    "reporterId",
+    "reason",
+    "status",
+    "createdAt",
+];
+export const DEFAULT_REPORT_DATA = {
+    status: "pending",
+    evidenceUrls: [],
+};
+export const ITEM_REQUESTS_COLLECTION = "itemRequests";
+export const ITEM_REQUEST_INDEXED_FIELDS = [
+    "opUserId",
+    "status",
+    "category",
+    "createdAt",
+];
+export const DEFAULT_ITEM_REQUEST_DATA = {
+    status: "pending-approval",
+    imageUrls: [],
+    replies: [],
+    replyCount: 0,
+};
+export const STORE_WHATSAPP_CONFIG_COLLECTION = "storeWhatsAppConfig";
+export const STORE_WHATSAPP_CONFIG_INDEXED_FIELDS = [
+    "storeId",
+    "isConnected",
+    "isPaid",
+];
+export const DEFAULT_STORE_WHATSAPP_CONFIG_DATA = {
+    isConnected: false,
+    isPaid: false,
+};
+export const STORE_GOOGLE_CONFIG_COLLECTION = "storeGoogleConfig";
+export const STORE_GOOGLE_CONFIG_INDEXED_FIELDS = [
+    "storeId",
+    "isConnected",
+];
+export const DEFAULT_STORE_GOOGLE_CONFIG_DATA = {
+    isConnected: false,
+};

package/dist/features/store-extensions/schemas/rbac.d.ts

@@ -0,0 +1,65 @@
+/**
+ * RBAC — roleOverrides + customRoles
+ *
+ * S-STORE-9B-G foundation. Stores per-user permission patches and
+ * admin-defined custom roles. Used by the existing `hasPermission()`
+ * predicate via a layered lookup: builtin role → custom role → override.
+ */
+export interface RoleOverrideDocument {
+    id: string;
+    /** Target user UID. */
+    userId: string;
+    /** Optional store-scoped override (null = global). */
+    storeId?: string | null;
+    /** Permission keys granted in addition to the user's base role. */
+    grantedPermissions: string[];
+    /** Permission keys revoked from the user's base role. */
+    revokedPermissions: string[];
+    /** Optional custom role IDs the user inherits from. */
+    customRoleIds: string[];
+    reason?: string;
+    createdBy: string;
+    createdAt: Date;
+    updatedAt: Date;
+    expiresAt?: Date;
+}
+export declare const ROLE_OVERRIDES_COLLECTION: "roleOverrides";
+export declare const ROLE_OVERRIDE_INDEXED_FIELDS: readonly ["userId", "storeId", "expiresAt", "createdAt"];
+export declare const DEFAULT_ROLE_OVERRIDE_DATA: Partial<RoleOverrideDocument>;
+export interface CustomRoleDocument {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string;
+    /** Permission keys this custom role confers. */
+    permissions: string[];
+    /** Optional parent role to inherit from. */
+    inheritsFrom?: string;
+    /** Where this role can be assigned. */
+    scope: "global" | "store";
+    isActive: boolean;
+    createdBy: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const CUSTOM_ROLES_COLLECTION: "customRoles";
+export declare const CUSTOM_ROLE_INDEXED_FIELDS: readonly ["slug", "scope", "isActive", "createdAt"];
+export declare const DEFAULT_CUSTOM_ROLE_DATA: Partial<CustomRoleDocument>;
+export type AdminNotificationCategory = "system" | "security" | "moderation" | "payouts" | "fraud" | "growth";
+export interface AdminNotificationDocument {
+    id: string;
+    category: AdminNotificationCategory;
+    title: string;
+    body: string;
+    severity: "info" | "warning" | "error";
+    isRead: boolean;
+    entityType?: string;
+    entityId?: string;
+    /** Admins this notification targets (empty = all admins). */
+    audienceUserIds: string[];
+    createdAt: Date;
+    readAt?: Date;
+}
+export declare const ADMIN_NOTIFICATIONS_COLLECTION: "adminNotifications";
+export declare const ADMIN_NOTIFICATION_INDEXED_FIELDS: readonly ["category", "severity", "isRead", "createdAt"];
+export declare const DEFAULT_ADMIN_NOTIFICATION_DATA: Partial<AdminNotificationDocument>;

package/dist/features/store-extensions/schemas/rbac.js

@@ -0,0 +1,43 @@
+/**
+ * RBAC — roleOverrides + customRoles
+ *
+ * S-STORE-9B-G foundation. Stores per-user permission patches and
+ * admin-defined custom roles. Used by the existing `hasPermission()`
+ * predicate via a layered lookup: builtin role → custom role → override.
+ */
+export const ROLE_OVERRIDES_COLLECTION = "roleOverrides";
+export const ROLE_OVERRIDE_INDEXED_FIELDS = [
+    "userId",
+    "storeId",
+    "expiresAt",
+    "createdAt",
+];
+export const DEFAULT_ROLE_OVERRIDE_DATA = {
+    grantedPermissions: [],
+    revokedPermissions: [],
+    customRoleIds: [],
+};
+export const CUSTOM_ROLES_COLLECTION = "customRoles";
+export const CUSTOM_ROLE_INDEXED_FIELDS = [
+    "slug",
+    "scope",
+    "isActive",
+    "createdAt",
+];
+export const DEFAULT_CUSTOM_ROLE_DATA = {
+    permissions: [],
+    isActive: true,
+    scope: "global",
+};
+export const ADMIN_NOTIFICATIONS_COLLECTION = "adminNotifications";
+export const ADMIN_NOTIFICATION_INDEXED_FIELDS = [
+    "category",
+    "severity",
+    "isRead",
+    "createdAt",
+];
+export const DEFAULT_ADMIN_NOTIFICATION_DATA = {
+    isRead: false,
+    severity: "info",
+    audienceUserIds: [],
+};

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

@@ -1,4 +1,6 @@
+"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
 import Link from "next/link";
 import { BaseListingCard, Heading, Span, Row, RichText, Div } from "../../../ui";
 import { MediaImage } from "../../media/MediaImage";
@@ -7,8 +9,10 @@ import { normalizeRichTextHtml } from "../../../utils";
 import { useLongPress } from "../../../react/hooks/useLongPress";
 export function InteractiveStoreCard({ store, href, selectable, isSelected = false, onSelect, labels = {}, className = "", }) {
     const initial = store.storeName[0]?.toUpperCase() ?? "S";
-    const hasLogo = Boolean(store.storeLogoURL);
-    const hasBanner = Boolean(store.storeBannerURL);
+    const [logoBroken, setLogoBroken] = useState(false);
+    const [bannerBroken, setBannerBroken] = useState(false);
+    const hasLogo = Boolean(store.storeLogoURL) && !logoBroken;
+    const hasBanner = Boolean(store.storeBannerURL) && !bannerBroken;
     const longPress = useLongPress(() => onSelect?.(store.id, !isSelected));
     return (_jsxs(Div, { className: [
             "group relative flex flex-col h-full overflow-hidden rounded-xl border bg-white dark:bg-zinc-900 shadow-sm transition-shadow hover:shadow-lg",
@@ -19,5 +23,5 @@ export function InteractiveStoreCard({ store, href, selectable, isSelected = fal
         ].join(" "), onMouseDown: !isSelected ? longPress.onMouseDown : undefined, onMouseUp: !isSelected ? longPress.onMouseUp : undefined, onMouseLeave: !isSelected ? longPress.onMouseLeave : undefined, onTouchStart: !isSelected ? longPress.onTouchStart : undefined, onTouchEnd: !isSelected ? longPress.onTouchEnd : undefined, children: [onSelect && (_jsx(BaseListingCard.Checkbox, { selected: isSelected, onSelect: (e) => {
                     e.preventDefault();
                     onSelect(store.id, !isSelected);
-                }, label: isSelected ? "Deselect store" : "Select store", position: "top-2 left-2", className: selectable || isSelected ? "opacity-100" : "opacity-0 group-hover:opacity-100 transition-opacity" })), _jsxs(Link, { href: href, className: "flex flex-col flex-1 min-h-0", children: [_jsxs(Div, { className: "relative aspect-video w-full overflow-hidden bg-gradient-to-br from-zinc-100 via-zinc-200 to-zinc-300 dark:from-zinc-800 dark:via-zinc-700 dark:to-zinc-900 flex-shrink-0", children: [hasBanner ? (_jsx(MediaImage, { src: store.storeBannerURL, alt: `${store.storeName} banner`, size: "banner", className: "h-full w-full object-cover transition-transform duration-500 group-hover:scale-105" })) : (_jsx(Div, { className: "absolute inset-0 flex items-center justify-center", children: _jsx(Span, { className: "text-5xl opacity-20 select-none", "aria-hidden": "true", children: "\uD83C\uDFEA" }) })), _jsx(Div, { className: "absolute inset-x-0 bottom-0 h-12 bg-gradient-to-t from-black/40 to-transparent pointer-events-none" }), store.averageRating != null && store.averageRating > 0 && (_jsxs(Div, { className: "absolute top-2 right-2 flex items-center gap-1 rounded-full bg-black/50 backdrop-blur-sm px-2 py-0.5 text-xs font-semibold text-yellow-300", children: ["\u2605 ", store.averageRating.toFixed(1)] }))] }), _jsxs(Div, { className: "flex flex-col flex-1 px-4 pb-4", children: [_jsx(Div, { className: "-mt-5 mb-2 flex items-end justify-between", children: _jsx(Div, { className: "flex-shrink-0", children: hasLogo ? (_jsx(MediaImage, { src: store.storeLogoURL, alt: store.storeName, size: "avatar", className: "h-10 w-10 rounded-lg border-2 border-white dark:border-zinc-800 shadow-md object-cover" })) : (_jsx(Div, { className: "flex h-10 w-10 items-center justify-center rounded-lg border-2 border-white dark:border-zinc-800 bg-primary/10 dark:bg-primary/20 text-base font-bold text-primary shadow-md", children: initial })) }) }), _jsx(Heading, { level: 3, className: `${THEME_CONSTANTS.utilities.textClamp1} text-sm font-bold text-zinc-900 dark:text-zinc-100 group-hover:text-primary transition-colors`, children: store.storeName }), store.storeDescription ? (_jsx(RichText, { html: normalizeRichTextHtml(store.storeDescription), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: `mt-1 ${THEME_CONSTANTS.utilities.textClamp2} text-xs text-zinc-500 dark:text-zinc-400 flex-1` })) : (_jsx(Div, { className: "flex-1" })), _jsxs(Row, { gap: "sm", className: "mt-2.5 flex-wrap text-xs text-zinc-500 dark:text-zinc-400", children: [store.totalProducts != null && store.totalProducts > 0 && (_jsxs(Span, { className: "flex items-center gap-0.5", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDCE6" }), " ", store.totalProducts, " ", labels.products ?? "products"] })), store.itemsSold != null && store.itemsSold > 0 && (_jsxs(Span, { className: "flex items-center gap-0.5", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDECD\uFE0F" }), " ", store.itemsSold, " ", labels.sold ?? "sold"] }))] }), _jsxs(Div, { className: "mt-3 pt-2.5 border-t border-zinc-100 dark:border-zinc-800 flex items-center justify-between", children: [_jsxs(Span, { className: "text-xs font-semibold text-primary group-hover:underline transition-colors", children: [labels.visitStore ?? "Visit store", " \u2192"] }), store.totalReviews != null && store.totalReviews > 0 && (_jsxs(Span, { className: "text-xs text-zinc-400 dark:text-zinc-500", children: [store.totalReviews, " ", labels.reviews ?? "reviews"] }))] })] })] })] }));
+                }, label: isSelected ? "Deselect store" : "Select store", position: "top-2 left-2", className: selectable || isSelected ? "opacity-100" : "opacity-0 group-hover:opacity-100 transition-opacity" })), _jsxs(Link, { href: href, className: "flex flex-col flex-1 min-h-0", children: [_jsxs(Div, { className: "relative aspect-video w-full overflow-hidden bg-gradient-to-br from-zinc-100 via-zinc-200 to-zinc-300 dark:from-zinc-800 dark:via-zinc-700 dark:to-zinc-900 flex-shrink-0", children: [hasBanner ? (_jsx(MediaImage, { src: store.storeBannerURL, alt: `${store.storeName} banner`, size: "banner", className: "h-full w-full object-cover transition-transform duration-500 group-hover:scale-105" })) : (_jsx(Div, { className: "absolute inset-0 flex items-center justify-center", children: _jsx(Span, { className: "text-5xl opacity-20 select-none", "aria-hidden": "true", children: "\uD83C\uDFEA" }) })), _jsx(Div, { className: "absolute inset-x-0 bottom-0 h-12 bg-gradient-to-t from-black/40 to-transparent pointer-events-none" }), store.averageRating != null && store.averageRating > 0 && (_jsxs(Div, { className: "absolute top-2 right-2 flex items-center gap-1 rounded-full bg-black/50 backdrop-blur-sm px-2 py-0.5 text-xs font-semibold text-yellow-300", children: ["\u2605 ", store.averageRating.toFixed(1)] }))] }), _jsxs(Div, { className: "flex flex-col flex-1 px-4 pb-4", children: [_jsx(Div, { className: "-mt-5 mb-2 flex items-end justify-between", children: _jsx(Div, { className: "flex-shrink-0", children: hasLogo ? (_jsx("img", { src: store.storeLogoURL, alt: store.storeName, className: "h-10 w-10 rounded-lg border-2 border-white dark:border-zinc-800 shadow-md object-cover bg-white dark:bg-zinc-800", onError: () => setLogoBroken(true), loading: "lazy" })) : (_jsx(Div, { className: "flex h-10 w-10 items-center justify-center rounded-lg border-2 border-white dark:border-zinc-800 bg-primary/10 dark:bg-primary/20 text-base font-bold text-primary shadow-md", children: initial })) }) }), _jsx(Heading, { level: 3, className: `${THEME_CONSTANTS.utilities.textClamp1} text-sm font-bold text-zinc-900 dark:text-zinc-100 group-hover:text-primary transition-colors`, children: store.storeName }), store.storeDescription ? (_jsx(RichText, { html: normalizeRichTextHtml(store.storeDescription), proseClass: "prose prose-sm max-w-none dark:prose-invert prose-p:my-0", className: `mt-1 ${THEME_CONSTANTS.utilities.textClamp2} text-xs text-zinc-500 dark:text-zinc-400 flex-1` })) : (_jsx(Div, { className: "flex-1" })), _jsxs(Row, { gap: "sm", className: "mt-2.5 flex-wrap text-xs text-zinc-500 dark:text-zinc-400", children: [store.totalProducts != null && store.totalProducts > 0 && (_jsxs(Span, { className: "flex items-center gap-0.5", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDCE6" }), " ", store.totalProducts, " ", labels.products ?? "products"] })), store.itemsSold != null && store.itemsSold > 0 && (_jsxs(Span, { className: "flex items-center gap-0.5", children: [_jsx(Span, { "aria-hidden": "true", children: "\uD83D\uDECD\uFE0F" }), " ", store.itemsSold, " ", labels.sold ?? "sold"] }))] }), _jsxs(Div, { className: "mt-3 pt-2.5 border-t border-zinc-100 dark:border-zinc-800 flex items-center justify-between", children: [_jsxs(Span, { className: "text-xs font-semibold text-primary group-hover:underline transition-colors", children: [labels.visitStore ?? "Visit store", " \u2192"] }), store.totalReviews != null && store.totalReviews > 0 && (_jsxs(Span, { className: "text-xs text-zinc-400 dark:text-zinc-500", children: [store.totalReviews, " ", labels.reviews ?? "reviews"] }))] })] })] })] }));
 }