@mohasinac/appkit 4.30.18 → 4.31.0

package/dist/client.js

@@ -4,6 +4,9 @@
 // Used by useApiMutation / useApiQuery / Button surface-error to route ApiError → toast or inline field error.
 export { HTTP_ERROR_CODES, mapToHttpError } from "./errors/error-mapping";
 export { ERROR_DISPLAY_MAP, getErrorDisplay } from "./errors/error-display-map";
+// toUserMessage — the only sanctioned path from a failure to user-facing copy.
+// It terminates in a constant, so a thrown value's own .message never surfaces.
+export { toUserMessage, GENERIC_USER_MESSAGE } from "./errors/error-display-map";
 export { RazorpayUnreachableError } from "./errors/razorpay-unreachable";
 export { isOk, unwrap } from "./utils/action-result";
 // [CLIENT-SAFE] Client error class + surface-error router + reporter primitives.
@@ -22,7 +25,6 @@ export { setErrorTracker, trackError, ErrorCategory, ErrorSeverity, } from "./mo
 // on failure, optional `loadingMessage` for long ops.
 export { useApiMutation } from "./client/api/useApiMutation";
 export { useApiQuery } from "./client/api/useApiQuery";
-export { useFeatureFlags } from "./client/api/useFeatureFlags";
 // [CLIENT-ONLY] Maintenance UI — listing + detail + dashboard + analysis runner.
 // Consumed by the /admin/maintenance/* page shims.
 export { ServerErrorsListView, ServerErrorDetailView, MaintenanceDashboardView, AnalysisRunnerView, CloudLogsListView, } from "./_internal/client/features/maintenance";
@@ -155,7 +157,8 @@ export { lotteryConfigWriteSchema, lotterySlotWriteSchema } from "./features/lot
 // The SectionForm engine + its schema-derived section builder. Client-only:
 // consumer forms need these and the bare package resolves to the SERVER entry.
 export { SectionForm, useSectionFormNav } from "./features/shell/SectionForm";
-export { buildSectionsFromSchema } from "./features/shell/build-sections";
+export { buildSectionsFromSchema, visibleValues } from "./features/shell/build-sections";
+export { FORM_SECTION_GROUP, SECTION_GROUP_DEFAULTS, groupRank, resolveSectionGroup } from "./features/shell/form-sections";
 export { reportCreateSchema } from "./features/store-extensions/schemas/report-create-form";
 export { itemRequestCreateSchema } from "./features/store-extensions/schemas/item-request-create-form";
 export { supportTicketCreateSchema } from "./features/support/schemas/ticket-create-form";
@@ -249,6 +252,7 @@ export { Label, Text, Span, Caption } from "./ui/components/Typography";
 export { TextLink } from "./ui/components/TextLink";
 export { Anchor } from "./ui/components/Anchor";
 export { IconButton } from "./ui/index";
+export { ActionRow } from "./ui/components/ActionRow";
 export { Textarea } from "./ui/components/Textarea";
 export { GlobalError } from "./next/components/GlobalError";
 export { AppLayoutShell, LocaleSwitcher, useDashboardNav, BottomActionsProvider, useBottomActions, DashboardNavProvider, LayoutClient } from "./features/layout/index";
@@ -271,7 +275,7 @@ export { CouponHelpDetails } from "./features/promotions/components/CouponHelpDe
 export { NotificationBell } from "./features/account/components/NotificationBell";
 export { NotificationPreferencesPanel } from "./features/account/components/NotificationPreferencesPanel";
 export { LinkedAccountsSection } from "./features/account/components/LinkedAccountsSection";
-export { useCollapsedSections } from "./features/account/hooks/useCollapsedSections";
+export { useCollapsedSections, useSectionState, } from "./features/account/hooks/useCollapsedSections";
 export { PageViewTracker } from "./features/analytics/components/PageViewTracker";
 export { PAGE_VIEW_ENTITY_TYPES } from "./features/analytics/types";
 export { AuctionBidsTable } from "./features/auctions/components/AuctionBidsTable";
@@ -320,13 +324,6 @@ export { COMPARE_MAX_ITEMS } from "./features/products/constants/action-defs";
 export { STANDARD_SORT_OPTIONS, STANDARD_PUBLIC_SORT_OPTIONS, AUCTION_SORT_OPTIONS, AUCTION_PUBLIC_SORT_OPTIONS, PREORDER_SORT_OPTIONS, PREORDER_PUBLIC_SORT_OPTIONS, BUNDLE_SORT_OPTIONS, PRIZE_DRAW_SORT_OPTIONS, PRIZE_DRAW_PUBLIC_SORT_OPTIONS, } from "./features/products/constants/sieve";
 // Derived from the listing-type plugin registry — see the note in index.ts.
 export { sortOptionsFor, commonSortOptionsFor, hideDefaultsFor, } from "./_internal/shared/listing-types/_registry";
-// Messages — RTDB-pinged Firestore conversations (D5 + VC7)
-export { MessagesView } from "./features/account/components/MessagesView";
-export { ChatList } from "./features/account/components/ChatList";
-export { ChatWindow } from "./features/account/components/ChatWindow";
-export { useConversations, useConversation } from "./features/messages/index";
-export { CONVERSATIONS_COLLECTION, CONVERSATIONS_INDEXED_FIELDS, } from "./features/messages/index";
-export { CONVERSATIONS_PING_PATH, CONVERSATIONS_PING_USER_PATH, } from "./features/messages/hooks/useConversation";
 // Product / listing actions
 export { ACTION_ID, ACTION_META, DETAIL_ACTIONS, MOBILE_PRIMARY_ACTIONS, LISTING_BULK_ACTIONS } from "./features/products/index";
 // Row / table actions (admin, seller, user dashboards)
