@mohasinac/appkit 2.6.3 → 2.6.5

package/dist/index.js

@@ -924,8 +924,8 @@ export { requireRole } from "./security/index";
 export { resolvePermissions } from "./security/index";
 // ./repositories/index
 // [DB]-Database layer — uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
-// AddressRepository - Shared export for address repository.
-export { AddressRepository } from "./repositories/index";
+// AddressesRepository - unified top-level addresses collection (SB-UNI-A 2026-05-13).
+export { AddressesRepository } from "./repositories/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";
@@ -999,8 +999,8 @@ export { StoreRepository } from "./repositories/index";
 // UserRepository - Shared export for user repository.
 export { UserRepository } from "./repositories/index";
 // [DB]-Database layer — uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
-// addressRepository - Shared export for address repository.
-export { addressRepository } from "./repositories/index";
+// addressesRepository - unified addresses repo (ownerType discriminator). SB-UNI-A 2026-05-13.
+export { addressesRepository } from "./repositories/index";
 // [DB]-Database layer — uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // bidRepository - Shared export for bid repository.
 export { bidRepository } from "./repositories/index";
@@ -1074,9 +1074,8 @@ export { siteSettingsRepository } from "./repositories/index";
 // [DB]-Database layer — uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // smsCounterRepository - Shared export for sms counter repository.
 export { smsCounterRepository } from "./repositories/index";
-// [DB]-Database layer — uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
-// storeAddressRepository - Shared export for store address repository.
-export { storeAddressRepository } from "./repositories/index";
+// SB-UNI-A 2026-05-13 — storeAddressRepository deleted. Use addressesRepository
+// with ownerType:"store" via the unified addresses collection.
 // [DB]-Database layer — uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // storeRepository - Shared export for store repository.
 export { storeRepository } from "./repositories/index";
@@ -2078,6 +2077,11 @@ export { AdminBrandEditorView } from "./features/admin/index";
 export { AdminCategoriesView } from "./features/admin/index";
 // AdminCategoryEditorView - Component for admin category create/edit form.
 export { AdminCategoryEditorView } from "./features/admin/index";
+// S-SBUNI-4 2026-05-13 — admin bundle CRUD views.
+export { AdminBundlesView } from "./features/admin/index";
+export { AdminBundleEditorView } from "./features/admin/index";
+// S-SBUNI-4 2026-05-13 — multi-select bundle items picker (centerpiece UI primitive).
+export { BundleItemsPicker, defaultBundleItemsFetch, } from "./features/categories/components/BundleItemsPicker";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // AdminCouponsView - Component for admin coupons view.
 export { AdminCouponsView } from "./features/admin/index";
@@ -2125,6 +2129,9 @@ export { AdminPageHeader } from "./features/admin/index";
 // AdminPayoutsView - Component for admin payouts view.
 export { AdminPayoutsView } from "./features/admin/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
+// AdminPrizeDrawsView - Component for admin prize draws listing view (SB4-E).
+export { AdminPrizeDrawsView } from "./features/admin/index";
+// [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // AdminProductsView - Component for admin products view.
 export { AdminProductsView } from "./features/admin/index";
 // AdminProductEditorView - Component for admin product create/edit form (3-mode: standard/auction/pre-order).
@@ -2879,6 +2886,8 @@ export { removeCartItem } from "./features/cart/server";
 // [SERVER-ONLY]-Server-only — uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
 // updateCartItem - Helper for update cart item.
 export { updateCartItem } from "./features/cart/server";
+// [SERVER-ONLY]-Server-only — cart item shipping provider update.
+export { updateCartItemShipping } from "./features/cart/server";
 // ./features/cart/schemas/index
 // [SCHEMA]-Schema / data-shape constant — Zod validator, default-value object, or Firestore collection/field name constant.
 // CART_COLLECTION - Constant used across modules.
@@ -3351,6 +3360,10 @@ export { EventPollWidget } from "./features/events/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // EventStatusBadge - Component for event status badge.
 export { EventStatusBadge } from "./features/events/index";
+// EventRaffleWinnerView - Public-facing winner card for an event raffle.
+export { EventRaffleWinnerView } from "./features/events/index";
+// SpinWheelView - Spin-the-wheel client component for spin-wheel events.
+export { SpinWheelView } from "./features/events/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // EventsListView - Component for events list view.
 export { EventsListView } from "./features/events/index";
@@ -4047,6 +4060,9 @@ export { OrderStatusValues } from "./features/orders/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // OrdersList - Shared export for orders list.
 export { OrdersList } from "./features/orders/index";
+export { OrderSiblingPayments } from "./features/orders/index";
+export { RefundHistoryTable } from "./features/orders/index";
+export { RefundRequestView } from "./features/orders/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // PaymentGatewayValues - Model for payment gateway values.
 export { PaymentGatewayValues } from "./features/orders/index";
@@ -4238,6 +4254,14 @@ export { AuctionDetailView } from "./features/products/index";
 export { AuctionDetailPageView } from "./features/auctions/index";
 // [SERVER-RSC]-Self-fetching index page view for auctions.
 export { AuctionsListView } from "./features/auctions/components/AuctionsListView";