@@ -351,7 +348,9 @@ export { ProductFeaturesProvider, useProductFeatures, } from "./features/product
 export { FeatureBadge, FeatureBadgeList } from "./features/products/components/FeatureBadge";
 export { UserOffersPanel } from "./features/account/components/UserOffersPanel";
 export { SellerDashboardView as StoreDashboardView, SellerDashboardView, useSellerDashboard as useStoreDashboard, useSellerDashboard } from "./features/seller/index";
-export { SellerPayoutSettingsView, SellerShippingView, SellerReviewsView, SellerPayoutRequestView, SellerAnalyticsStats, SellerTopProducts, SellerAnalyticsView, SellerPayoutsView, SellerCouponEditorView, SellerBidsView, SellerAddressesView, SellerPreOrdersView, SellerPrizeDrawsView, PrintCenterView, SellerOffersView, SellerGroupedListingsView, StoreGroupedListingsView, SellerAnalyticsAlertsView, StoreAnalyticsAlertsView, BarcodeField, FulfillmentView } from "./features/seller/components/index";
+export { SellerPayoutSettingsView, SellerShippingView, SellerReviewsView, SellerPayoutRequestView, SellerAnalyticsStats, SellerTopProducts, SellerAnalyticsView, SellerPayoutsView, SellerCouponEditorView, SellerBidsView, SellerAddressesView, PrintCenterView, SellerOffersView, SellerGroupedListingsView, StoreGroupedListingsView, SellerAnalyticsAlertsView, StoreAnalyticsAlertsView, BarcodeField, FulfillmentView, SellerListingTypeView, SELLER_LISTING_TYPE_SPECS } from "./features/seller/components/index";
+/* The draft → route conversion, so both coupon callsites share one rule. */
+export { couponDraftToPayload } from "./features/seller/schemas/coupon-form";
 export { UserAccountHubView, UserOrdersView, UserBidsView, OrderDetailView, UserNotificationsView, UserReturnsView, UserSupportView, useNotifications } from "./features/account/index";
 export { useOrders, useOrder, OrdersList } from "./features/orders/index";
 export { OrderStatusTimeline } from "./features/orders/components/OrderStatusTimeline";
@@ -390,7 +389,7 @@ export { cartRequiresShipping, cartIsDigitalOnly, cartIsChatOnly, } from "./_int
 export { ACTIONS, action, act, canPerformAction, actionsForListingType, actionLabel, } from "./_internal/shared/actions/action-registry";
 export { buildBulkAction } from "./_internal/shared/actions/bulk-helpers";
 // SB-UNI-E user-role predicates (pure functions, client-safe).
-export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, isEffectiveAdminUser, } from "./features/auth/role-predicates";
+export { isAdminUser, isSellerUser, isModeratorUser, isEmployeeUser, isBuyerUser, isEffectiveAdminUser, isTesterUser, canTestAdminSurfaces, isStrictSellerUser, isAccountDisabled, } from "./features/auth/role-predicates";
 // Layout feature — client islands (unifies admin/store/user dashboard layouts).
 export { DashboardLayoutClient, RoleGuard } from "./_internal/client/features/layout/index";
 // Listing-type capability registry — SB-UNI X1.
@@ -457,7 +456,7 @@ export { API_ENDPOINTS } from "./constants/index";
 // sets and Firestore field-name maps. No server dependency of any kind.
 export { SELLER_LISTING_TABS, } from "./features/products/constants/listing-tabs";
 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";
-export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS, STORE_FIELDS, CATEGORY_FIELDS, BLOG_FIELDS, USER_FIELDS, ADDRESS_FIELDS, BRAND_FIELDS, CART_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, NOTIFICATION_FIELDS, SESSION_FIELDS, COUPON_USAGE_FIELDS, CONVERSATION_FIELDS, SCAMMER_FIELDS, SUPPORT_TICKET_FIELDS, CAROUSEL_FIELDS, COUPON_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
+export { PRODUCT_FIELDS, PRODUCT_STATUS_TRANSITIONS, ORDER_FIELDS, REVIEW_FIELDS, BID_FIELDS, AD_FIELDS, EVENT_FIELDS, EVENT_ENTRY_FIELDS, PAYOUT_FIELDS, STORE_FIELDS, CATEGORY_FIELDS, BLOG_FIELDS, USER_FIELDS, ADDRESS_FIELDS, BRAND_FIELDS, CART_FIELDS, WISHLIST_FIELDS, HISTORY_FIELDS, NOTIFICATION_FIELDS, SESSION_FIELDS, COUPON_USAGE_FIELDS, SCAMMER_FIELDS, SUPPORT_TICKET_FIELDS, CAROUSEL_FIELDS, COUPON_FIELDS, FAQ_FIELDS, HOMEPAGE_SECTION_FIELDS, SITE_SETTINGS_FIELDS, COMMON_FIELDS, OAUTH_STATE_VALUES, SCHEMA_DEFAULTS, } from "./constants/field-names";
 // Checkout lanes — the derived auction > offer > standard partition of the
 // cart, and the priority rule that decides which one may be checked out.
 export { CART_LANE, CART_LANE_PRIORITY, CART_LANE_LABELS, laneOf, activeLane, laneItems, laneCounts, isLaneCheckoutable, laneBlockReason, isLockedLane, canAddNewItems, } from "./_internal/shared/checkout/lanes";