+// [SERVER-RSC]-Self-fetching index page view for `/bundles` (categoryType:"bundle" rows).
+export { BundlesListView } from "./features/categories/components/BundlesListView";
+// S-SBUNI-3 2026-05-13 — public bundle detail view (rebuilt after SB-UNI-V deletion).
+export { BundleDetailView } from "./features/categories/components/BundleDetailView";
+// S-SBUNI-5 2026-05-13 — functional Add-to-cart CTA client island.
+export { BundleBuyNowCta } from "./features/categories/components/BundleBuyNowCta";
+// CategoryBundlesListing is also re-exported lower in this file (line ~8871);
+// the canonical export lives there next to BUNDLE_MIN_ITEMS / BUNDLE_MAX_ITEMS.
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // AuctionsView - Component for auctions view.
 export { AuctionsView } from "./features/products/index";
@@ -4309,13 +4333,13 @@ export { PreOrderDetailView } from "./features/products/index";
 // PreOrdersView - Component for pre orders view.
 export { PreOrdersView } from "./features/products/index";
 // [SERVER-RSC]-Public listing for prize-draw products (SB4-F).
-export { PrizeDrawsListingView } from "./features/products/index";
+export { PrizeDrawsListingView } from "./features/products/components/PrizeDrawsListingView";
 // [CLIENT]-Client toolbar+grid for prize draws (SB4-F).
 export { PrizeDrawsIndexListing } from "./features/products/index";
 // [CLIENT]-Marketplace card for prize draws (SB4-F).
 export { MarketplacePrizeDrawCard } from "./features/products/index";
 // [SERVER-RSC]-Public detail page for a prize-draw product (SB4-G).
-export { PrizeDrawDetailPageView } from "./features/products/index";
+export { PrizeDrawDetailPageView } from "./features/products/components/PrizeDrawDetailPageView";
 // [CLIENT]-Buy panel client for prize-draw detail (consent + add-to-cart) (SB4-G).
 export { PrizeDrawEntryActions } from "./features/products/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
@@ -4387,7 +4411,18 @@ export { getProductSortOptions } from "./features/products/index";
 export { getProductTableColumns } from "./features/products/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // normalizeListingType + predicate helpers — canonical SB1-G accessors.
-export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, } from "./features/products/index";
+// SB-UNI-F 2026-05-13 — Phase 2 predicates added (classified/digital-code/live).
+export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, } from "./features/products/index";
+// SB-UNI-X4 2026-05-13 — per-type feature-flag helpers.
+export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, } from "./_internal/shared/listing-types/feature-flags";
+// SB-UNI-X5 2026-05-13 — action telemetry sink.
+export { actionTracker, setActionTrackerSink, resetActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";
+// SB-UNI-S 2026-05-13 — cart-level shipping-requirement helpers.
+export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_internal/shared/listing-types/cart-shipping";
+// SB-UNI-W-1 2026-05-13 — CTA action registry shell.
+export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, } from "./_internal/shared/actions/action-registry";
+// User-role predicates — SB-UNI-E 2026-05-13.
+export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, } from "./features/auth/role-predicates";
 // [SERVER-ONLY]-Safe in browser but intended for server routes.
 // sanitizeProductForPublic - Strip sellerId/sellerName/sellerEmail/ownerId before returning a product in a public response.
 export { sanitizeProductForPublic, sanitizeProductsForPublic } from "./features/products/index";
@@ -4845,6 +4880,12 @@ export { SellerPayoutStats } from "./features/seller/index";
 // SellerPayoutsView - Component for seller payouts view.
 export { SellerPayoutsView } from "./features/seller/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
+// SellerPreOrdersView - Component for seller pre-orders listing view (SB4-E).
+export { SellerPreOrdersView } from "./features/seller/index";
+// [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
+// SellerPrizeDrawsView - Component for seller prize draws listing view (SB4-E).
+export { SellerPrizeDrawsView } from "./features/seller/index";
+// [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
 // SellerProductsView - Component for seller products view.
 export { SellerProductsView } from "./features/seller/index";
 // [CLIENT-SSR]-Runs in both SSR and browser — React component or hook that does not depend on browser-only APIs.
@@ -5363,7 +5404,7 @@ export { useMediaQuery, useBreakpoint, useClickOutside, useKeyPress, useLongPres
 // Missing auth feature components
 export { RoleGate, ProtectedRoute, SocialAuthButtons, AuthStatusPanel, LoginForm, RegisterForm, ForgotPasswordView, ResetPasswordView, VerifyEmailView, OAuthLoadingView, } from "./features/auth/index";
 // Missing cart and checkout feature components
-export { CartItemRow, CartDrawer, CartView, CartSummary } from "./features/cart/index";
+export { CartItemRow, CartDrawer, CartView, CartSummary, ShippingPicker } from "./features/cart/index";
 export { CheckoutView, CheckoutAddressStep, CheckoutOtpModal, CheckoutSuccessView } from "./features/cart/index";
 export { CheckoutStepper, useCheckout } from "./features/checkout/index";
 // PaymentGateway already exported from checkout types above
@@ -5385,6 +5426,8 @@ export { TextLink } from "./ui/index";
 export { SUCCESS_MESSAGES } from "./values/index";
 // -- Missing order utils
 export { splitCartIntoOrderGroups } from "./features/orders/index";
+// S-SBUNI-5 2026-05-13 — bundle-aware order item grouping for receipts.
+export { groupOrderItemsByBundle, } from "./features/orders/index";
 // -- Missing utils
 export { buildSieveFilters } from "./utils/filter.helper";
 export { formatFileSize } from "./utils/number.formatter";
@@ -5407,6 +5450,10 @@ export { productFeatureAdminCreateSchema, productFeatureStoreCreateSchema, produ
 export { LISTING_PARAM_NAMES, parseListingParams, parseListingSearchParams, serializeListingParams, } from "./utils/listing-params";
 // Product features UI option lists (S8 refactor — shared by editor + selector)
 export { PRODUCT_FEATURE_CATEGORY_OPTIONS, PRODUCT_FEATURE_PRODUCT_TYPE_OPTIONS, PRODUCT_FEATURE_SCOPE_OPTIONS, PRODUCT_FEATURE_ICON_COLOR_OPTIONS, PRODUCT_FEATURE_SCOPE_TABS, PRODUCT_FEATURE_DEFAULT_DISPLAY_ORDER, PRODUCT_FEATURE_CARD_MAX_VISIBLE, PRODUCT_FEATURE_QUERY_STALE_MS, } from "./features/products/constants/product-features.constants";
+// SB10-A listing tab constants
+export { CATEGORY_PAGE_TABS, STORE_PAGE_TABS, SELLER_LISTING_TABS, SEARCH_RESULT_TABS, } from "./features/products/constants/listing-tabs";
+// SB10-C admin + seller filter-chip tab sets (S8 2026-05-13)
+export { ALL_TAB, EMPTY_TAB, ADMIN_PRODUCT_STATUS_TABS, ADMIN_PRODUCT_LISTING_TYPE_TABS, ADMIN_BLOG_STATUS_TABS, ADMIN_USER_STATUS_TABS, ADMIN_USER_ROLE_TABS, ADMIN_STORE_STATUS_TABS, ADMIN_PAYOUT_STATUS_TABS, ADMIN_ORDER_STATUS_TABS, ADMIN_REVIEW_STATUS_TABS, ADMIN_REVIEW_RATING_TABS, ADMIN_BID_STATUS_TABS, ADMIN_CONTACT_STATUS_TABS, ADMIN_NEWSLETTER_STATUS_TABS, ADMIN_EVENT_ENTRY_STATUS_TABS, ADMIN_EVENT_STATUS_TABS, ADMIN_CART_OWNERSHIP_TABS, ADMIN_COUPON_TYPE_TABS, SELLER_PRODUCT_STATUS_TABS, SELLER_AUCTION_STATUS_TABS, SELLER_ORDER_STATUS_TABS, SELLER_OFFER_STATUS_TABS, SELLER_BID_STATUS_TABS, } from "./features/admin/constants/filter-tabs";
 // Grouped listings feature schemas
 export { GROUPED_LISTINGS_COLLECTION } from "./features/grouped/schemas/firestore";
 // SB-UNI-D + V — BundleDocument + bundlesRepository + features/bundles/
@@ -5416,6 +5463,12 @@ export { GROUPED_LISTINGS_COLLECTION } from "./features/grouped/schemas/firestor
 // Replacement component: CategoryBundlesListing in features/categories/components.
 export { CategoryBundlesListing } from "./features/categories/components/CategoryBundlesListing";
 export { BUNDLE_MIN_ITEMS, BUNDLE_MAX_ITEMS, BUNDLE_MAX_PER_USER_DEFAULT, BUNDLES_PAGE_SIZE, BUNDLES_FEATURED_LIMIT, } from "./_internal/shared/features/categories/bundle-config";
+// S-SBUNI-4 follow-up — shared bundle UI copy + stock-badge variant map.
+export { BUNDLE_COPY, BUNDLE_STOCK_VARIANT, } from "./_internal/shared/features/categories/bundle-copy";
+// S-SBUNI-RULES 2026-05-13 — shared copy for refund / shipping / sibling-payment UI.
+export { REFUND_COPY } from "./_internal/shared/features/orders/refund-copy";
+// S-SBUNI-4 follow-up — shared admin bundle zod schemas.
+export { bundleCreateSchema, bundleUpdateSchema, bundleQueryRuleSchema, bundleDisplaySchema, } from "./_internal/shared/features/categories/bundle-schemas";
 // Scam registry — seed data
 export { scammersSeedData } from "./seed/index";
 // Product features — seed data (FI2)
@@ -5456,5 +5509,7 @@ export { renderPrivateProfileOgImage, renderUserProfileOgImage } from "./_intern
 // Listing-type capability registry — SB-UNI X1.
 export { LISTING_TYPE_CAPABILITIES, capabilityFor, canAddToCart, canBid, supportsShipping, requiresVendorVerified, requiresJurisdictionCheck, hasInstantFulfillment, assertNever, } from "./_internal/shared/listing-types/capabilities";
 export { LISTING_TYPE_REGISTRY, pluginFor } from "./_internal/shared/listing-types/_registry";
+// Checkout rule registry — pure TS, safe in both client and server bundles.
+export { getListingRule, getCategoryRule, pickOrderType, getSplitKey, runSyncPreflight, CHECKOUT_RULES, CATEGORY_CHECKOUT_RULES, CHECKOUT_MAX_ORDERS_PER_TX, PRIZE_DRAW_MAX_REVEALS_PER_ORDER, BUNDLE_MAX_QTY_PER_TX, STANDARD_MAX_QTY_PER_LINE, } from "./_internal/shared/checkout/rules";
 // Media upload limits — pure constants, safe in both client and server bundles.
 export { MEGABYTE, MAX_IMAGE_BYTES, MAX_PDF_BYTES, MAX_VIDEO_BYTES, MAX_LABEL, MAX_BYTES, ALLOWED_IMAGE_MIMES, ALLOWED_VIDEO_MIMES, ALLOWED_DOC_MIMES, ALLOWED_MIMES, ALLOWED_TYPES_LABEL, MIME_TO_EXT, PDF_MAGIC, VIDEO_CONVERSION_HINTS, classifyMime, isAllowedMime, maxBytesFor, getConversionHint, } from "./_internal/shared/media/limits";

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

@@ -72,6 +72,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly EVENTS: "/events";
         readonly EVENT_DETAIL: (id: string) => string;
         readonly EVENT_PARTICIPATE: (id: string) => string;
+        readonly EVENT_LEADERBOARD: (id: string) => string;
+        readonly EVENT_WINNER: (id: string) => string;
         readonly SUBLISTING_CATEGORIES: "/sublisting-categories";
         readonly SUBLISTING_CATEGORY: (slug: string) => string;
         readonly SUPPORT: "/support";
@@ -224,6 +226,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly FEATURES_NEW: "/admin/features/new";
         readonly FEATURES_EDIT: (id: string) => string;
         readonly BUNDLES: "/admin/bundles";
+        readonly BUNDLES_NEW: "/admin/bundles/new";
         readonly BUNDLES_EDIT: (id: string) => string;
         readonly PRIZE_DRAWS: "/admin/prize-draws";
         readonly PRIZE_DRAWS_EDIT: (id: string) => string;
@@ -298,6 +301,8 @@ export declare const ROUTES: {
         readonly EVENTS: "/events";
         readonly EVENT_DETAIL: (id: string) => string;
         readonly EVENT_PARTICIPATE: (id: string) => string;
+        readonly EVENT_LEADERBOARD: (id: string) => string;
+        readonly EVENT_WINNER: (id: string) => string;
         readonly SUBLISTING_CATEGORIES: "/sublisting-categories";
         readonly SUBLISTING_CATEGORY: (slug: string) => string;
         readonly SUPPORT: "/support";
@@ -450,6 +455,7 @@ export declare const ROUTES: {
         readonly FEATURES_NEW: "/admin/features/new";
         readonly FEATURES_EDIT: (id: string) => string;
         readonly BUNDLES: "/admin/bundles";
+        readonly BUNDLES_NEW: "/admin/bundles/new";
         readonly BUNDLES_EDIT: (id: string) => string;
         readonly PRIZE_DRAWS: "/admin/prize-draws";
         readonly PRIZE_DRAWS_EDIT: (id: string) => string;

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

@@ -60,6 +60,8 @@ export const DEFAULT_ROUTE_MAP = {
         EVENTS: "/events",
         EVENT_DETAIL: (id) => `/events/${id}`,
         EVENT_PARTICIPATE: (id) => `/events/${id}/participate`,
+        EVENT_LEADERBOARD: (id) => `/events/${id}/leaderboard`,
+        EVENT_WINNER: (id) => `/events/${id}/winner`,
         SUBLISTING_CATEGORIES: "/sublisting-categories",
         SUBLISTING_CATEGORY: (slug) => `/sublisting-categories/${slug}`,
         SUPPORT: "/support",
@@ -213,7 +215,9 @@ export const DEFAULT_ROUTE_MAP = {
         FEATURES_NEW: "/admin/features/new",
         FEATURES_EDIT: (id) => `/admin/features/${id}/edit`,
         // SB1-J — bundles + prize draws (admin moderation)
+        // S-SBUNI-4 — BUNDLES_NEW added alongside BUNDLES_EDIT.
         BUNDLES: "/admin/bundles",
+        BUNDLES_NEW: "/admin/bundles/new",
         BUNDLES_EDIT: (id) => `/admin/bundles/${id}/edit`,
         PRIZE_DRAWS: "/admin/prize-draws",
         PRIZE_DRAWS_EDIT: (id) => `/admin/prize-draws/${id}/edit`,

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

@@ -1,9 +1,13 @@
 /**
  * Firebase Admin SDK singletons.
  *
- * Supports two init methods (checked in order):
+ * Supports three init methods (checked in order):
  *   1. `firebase-admin-key.json` in process.cwd() — development
- *   2. FIREBASE_ADMIN_PROJECT_ID / CLIENT_EMAIL / PRIVATE_KEY env vars — production
+ *   2. FIREBASE_ADMIN_PROJECT_ID / CLIENT_EMAIL / PRIVATE_KEY env vars — Vercel
+ *   3. Application Default Credentials — Firebase Functions / Cloud Run /
+ *      GCE / GKE. Detected via FUNCTION_TARGET / K_SERVICE / FIREBASE_CONFIG /
+ *      GOOGLE_APPLICATION_CREDENTIALS. Calls `initializeApp()` with no
+ *      credential — the SDK resolves credentials via the GCE metadata server.
  *
  * All getters are lazy — the SDK is not touched until first use.
  */

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

@@ -91,6 +91,29 @@ export function getAdminApp() {
                 databaseURL: dbUrl,
             });
         }
+        else if (
+        // Application Default Credentials — Firebase Functions / Cloud Run / GCE.
+        // FUNCTION_TARGET is set by Gen 2 Functions; K_SERVICE by Cloud Run;
+        // FIREBASE_CONFIG is auto-injected by Firebase; GOOGLE_APPLICATION_CREDENTIALS
+        // is set when a JSON key path is provided. In any of these cases call
+        // `initializeApp()` with no credential — the SDK resolves creds from the
+        // metadata server.
+        process.env.FUNCTION_TARGET ||
+            process.env.K_SERVICE ||
+            process.env.FIREBASE_CONFIG ||
+            process.env.GOOGLE_APPLICATION_CREDENTIALS) {
+            const firebaseConfig = process.env.FIREBASE_CONFIG
+                ? JSON.parse(process.env.FIREBASE_CONFIG)
+                : {};
+            const projectId = firebaseConfig.projectId ?? process.env.GCLOUD_PROJECT ?? "";
+            const dbUrl = firebaseConfig.databaseURL ??
+                process.env.FIREBASE_ADMIN_DATABASE_URL ??
+                process.env.NEXT_PUBLIC_FIREBASE_DATABASE_URL ??
+                (projectId
+                    ? `https://${projectId}-default-rtdb.firebaseio.com`
+                    : undefined);
+            app = initializeApp(dbUrl ? { databaseURL: dbUrl } : undefined);
+        }
         else {
             throw new Error("@mohasinac/db-firebase: Firebase Admin credentials not found.\n" +
                 "Add firebase-admin-key.json to project root, or set " +

package/dist/repositories/index.d.ts

@@ -9,14 +9,13 @@ export { unitOfWork } from "../core";
 export type { UnitOfWork } from "../core";
 export { UserRepository, userRepository, EmailVerificationTokenRepository, PasswordResetTokenRepository, emailVerificationTokenRepository, passwordResetTokenRepository, tokenRepository, SessionRepository, sessionRepository, } from "../features/auth/repository";
 export { SmsCounterRepository, smsCounterRepository, } from "../features/auth/repository/sms-counter.repository";
-export { AddressRepository, addressRepository, } from "../features/account/repository/address.repository";
+export { AddressesRepository, addressesRepository, } from "../features/addresses";
 export { ProductRepository, ProductsRepository, productRepository, } from "../features/products/repository/products.repository";
 export { OrderRepository, OrdersRepository, orderRepository, } from "../features/orders/repository/orders.repository";
 export { ReviewRepository, ReviewsRepository, reviewRepository, } from "../features/reviews/repository/reviews.repository";
 export { bidRepository } from "../features/auctions/repository/bid.repository";
 export { CartRepository, cartRepository, } from "../features/cart/repository/cart.repository";
 export { StoreRepository, storeRepository, } from "../features/stores/repository/store.repository";
-export { storeAddressRepository } from "../features/stores/repository/store-address.repository";
 export { siteSettingsRepository } from "../features/admin/repository/site-settings.repository";
 export { notificationRepository } from "../features/admin/repository/notification.repository";
 export { chatRepository } from "../features/admin/repository/chat.repository";

package/dist/repositories/index.js

@@ -11,7 +11,9 @@ export { unitOfWork } from "../core";
 // Core repositories
 export { UserRepository, userRepository, EmailVerificationTokenRepository, PasswordResetTokenRepository, emailVerificationTokenRepository, passwordResetTokenRepository, tokenRepository, SessionRepository, sessionRepository, } from "../features/auth/repository";
 export { SmsCounterRepository, smsCounterRepository, } from "../features/auth/repository/sms-counter.repository";
-export { AddressRepository, addressRepository, } from "../features/account/repository/address.repository";
+// SB-UNI-A 2026-05-13 — top-level `addresses` collection with ownerType discriminator.
+// Replaces the two prior subcollection repositories (account/address + stores/store-address).
+export { AddressesRepository, addressesRepository, } from "../features/addresses";
 export { ProductRepository, ProductsRepository, productRepository, } from "../features/products/repository/products.repository";
 export { OrderRepository, OrdersRepository, orderRepository, } from "../features/orders/repository/orders.repository";
 export { ReviewRepository, ReviewsRepository, reviewRepository, } from "../features/reviews/repository/reviews.repository";
@@ -19,7 +21,8 @@ export { ReviewRepository, ReviewsRepository, reviewRepository, } from "../featu
 export { bidRepository } from "../features/auctions/repository/bid.repository";
 export { CartRepository, cartRepository, } from "../features/cart/repository/cart.repository";
 export { StoreRepository, storeRepository, } from "../features/stores/repository/store.repository";
-export { storeAddressRepository } from "../features/stores/repository/store-address.repository";
+// SB-UNI-A 2026-05-13 — storeAddressRepository deleted. Use addressesRepository
+// with ownerType:"store" instead.
 export { siteSettingsRepository } from "../features/admin/repository/site-settings.repository";
 export { notificationRepository } from "../features/admin/repository/notification.repository";
 export { chatRepository } from "../features/admin/repository/chat.repository";

package/dist/security/authorization.d.ts

@@ -8,7 +8,8 @@
  * they depend on Firebase Admin and the user repository; implement them in your
  * app layer using these primitives.
  */
-export type UserRole = "admin" | "moderator" | "seller" | "user";
+import type { UserRole } from "../features/auth/types";
+export type { UserRole };
 export declare function requireAuth(user: unknown): void;
 export declare function requireRole(user: Record<string, unknown> | null | undefined, roles: UserRole | UserRole[]): void;
 export declare function requireOwnership(user: Record<string, unknown> | null | undefined, resourceOwnerId: string): void;

package/dist/security/authorization.js

@@ -11,8 +11,9 @@
 import { AuthenticationError, AuthorizationError } from "../errors";
 import { ERROR_MESSAGES } from "../errors/messages";
 const ROLE_HIERARCHY = {
-    admin: 4,
-    moderator: 3,
+    admin: 5,
+    moderator: 4,
+    employee: 3,
     seller: 2,
     user: 1,
 };

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" | "storeAddresses" | "carts" | "wishlists" | "history" | "conversations" | "groupedListings" | "scammerProfiles" | "productFeatures";
+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" | "productFeatures";
 export interface SeedOperationResult {
     success?: boolean;
     message: string;

package/dist/seed/bids-seed-data.d.ts

@@ -1,7 +1,7 @@
 /**
  * Bids Seed Data — Collectibles Edition
- * Realistic bid progressions for the 4 active/ended auctions in P17.
- * Upcoming auction (auction-beyblade-metal-fusion-signed) has 0 bids.
+ * Realistic bid progressions for every auction with bidCount > 0.
+ * Auctions with bidCount = 0 (upcoming / no-bid) are intentionally absent.
  * Buyer IDs from P15 users seed data.
  */
 import type { BidDocument } from "../features/auctions/schemas";

package/dist/seed/bids-seed-data.js

@@ -1,7 +1,7 @@
 /**
  * Bids Seed Data — Collectibles Edition
- * Realistic bid progressions for the 4 active/ended auctions in P17.
- * Upcoming auction (auction-beyblade-metal-fusion-signed) has 0 bids.
+ * Realistic bid progressions for every auction with bidCount > 0.
+ * Auctions with bidCount = 0 (upcoming / no-bid) are intentionally absent.
  * Buyer IDs from P15 users seed data.
  */
 const NOW = new Date();
@@ -558,6 +558,81 @@ export const bidsSeedData = [
         winningIndex: -1, // reserve not met — no winner
         slugPrefix: "bid-skyline-fail",
     }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-nendoroid-miku-100-limited — ACTIVE, ends in 4h, 7 bids → current ₹11,999
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-nendoroid-miku-100-limited",
+        productTitle: "Good Smile Company Nendoroid Hatsune Miku #100 (Original Release, Rare) — AUCTION",
+        amounts: [499900, 599900, 699900, 799900, 899900, 1049900, 1199900],
+        bidders: [
+            { id: "user-priya-patel", name: "Priya Patel", email: "priya.patel@gmail.com" },
+            { id: "user-divya-menon", name: "Divya Menon", email: "divya.menon@gmail.com" },
+            { id: "user-priya-patel", name: "Priya Patel", email: "priya.patel@gmail.com" },
+            { id: "user-pooja-sharma", name: "Pooja Sharma", email: "pooja.sharma@gmail.com" },
+            { id: "user-divya-menon", name: "Divya Menon", email: "divya.menon@gmail.com" },
+            { id: "user-meera-nair", name: "Meera Nair", email: "meera.nair@gmail.com" },
+            { id: "user-priya-patel", name: "Priya Patel", email: "priya.patel@gmail.com" },
+        ],
+        daysAgoForFirst: 9,
+        endsActive: true,
+        slugPrefix: "bid-miku-100",
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-pokemon-mew-1st-edition-psa10 — ACTIVE, ends in 24h, 3 bids → current ₹1,49,999
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-pokemon-mew-1st-edition-psa10",
+        productTitle: "Pokémon Mew #151 1st Edition — PSA 10 GEM MINT (AUCTION)",
+        amounts: [9999900, 12499900, 14999900],
+        bidders: [
+            { id: "user-arjun-singh", name: "Arjun Singh", email: "arjun.singh@gmail.com" },
+            { id: "user-rahul-sharma", name: "Rahul Sharma", email: "rahul.sharma@gmail.com" },
+            { id: "user-siddharth-rao", name: "Siddharth Rao", email: "siddharth.rao@gmail.com" },
+        ],
+        daysAgoForFirst: 5,
+        endsActive: true,
+        slugPrefix: "bid-mew-1ed",
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-yugioh-blue-eyes-lob-1st-psa9 — ACTIVE, ends in 72h, 8 bids → current ₹79,999
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-yugioh-blue-eyes-lob-1st-psa9",
+        productTitle: "Yu-Gi-Oh! Blue-Eyes White Dragon LOB 1st Edition — PSA 9 MINT (AUCTION)",
+        amounts: [2999900, 3499900, 4249900, 4999900, 5749900, 6499900, 7249900, 7999900],
+        bidders: [
+            { id: "user-rahul-sharma", name: "Rahul Sharma", email: "rahul.sharma@gmail.com" },
+            { id: "user-priya-singh", name: "Priya Singh", email: "priya.singh@gmail.com" },
+            { id: "user-arjun-singh", name: "Arjun Singh", email: "arjun.singh@gmail.com" },
+            { id: "user-amit-sharma", name: "Amit Sharma", email: "amit.sharma@gmail.com" },
+            { id: "user-rahul-sharma", name: "Rahul Sharma", email: "rahul.sharma@gmail.com" },
+            { id: "user-rohit-verma", name: "Rohit Verma", email: "rohit.verma@gmail.com" },
+            { id: "user-priya-singh", name: "Priya Singh", email: "priya.singh@gmail.com" },
+            { id: "user-arjun-singh", name: "Arjun Singh", email: "arjun.singh@gmail.com" },
+        ],
+        daysAgoForFirst: 7,
+        endsActive: true,
+        slugPrefix: "bid-bewd-lob",
+    }),
+    // ═══════════════════════════════════════════════════════════════════════════
+    // auction-hot-wheels-redline-deora-japan — ACTIVE, ends in 36h, 5 bids → current ₹17,999
+    // ═══════════════════════════════════════════════════════════════════════════
+    ...buildBidLadder({
+        productId: "auction-hot-wheels-redline-deora-japan",
+        productTitle: "Hot Wheels Redline Deora — Japan Issue (AUCTION)",
+        amounts: [899900, 1099900, 1299900, 1499900, 1799900],
+        bidders: [
+            { id: "user-varun-bhat", name: "Varun Bhat", email: "varun.bhat@gmail.com" },
+            { id: "user-kiran-reddy", name: "Kiran Reddy", email: "kiran.reddy@gmail.com" },
+            { id: "user-preeti-joshi", name: "Preeti Joshi", email: "preeti.joshi@gmail.com" },
+            { id: "user-varun-bhat", name: "Varun Bhat", email: "varun.bhat@gmail.com" },
+            { id: "user-meera-nair", name: "Meera Nair", email: "meera.nair@gmail.com" },
+        ],
+        daysAgoForFirst: 6,
+        endsActive: true,
+        slugPrefix: "bid-deora-jp",
+    }),
 ];
 /**
  * Builds a strictly-increasing bid ladder for an auction. Status flags are

package/dist/seed/cart-seed-data.d.ts

@@ -1,19 +1,19 @@
 /**
- * Carts Seed Data — LetItRip Collectibles
+ * Carts Seed Data — LetItRip Collectibles
  *
  * Covers all cart states for testing Add-to-Cart / Update / Remove / Checkout flows:
- *   — Multi-item cart (cross-store, mixed categories) — Rahul Sharma
- *   — Single-item cart                                — Priya Patel
- *   — Cart with auction item                          — Arjun Singh
- *   — Cart with quantity > 1                          — Meera Nair
- *   — Empty cart (items: [])                          — Amit Sharma
+ *   — Multi-item cart (cross-store, mixed categories) — Rahul Sharma
+ *   — Single-item cart                                — Priya Patel
+ *   — Cart with auction item                          — Arjun Singh
+ *   — Cart with quantity > 1                          — Meera Nair
+ *   — Empty cart (items: [])                          — Amit Sharma
  *
- * Cart document ID = userId (O(1) lookup — see cart.ts schema).
+ * Cart document ID = userId (O(1) lookup — see cart.ts schema).
  *
  * All FK references:
- *   userId             → users/{uid}  (see users-seed-data.ts)
- *   items[].productId  → products/{id} (see products-standard/auctions-seed-data.ts)
- *   items[].storeId    → stores/{id}  (see stores-seed-data.ts)
+ *   userId             → users/{uid}  (see users-seed-data.ts)
+ *   items[].productId  → products/{id} (see products-standard/auctions-seed-data.ts)
+ *   items[].storeId    → stores/{id}  (see stores-seed-data.ts)
  */
 import type { CartDocument } from "../features/cart/schemas";
 export declare const cartsSeedData: CartDocument[];

package/dist/seed/cart-seed-data.js

@@ -13,13 +13,13 @@ export const cartsSeedData = [
             {
                 itemId: "cartitem-rahul-pokemon-etb-001",
                 productId: "product-pokemon-sv-etb",
-                productTitle: "Pokémon Scarlet & Violet Elite Trainer Box",
+                productTitle: "Pokémon Scarlet & Violet Elite Trainer Box",
                 productImage: "/media/product-image-pokemon-sv-etb-1-20260101.jpg",
                 price: 349900,
                 currency: _CURRENCY,
                 quantity: 1,
                 storeId: "store-pokemon-palace",
-                storeName: "Pokémon Palace",
+                storeName: "Pokémon Palace",
                 listingType: "standard",
                 addedAt: daysAgo(9),
                 updatedAt: daysAgo(9),
@@ -89,13 +89,13 @@ export const cartsSeedData = [
             {
                 itemId: "cartitem-arjun-pokemon-base-auction-001",
                 productId: "auction-pokemon-base-set-booster-box",
-                productTitle: "Pokémon Base Set 1st Edition Booster Box (SEALED AUCTION)",
+                productTitle: "Pokémon Base Set 1st Edition Booster Box (SEALED AUCTION)",
                 productImage: "/media/auction-image-pokemon-base-set-booster-box-1-20260101.jpg",
                 price: 45000000,
                 currency: _CURRENCY,
                 quantity: 1,
                 storeId: "store-pokemon-palace",
-                storeName: "Pokémon Palace",
+                storeName: "Pokémon Palace",
                 listingType: "auction",
                 addedAt: daysAgo(17),
                 updatedAt: daysAgo(17),
@@ -127,13 +127,13 @@ export const cartsSeedData = [
             {
                 itemId: "cartitem-meera-pokemon151-001",
                 productId: "product-pokemon-151-booster-box",
-                productTitle: "Pokémon 151 Booster Box (Japanese)",
+                productTitle: "Pokémon 151 Booster Box (Japanese)",
                 productImage: "/media/product-image-pokemon-151-booster-box-1-20260101.jpg",
                 price: 699900,
                 currency: _CURRENCY,
                 quantity: 3,
                 storeId: "store-pokemon-palace",
-                storeName: "Pokémon Palace",
+                storeName: "Pokémon Palace",
                 listingType: "standard",
                 addedAt: daysAgo(11),
                 updatedAt: daysAgo(11),
@@ -166,13 +166,13 @@ export const cartsSeedData = [
         createdAt: daysAgo(27),
         updatedAt: daysAgo(9),
     },
-    // ── P29 expansion (S17 2026-05-12) — 15 more carts via helper ───────────
+    // ── P29 expansion (S17 2026-05-12) — 15 more carts via helper ───────────
     ...mkCart("user-kavya-iyer", 6, [
         {
             productId: "product-pokemon-151-booster-box",
-            title: "Pokémon 151 Booster Box (36-pack)",
+            title: "Pokémon 151 Booster Box (36-pack)",
             price: 1799900,
-            store: ["store-pokemon-palace", "Pokémon Palace"],
+            store: ["store-pokemon-palace", "Pokémon Palace"],
             qty: 1,
         },
     ]),
@@ -204,9 +204,9 @@ export const cartsSeedData = [
     ...mkCart("user-divya-menon", 8, [
         {
             productId: "preorder-pokemon-stellar-crown-etb",
-            title: "PRE-ORDER: Pokémon Stellar Crown ETB",
+            title: "PRE-ORDER: Pokémon Stellar Crown ETB",
             price: 599900,
-            store: ["store-pokemon-palace", "Pokémon Palace"],
+            store: ["store-pokemon-palace", "Pokémon Palace"],
             qty: 1,
             listingType: "pre-order",
         },
@@ -255,7 +255,7 @@ export const cartsSeedData = [
     ...mkCart("user-anjali-verma", 1, [
         {
             productId: "product-pokemon-charizard-ex-obsidian",
-            title: "Pokémon Charizard ex Obsidian Flames Hyper Rare",
+            title: "Pokémon Charizard ex Obsidian Flames Hyper Rare",
             price: 1499900,
             store: ["store-cardgame-hub", "CardGame Hub"],
             qty: 1,
@@ -273,14 +273,14 @@ export const cartsSeedData = [
     ...mkCart("user-pooja-sharma", 4, [
         {
             productId: "auction-pokemon-lugia-neo-genesis-psa9",
-            title: "Pokémon Neo Genesis Lugia #9 PSA 9 (AUCTION)",
+            title: "Pokémon Neo Genesis Lugia #9 PSA 9 (AUCTION)",
             price: 6999900,
-            store: ["store-pokemon-palace", "Pokémon Palace"],
+            store: ["store-pokemon-palace", "Pokémon Palace"],
             qty: 1,
             listingType: "auction",
         },
     ]),
-    // Guest carts skipped — sessionId is a runtime-only optional field on the
+    // Guest carts skipped — sessionId is a runtime-only optional field on the
     // Zod input but not on the `CartDocument` interface used by the seed array.
     // Guest cart behavior is exercised at runtime via localStorage merge tests.
 ];