@@ -466,8 +465,34 @@ export { raffleEntrySchema } from "./features/contact/schemas/inquiry-forms";
 export { orderCancelSchema, paymentProofSchema, } from "./features/orders/schemas/buyer-forms";
 export { scamReportFormSchema } from "./features/scams/schemas/report-form";
 export { sublistingCategoryFormSchema } from "./features/store-extensions/schemas/sublisting-category-form";
-export { adminAddressFormSchema, adminStoreUpdateSchema, announcementBarSchema, } from "./features/admin/schemas/admin-editor-forms";
+export { adminStoreUpdateSchema, announcementBarSchema, } from "./features/admin/schemas/admin-editor-forms";
 export { adminOrderUpdateSchema, employeeInviteSchema, hardBanReasonSchema, featureFlagsUpdateSchema, adminAdFormSchema, } from "./features/admin/schemas/admin-ops-forms";
 export { changeEmailSchema } from "./features/account/schemas/index";
 export { adminUserUpdateSchema, whatsappSettingsSchema, lotteryPullSchema, } from "./features/admin/schemas/admin-user-form";
 export { siteSettingsFormSchema } from "./features/admin/schemas/site-settings-form";
+// The ONE address shape and the ONE postal rule (W5 / D19). Eleven field
+// shapes and fifteen disagreeing postal rules collapsed to these.
+export { refineAddressPostal, addressFormSchema, addressUpdateSchema, adminAddressCreateSchema, adminAddressUpdateSchema, addressUnbanRequestSchema, } from "./features/addresses/schemas/address-form";
+export { COUNTRIES, COUNTRY_CODES, DEFAULT_COUNTRY, countryFor, postalPatternFor, postalLabelFor, isValidPostalCode, } from "./constants/geo/countries";
+export { SUBDIVISIONS, subdivisionsFor } from "./constants/geo/subdivisions";
+// Nav item ids are DERIVED from the href (W6). A hand-written id drifts from
+// the route it names, and because it is also the `navConfig` key, a drifted id
+// silently un-toggles the item.
+export { navItemId } from "./_internal/shared/features/layout/types";
+/*
+ * The action index (W7), on the CLIENT entry too.
+ *
+ * `LayoutShellClient` is a client component, so it must not reach the bare
+ * `@mohasinac/appkit` entry — that is the Turbopack client-bundle leak
+ * (Root Cause #6), and its audit caught exactly that in the commit that wired
+ * this up. The main entry keeps its own copy for Server Components, which have
+ * the opposite constraint (Root Cause #76).
+ */
+export { mergeActionIndex, projectActionIndexForViewer, } from "./features/search/action-index/types";
+export { deriveNavEntries, deriveQuickActionEntries, buildActionIndexBase, } from "./features/search/action-index/derive";
+export { matchesNavQuery } from "./_internal/shared/features/layout/matchesNavQuery";
+export { SITE_SETTINGS_ENTRIES, deriveSettingsEntries, } from "./features/search/action-index/settings-entries";
+export { SITE_SETTINGS_TABS, SITE_SETTINGS_TAB_IDS, isSiteSettingsTabId, } from "./features/admin/constants/site-settings-tabs";
+export { validateActionIndexEntry, normaliseRoute, } from "./features/search/action-index/validate-entry";
+export { AdminActionIndexView } from "./features/admin/components/AdminActionIndexView";
+export { SellerSupportView } from "./features/seller/components/SellerSupportView";

package/dist/configs/next.js

@@ -65,7 +65,16 @@ const FIREBASE_EXTERNAL_PACKAGES = [
  * ```
  */
 export function defineNextConfig(override = {}) {
-    const { serverExternalPackages: consumerExternal = [], experimental: consumerExperimental = {}, webpack: consumerWebpack, outputFileTracingIncludes: consumerOutputFileTracingIncludes = {}, turbopack: consumerTurbopack = {}, ...rest } = override;
+    const { serverExternalPackages: consumerExternal = [], experimental: consumerExperimental = {}, webpack: consumerWebpack, outputFileTracingIncludes: consumerOutputFileTracingIncludes = {}, turbopack: consumerTurbopack = {}, 
+    /*
+     * Destructured out even though it is merged below, because `...rest` is
+     * spread AFTER `images: mergedImages`. Left in `rest`, a consumer setting
+     * `images: { domains: [...] }` would silently overwrite the merged
+     * `unoptimized: true` — and with optimisation back on and no
+     * `remotePatterns` declared anywhere in this repo, every external image
+     * would 400. Every other key in this list is here for the same reason.
+     */
+    images: consumerImages = {}, ...rest } = override;
     const mergedExternal = [
         ...FIREBASE_EXTERNAL_PACKAGES,
         ...consumerExternal.filter((p) => !FIREBASE_EXTERNAL_PACKAGES.includes(p)),
@@ -273,7 +282,6 @@ export function defineNextConfig(override = {}) {
     // hosts (ygoprodeck, unsplash, picsum); prod images move to Firebase
     // Storage via /api/media. Consumer can still pass an explicit
     // `images.unoptimized: false` + remotePatterns to opt back in.
-    const consumerImages = override.images ?? {};
     const mergedImages = {
         unoptimized: true,
         ...consumerImages,

package/dist/constants/api-endpoints.d.ts

@@ -6,9 +6,7 @@
  *
  * Never hard-code `/api/...` strings in hook files — import from here.
  */
-export declare const CONFIG_ENDPOINTS: {
-    readonly FEATURE_FLAGS: "/api/config/feature-flags";
-};
+export declare const CONFIG_ENDPOINTS: {};
 export declare const LOGS_ENDPOINTS: {
     readonly WRITE: "/api/logs/write";
 };
@@ -68,12 +66,6 @@ export declare const ACCOUNT_ENDPOINTS: {
     readonly TESTER_CHECKLIST: "/api/user/tester-checklist";
     readonly TESTER_CHECKLIST_ITEM_BY_ID: (checklistItemId: string) => string;
 };
-export declare const CONVERSATION_ENDPOINTS: {
-    readonly LIST: "/api/user/conversations";
-    readonly BY_ID: (id: string) => string;
-    readonly MESSAGES: (id: string) => string;
-    readonly READ: (id: string) => string;
-};
 export declare const NOTIFICATIONS_ENDPOINTS: {
     readonly LIST: "/api/notifications";
     readonly READ_ALL: "/api/notifications/read-all";
@@ -88,8 +80,9 @@ export declare const ADMIN_ENDPOINTS: {
     readonly ANALYTICS: "/api/admin/analytics";
     readonly ANALYTICS_PAGE_VIEWS: "/api/admin/analytics/pageviews";
     readonly ADS: "/api/admin/ads";
+    /** The action-index control plane (W7 / D7) — GET the whole index, PATCH one override. */
+    readonly ACTION_INDEX: "/api/admin/action-index";
     readonly AD_BY_ID: (id: string) => string;
-    readonly REALTIME_TOKEN: "/api/realtime/token";
     readonly PAYMENTS_SETTINGS: "/api/admin/payments/settings";
     readonly PRODUCTS: "/api/admin/products";
     readonly PRODUCT_BY_ID: (id: string) => string;
@@ -182,7 +175,6 @@ export declare const ADMIN_ENDPOINTS: {
     readonly ADMIN_WISHLISTS: "/api/admin/wishlists";
     readonly ADMIN_HISTORY: "/api/admin/history";
     readonly NEWSLETTER_EXPORT: "/api/admin/newsletter/export";
-    readonly FEATURE_FLAGS: "/api/admin/feature-flags";
     readonly STORE_ADDRESSES: "/api/admin/store-addresses";
     readonly CAROUSEL: "/api/admin/carousel";
     readonly CAROUSEL_BY_ID: (id: string) => string;
@@ -220,11 +212,6 @@ export declare const ADMIN_ENDPOINTS: {
     readonly MAINTENANCE_CLOUD_LOGS: "/api/admin/maintenance/cloud-logs";
     readonly MEDIA_LIST: "/api/admin/media";
 };
-export declare const CHAT_ENDPOINTS: {
-    readonly LIST: "/api/chat";
-    readonly BY_ID: (chatId: string) => string;
-    readonly MESSAGES: (chatId: string) => string;
-};
 export declare const AUCTION_ENDPOINTS: {
     readonly LIST: "/api/auctions";
     readonly BY_SLUG: (slug: string) => string;
@@ -416,8 +403,9 @@ export declare const SELLER_ENDPOINTS: {
     readonly PRODUCTS_SCAN: (barcode: string) => string;
     readonly ORDERS_FULFILLMENT: "/api/store/fulfillment";
     readonly BUNDLES: "/api/store/bundles";
+    /** Tickets raised ABOUT this store (W11). */
+    readonly SUPPORT: "/api/store/support";
     readonly BUNDLE_BY_ID: (id: string) => string;
-    readonly CONVERSATIONS: "/api/store/conversations";
     readonly ORDERS_ASSIGN: (orderId: string) => string;
     readonly PRODUCT_BY_ID: (id: string) => string;
     readonly PRODUCT_DUPLICATE: (id: string) => string;
@@ -431,7 +419,7 @@ export declare const BRAND_ENDPOINTS: {
 export declare const BLOG_ENDPOINTS: {
     readonly LIST: "/api/blog";
     readonly BY_SLUG: (slug: string) => string;
-    readonly FEATURED: (perPage?: number) => string;
+    readonly FEATURED: (pageSize?: number) => string;
     readonly SORTED: (sort: string) => string;
 };
 export declare const STORE_ENDPOINTS: {
@@ -475,9 +463,7 @@ export declare const WHATSAPP_SELLER_ENDPOINTS: {
     readonly CATALOG_IMPORT: "/api/store/whatsapp-settings/catalog-import";
 };
 export declare const API_ENDPOINTS: {
-    readonly CONFIG: {
-        readonly FEATURE_FLAGS: "/api/config/feature-flags";
-    };
+    readonly CONFIG: {};
     readonly LOGS: {
         readonly WRITE: "/api/logs/write";
     };
@@ -537,12 +523,6 @@ export declare const API_ENDPOINTS: {
         readonly TESTER_CHECKLIST: "/api/user/tester-checklist";
         readonly TESTER_CHECKLIST_ITEM_BY_ID: (checklistItemId: string) => string;
     };
-    readonly CONVERSATIONS: {
-        readonly LIST: "/api/user/conversations";
-        readonly BY_ID: (id: string) => string;
-        readonly MESSAGES: (id: string) => string;
-        readonly READ: (id: string) => string;
-    };
     readonly NOTIFICATIONS: {
         readonly LIST: "/api/notifications";
         readonly READ_ALL: "/api/notifications/read-all";
@@ -557,8 +537,9 @@ export declare const API_ENDPOINTS: {
         readonly ANALYTICS: "/api/admin/analytics";
         readonly ANALYTICS_PAGE_VIEWS: "/api/admin/analytics/pageviews";
         readonly ADS: "/api/admin/ads";
+        /** The action-index control plane (W7 / D7) — GET the whole index, PATCH one override. */
+        readonly ACTION_INDEX: "/api/admin/action-index";
         readonly AD_BY_ID: (id: string) => string;
-        readonly REALTIME_TOKEN: "/api/realtime/token";
         readonly PAYMENTS_SETTINGS: "/api/admin/payments/settings";
         readonly PRODUCTS: "/api/admin/products";
         readonly PRODUCT_BY_ID: (id: string) => string;
@@ -651,7 +632,6 @@ export declare const API_ENDPOINTS: {
         readonly ADMIN_WISHLISTS: "/api/admin/wishlists";
         readonly ADMIN_HISTORY: "/api/admin/history";
         readonly NEWSLETTER_EXPORT: "/api/admin/newsletter/export";
-        readonly FEATURE_FLAGS: "/api/admin/feature-flags";
         readonly STORE_ADDRESSES: "/api/admin/store-addresses";
         readonly CAROUSEL: "/api/admin/carousel";
         readonly CAROUSEL_BY_ID: (id: string) => string;
@@ -689,11 +669,6 @@ export declare const API_ENDPOINTS: {
         readonly MAINTENANCE_CLOUD_LOGS: "/api/admin/maintenance/cloud-logs";
         readonly MEDIA_LIST: "/api/admin/media";
     };
-    readonly CHAT: {
-        readonly LIST: "/api/chat";
-        readonly BY_ID: (chatId: string) => string;
-        readonly MESSAGES: (chatId: string) => string;
-    };
     readonly AUCTIONS: {
         readonly LIST: "/api/auctions";
         readonly BY_SLUG: (slug: string) => string;
@@ -885,8 +860,9 @@ export declare const API_ENDPOINTS: {
         readonly PRODUCTS_SCAN: (barcode: string) => string;
         readonly ORDERS_FULFILLMENT: "/api/store/fulfillment";
         readonly BUNDLES: "/api/store/bundles";
+        /** Tickets raised ABOUT this store (W11). */
+        readonly SUPPORT: "/api/store/support";
         readonly BUNDLE_BY_ID: (id: string) => string;
-        readonly CONVERSATIONS: "/api/store/conversations";
         readonly ORDERS_ASSIGN: (orderId: string) => string;
         readonly PRODUCT_BY_ID: (id: string) => string;
         readonly PRODUCT_DUPLICATE: (id: string) => string;
@@ -900,7 +876,7 @@ export declare const API_ENDPOINTS: {
     readonly BLOG: {
         readonly LIST: "/api/blog";
         readonly BY_SLUG: (slug: string) => string;
-        readonly FEATURED: (perPage?: number) => string;
+        readonly FEATURED: (pageSize?: number) => string;
         readonly SORTED: (sort: string) => string;
     };
     readonly STORES: {
@@ -946,9 +922,7 @@ export declare const API_ENDPOINTS: {
 };
 /** Canonical alias — prefer API_ROUTES over API_ENDPOINTS in new code. */
 export declare const API_ROUTES: {
-    readonly CONFIG: {
-        readonly FEATURE_FLAGS: "/api/config/feature-flags";
-    };
+    readonly CONFIG: {};
     readonly LOGS: {
         readonly WRITE: "/api/logs/write";
     };
@@ -1008,12 +982,6 @@ export declare const API_ROUTES: {
         readonly TESTER_CHECKLIST: "/api/user/tester-checklist";
         readonly TESTER_CHECKLIST_ITEM_BY_ID: (checklistItemId: string) => string;
     };
-    readonly CONVERSATIONS: {
-        readonly LIST: "/api/user/conversations";
-        readonly BY_ID: (id: string) => string;
-        readonly MESSAGES: (id: string) => string;
-        readonly READ: (id: string) => string;
-    };
     readonly NOTIFICATIONS: {
         readonly LIST: "/api/notifications";
         readonly READ_ALL: "/api/notifications/read-all";
@@ -1028,8 +996,9 @@ export declare const API_ROUTES: {
         readonly ANALYTICS: "/api/admin/analytics";
         readonly ANALYTICS_PAGE_VIEWS: "/api/admin/analytics/pageviews";
         readonly ADS: "/api/admin/ads";
+        /** The action-index control plane (W7 / D7) — GET the whole index, PATCH one override. */
+        readonly ACTION_INDEX: "/api/admin/action-index";
         readonly AD_BY_ID: (id: string) => string;
-        readonly REALTIME_TOKEN: "/api/realtime/token";
         readonly PAYMENTS_SETTINGS: "/api/admin/payments/settings";
         readonly PRODUCTS: "/api/admin/products";
         readonly PRODUCT_BY_ID: (id: string) => string;
@@ -1122,7 +1091,6 @@ export declare const API_ROUTES: {
         readonly ADMIN_WISHLISTS: "/api/admin/wishlists";
         readonly ADMIN_HISTORY: "/api/admin/history";
         readonly NEWSLETTER_EXPORT: "/api/admin/newsletter/export";
-        readonly FEATURE_FLAGS: "/api/admin/feature-flags";
         readonly STORE_ADDRESSES: "/api/admin/store-addresses";
         readonly CAROUSEL: "/api/admin/carousel";
         readonly CAROUSEL_BY_ID: (id: string) => string;
@@ -1160,11 +1128,6 @@ export declare const API_ROUTES: {
         readonly MAINTENANCE_CLOUD_LOGS: "/api/admin/maintenance/cloud-logs";
         readonly MEDIA_LIST: "/api/admin/media";
     };
-    readonly CHAT: {
-        readonly LIST: "/api/chat";
-        readonly BY_ID: (chatId: string) => string;
-        readonly MESSAGES: (chatId: string) => string;
-    };
     readonly AUCTIONS: {
         readonly LIST: "/api/auctions";
         readonly BY_SLUG: (slug: string) => string;
@@ -1356,8 +1319,9 @@ export declare const API_ROUTES: {
         readonly PRODUCTS_SCAN: (barcode: string) => string;
         readonly ORDERS_FULFILLMENT: "/api/store/fulfillment";
         readonly BUNDLES: "/api/store/bundles";
+        /** Tickets raised ABOUT this store (W11). */
+        readonly SUPPORT: "/api/store/support";
         readonly BUNDLE_BY_ID: (id: string) => string;
-        readonly CONVERSATIONS: "/api/store/conversations";
         readonly ORDERS_ASSIGN: (orderId: string) => string;
         readonly PRODUCT_BY_ID: (id: string) => string;
         readonly PRODUCT_DUPLICATE: (id: string) => string;
@@ -1371,7 +1335,7 @@ export declare const API_ROUTES: {
     readonly BLOG: {
         readonly LIST: "/api/blog";
         readonly BY_SLUG: (slug: string) => string;
-        readonly FEATURED: (perPage?: number) => string;
+        readonly FEATURED: (pageSize?: number) => string;
         readonly SORTED: (sort: string) => string;
     };
     readonly STORES: {

package/dist/constants/api-endpoints.js

@@ -9,9 +9,7 @@
 // ---------------------------------------------------------------------------
 // Config
 // ---------------------------------------------------------------------------
-export const CONFIG_ENDPOINTS = {
-    FEATURE_FLAGS: "/api/config/feature-flags",
-};
+export const CONFIG_ENDPOINTS = {};
 // ---------------------------------------------------------------------------
 // Logs
 // ---------------------------------------------------------------------------
@@ -91,15 +89,6 @@ export const ACCOUNT_ENDPOINTS = {
     TESTER_CHECKLIST_ITEM_BY_ID: (checklistItemId) => `/api/user/tester-checklist/${encodeURIComponent(checklistItemId)}`,
 };
 // ---------------------------------------------------------------------------
-// Conversations (buyer messaging)
-// ---------------------------------------------------------------------------
-export const CONVERSATION_ENDPOINTS = {
-    LIST: "/api/user/conversations",
-    BY_ID: (id) => `/api/user/conversations/${encodeURIComponent(id)}`,
-    MESSAGES: (id) => `/api/user/conversations/${encodeURIComponent(id)}/messages`,
-    READ: (id) => `/api/user/conversations/${encodeURIComponent(id)}/read`,
-};
-// ---------------------------------------------------------------------------
 // Notifications
 // ---------------------------------------------------------------------------
 export const NOTIFICATIONS_ENDPOINTS = {
@@ -122,8 +111,9 @@ export const ADMIN_ENDPOINTS = {
     ANALYTICS: "/api/admin/analytics",
     ANALYTICS_PAGE_VIEWS: "/api/admin/analytics/pageviews",
     ADS: "/api/admin/ads",
+    /** The action-index control plane (W7 / D7) — GET the whole index, PATCH one override. */
+    ACTION_INDEX: "/api/admin/action-index",
     AD_BY_ID: (id) => `/api/admin/ads/${id}`,
-    REALTIME_TOKEN: "/api/realtime/token",
     PAYMENTS_SETTINGS: "/api/admin/payments/settings",
     PRODUCTS: "/api/admin/products",
     PRODUCT_BY_ID: (id) => `/api/admin/products/${id}`,
@@ -217,7 +207,6 @@ export const ADMIN_ENDPOINTS = {
     ADMIN_WISHLISTS: "/api/admin/wishlists",
     ADMIN_HISTORY: "/api/admin/history",
     NEWSLETTER_EXPORT: "/api/admin/newsletter/export",
-    FEATURE_FLAGS: "/api/admin/feature-flags",
     STORE_ADDRESSES: "/api/admin/store-addresses",
     CAROUSEL: "/api/admin/carousel",
     CAROUSEL_BY_ID: (id) => `/api/admin/carousel/${id}`,
@@ -256,14 +245,6 @@ export const ADMIN_ENDPOINTS = {
     MEDIA_LIST: "/api/admin/media",
 };
 // ---------------------------------------------------------------------------
-// Chat
-// ---------------------------------------------------------------------------
-export const CHAT_ENDPOINTS = {
-    LIST: "/api/chat",
-    BY_ID: (chatId) => `/api/chat/${chatId}`,
-    MESSAGES: (chatId) => `/api/chat/${chatId}/messages`,
-};
-// ---------------------------------------------------------------------------
 // Auctions
 // ---------------------------------------------------------------------------
 export const AUCTION_ENDPOINTS = {
@@ -543,8 +524,9 @@ export const SELLER_ENDPOINTS = {
     PRODUCTS_SCAN: (barcode) => `/api/store/products/scan?barcode=${encodeURIComponent(barcode)}`,
     ORDERS_FULFILLMENT: "/api/store/fulfillment",
     BUNDLES: "/api/store/bundles",
+    /** Tickets raised ABOUT this store (W11). */
+    SUPPORT: "/api/store/support",
     BUNDLE_BY_ID: (id) => `/api/store/bundles/${id}`,
-    CONVERSATIONS: "/api/store/conversations",
     ORDERS_ASSIGN: (orderId) => `/api/store/orders/${orderId}/assign`,
     PRODUCT_BY_ID: (id) => `/api/store/products/${id}`,
     PRODUCT_DUPLICATE: (id) => `/api/store/products/${id}/duplicate`,
@@ -564,7 +546,7 @@ export const BRAND_ENDPOINTS = {
 export const BLOG_ENDPOINTS = {
     LIST: "/api/blog",
     BY_SLUG: (slug) => `/api/blog/${slug}`,
-    FEATURED: (perPage) => `/api/blog?featured=true${perPage !== undefined ? `&perPage=${perPage}` : ""}`,
+    FEATURED: (pageSize) => `/api/blog?featured=true${pageSize !== undefined ? `&pageSize=${pageSize}` : ""}`,
     SORTED: (sort) => `/api/blog?sort=${sort}`,
 };
 // ---------------------------------------------------------------------------
@@ -643,11 +625,9 @@ export const API_ENDPOINTS = {
     CLIENT_ERRORS: CLIENT_ERROR_ENDPOINTS,
     AUTH: AUTH_ENDPOINTS,
     ACCOUNT: ACCOUNT_ENDPOINTS,
-    CONVERSATIONS: CONVERSATION_ENDPOINTS,
     NOTIFICATIONS: NOTIFICATIONS_ENDPOINTS,
     SITE_SETTINGS: SITE_SETTINGS_ENDPOINTS,
     ADMIN: ADMIN_ENDPOINTS,
-    CHAT: CHAT_ENDPOINTS,
     AUCTIONS: AUCTION_ENDPOINTS,
     BIDS: BID_ENDPOINTS,
     CART: CART_ENDPOINTS,

package/dist/constants/field-names.d.ts

@@ -685,15 +685,6 @@ export declare const COUPON_USAGE_FIELDS: {
     readonly LAST_USED_AT: "lastUsedAt";
     readonly ORDERS: "orders";
 };
-export declare const CONVERSATION_FIELDS: {
-    readonly ID: "id";
-    readonly BUYER_ID: "buyerId";
-    readonly STORE_ID: "storeId";
-    readonly LAST_MESSAGE_AT: "lastMessageAt";
-    readonly LAST_MESSAGE: "lastMessage";
-    readonly CREATED_AT: "createdAt";
-    readonly UPDATED_AT: "updatedAt";
-};
 export declare const SCAMMER_FIELDS: {
     readonly ID: "id";
     readonly SCAM_TYPE: "scamType";
@@ -713,6 +704,8 @@ export declare const SUPPORT_TICKET_FIELDS: {
     readonly ID: "id";
     readonly USER_ID: "userId";
     readonly STORE_ID: "storeId";
+    /** Word-prefix tokens over `subject` only — see the repository's hook. */
+    readonly SEARCH_TXT: "searchTxt";
     readonly SUBJECT: "subject";
     readonly CATEGORY: "category";
     readonly STATUS: "status";
@@ -905,21 +898,10 @@ export declare const SITE_SETTINGS_FIELDS: {
     readonly EMAIL_SETTINGS: "emailSettings";
     readonly SEO: "seo";
     readonly FEATURES: "features";
-    readonly FEATURE_FLAGS: "featureFlags";
-    readonly FEATURE_FLAGS_FIELDS: {
-        readonly CHATS: "featureFlags.chats";
-        readonly SMS_VERIFICATION: "featureFlags.smsVerification";
-        readonly TRANSLATIONS: "featureFlags.translations";
-        readonly WISHLISTS: "featureFlags.wishlists";
-        readonly AUCTIONS: "featureFlags.auctions";
-        readonly REVIEWS: "featureFlags.reviews";
-        readonly EVENTS: "featureFlags.events";
-        readonly BLOG: "featureFlags.blog";
-        readonly COUPONS: "featureFlags.coupons";
-        readonly NOTIFICATIONS: "featureFlags.notifications";
-        readonly SELLER_REGISTRATION: "featureFlags.sellerRegistration";
-        readonly PRE_ORDERS: "featureFlags.preOrders";
-        readonly OFFERS: "featureFlags.offers";
+    readonly LISTINGS: "listings";
+    readonly LISTINGS_FIELDS: {
+        readonly LISTING_TYPES: "listings.listingTypes";
+        readonly CATEGORY_TYPES: "listings.categoryTypes";
     };
     readonly LEGAL_PAGES: "legalPages";
     readonly SHIPPING: "shipping";

package/dist/constants/field-names.js

@@ -794,18 +794,6 @@ export const COUPON_USAGE_FIELDS = {
     ORDERS: "orders",
 };
 // ============================================================================
-// CONVERSATION FIELDS
-// ============================================================================
-export const CONVERSATION_FIELDS = {
-    ID: "id",
-    BUYER_ID: "buyerId",
-    STORE_ID: "storeId",
-    LAST_MESSAGE_AT: "lastMessageAt",
-    LAST_MESSAGE: "lastMessage",
-    CREATED_AT: "createdAt",
-    UPDATED_AT: "updatedAt",
-};
-// ============================================================================
 // SCAMMER FIELDS
 // ============================================================================
 export const SCAMMER_FIELDS = {
@@ -836,6 +824,8 @@ export const SUPPORT_TICKET_FIELDS = {
     ID: "id",
     USER_ID: "userId",
     STORE_ID: "storeId",
+    /** Word-prefix tokens over `subject` only — see the repository's hook. */
+    SEARCH_TXT: "searchTxt",
     SUBJECT: "subject",
     CATEGORY: "category",
     STATUS: "status",
@@ -1048,21 +1038,14 @@ export const SITE_SETTINGS_FIELDS = {
     EMAIL_SETTINGS: "emailSettings",
     SEO: "seo",
     FEATURES: "features",
-    FEATURE_FLAGS: "featureFlags",
-    FEATURE_FLAGS_FIELDS: {
-        CHATS: "featureFlags.chats",
-        SMS_VERIFICATION: "featureFlags.smsVerification",
-        TRANSLATIONS: "featureFlags.translations",
-        WISHLISTS: "featureFlags.wishlists",
-        AUCTIONS: "featureFlags.auctions",
-        REVIEWS: "featureFlags.reviews",
-        EVENTS: "featureFlags.events",
-        BLOG: "featureFlags.blog",
-        COUPONS: "featureFlags.coupons",
-        NOTIFICATIONS: "featureFlags.notifications",
-        SELLER_REGISTRATION: "featureFlags.sellerRegistration",
-        PRE_ORDERS: "featureFlags.preOrders",
-        OFFERS: "featureFlags.offers",
+    // FEATURE_FLAGS / FEATURE_FLAGS_FIELDS were deleted 2026-08-29 along with the
+    // group itself — 11 of its 14 keys had no reader anywhere. The survivors that
+    // were never flags live under LISTINGS below; the two with real behaviour
+    // moved to `payment.smsVerification` and `payment.adminCheckoutBypass`.
+    LISTINGS: "listings",
+    LISTINGS_FIELDS: {
+        LISTING_TYPES: "listings.listingTypes",
+        CATEGORY_TYPES: "listings.categoryTypes",
     },
     LEGAL_PAGES: "legalPages",
     SHIPPING: "shipping",

package/dist/constants/geo/countries.d.ts

@@ -0,0 +1,50 @@
+/** One country, as an address form needs it. */
+export interface CountryDef {
+    /** ISO-3166-1 alpha-2. Also the key. */
+    code: string;
+    name: string;
+    /**
+     * What a valid postal code looks like here, or `null` when we do not know.
+     *
+     * `null` is a real answer, not a gap to be filled with a guess: the
+     * fallback accepts 3–12 characters, which catches an empty box and a pasted
+     * paragraph and nothing in between.
+     */
+    postalPattern: RegExp | null;
+    /** What the country calls it — "PIN code", "ZIP code", "Postcode". */
+    postalLabel: string;
+    /** Whether `SUBDIVISIONS` enumerates its states/provinces. */
+    hasStates: boolean;
+    /** E.164 calling code, without the `+`. */
+    dialCode: string;
+}
+/** The permissive bound applied when a country has no pattern. */
+export declare const POSTAL_MIN = 3;
+export declare const POSTAL_MAX = 12;
+export declare const COUNTRIES: Record<string, CountryDef>;
+export declare const COUNTRY_CODES: string[];
+export type CountryCode = string;
+/** Where this marketplace is, and what an address defaults to. */
+export declare const DEFAULT_COUNTRY = "IN";
+/**
+ * Resolve a country by code or by name.
+ *
+ * By NAME as well, because `AddressDocument.country` is a free-text string
+ * today and holds `"India"` on every seeded and user-entered row. A resolver
+ * that only understood codes would treat every existing address as an unknown
+ * country and silently drop to the permissive rule — the migration would look
+ * like it worked and would have switched validation off.
+ */
+export declare function countryFor(value: string | undefined | null): CountryDef | null;
+/** The postal pattern for a country, or `null` when none is known. */
+export declare function postalPatternFor(country: string | undefined | null): RegExp | null;
+/** "PIN code" / "ZIP code" / "Postcode" — what to put on the label. */
+export declare function postalLabelFor(country: string | undefined | null): string;
+/**
+ * The ONE postal check, used by every form and every route.
+ *
+ * An empty code is NOT valid — required-ness is the caller's business, but a
+ * blank string is never a postal code, and letting it through here is how the
+ * `.min(1)` client rule came to disagree with the server in the first place.
+ */
+export declare function isValidPostalCode(country: string | undefined | null, postalCode: string | undefined | null): boolean;