@mohasinac/appkit 4.30.19 → 4.31.1

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;

package/dist/constants/geo/countries.js

@@ -0,0 +1,129 @@
+/*
+ * WHY: A postal code was validated by **fifteen** different rules, and they
+ *      disagreed. Two of them are server-side rules on the SAME entity:
+ *      `src/actions/address.actions.ts` said `.min(4).max(10)` while
+ *      `src/validation/request-schemas.ts` said `/^\d{6}$/`. Another accepted
+ *      5-or-6 digits. And `src/app/api/admin/addresses/route.ts` used
+ *      `.min(6).max(6)` — a LENGTH check with no character class, so
+ *      `"abcdef"` was a valid Indian PIN code as far as it was concerned.
+ *
+ *      Meanwhile the client form said `z.string().min(1)`, so `abc` passed
+ *      every check the user could see and came back as a server 400 with
+ *      nothing on the field.
+ *
+ *      The India-only regex was itself a bug in waiting: `country` is a free
+ *      text field, so a Canadian address was being held to `/^\d{6}$/`.
+ *
+ * WHAT: One postal rule per country, and the country list that carries it.
+ *
+ * ## Why this is curated rather than all 250 ISO countries
+ *
+ * A pattern is only worth having if it is RIGHT. Hand-typing 250 of them from
+ * memory produces a table that looks authoritative and quietly rejects real
+ * addresses — which is worse than not knowing, because the user cannot
+ * override it. So the list covers the countries this marketplace actually
+ * ships to and to which its sellers source, and everything else resolves to
+ * `null`, which means "accept anything plausible".
+ *
+ * 🛑 An unknown country must never BLOCK a save. A postal rule exists to catch
+ * a typo, not to police the atlas.
+ *
+ * EXPORTS:
+ *   COUNTRIES, COUNTRY_CODES, DEFAULT_COUNTRY, type CountryCode,
+ *   type CountryDef, countryFor, postalPatternFor, isValidPostalCode,
+ *   postalLabelFor, POSTAL_MIN, POSTAL_MAX
+ *
+ * @tag domain:geo
+ * @tag layer:constants
+ * @tag pattern:registry
+ * @tag access:isomorphic
+ * @tag consumers:address forms,address routes,usePostalLookup
+ * @tag sideEffects:none
+ */
+/** The permissive bound applied when a country has no pattern. */
+export const POSTAL_MIN = 3;
+export const POSTAL_MAX = 12;
+/**
+ * 🛑 Patterns are anchored and case-insensitive where the country's format
+ * includes letters. An unanchored pattern would accept a code with trailing
+ * junk, which is exactly the class of typo this is meant to catch.
+ */
+const COUNTRY_LIST = [
+    { code: "IN", name: "India", postalPattern: /^[1-9]\d{5}$/, postalLabel: "PIN code", hasStates: true, dialCode: "91" },
+    { code: "US", name: "United States", postalPattern: /^\d{5}(-\d{4})?$/, postalLabel: "ZIP code", hasStates: true, dialCode: "1" },
+    { code: "GB", name: "United Kingdom", postalPattern: /^[A-Z]{1,2}\d[A-Z\d]?\s*\d[A-Z]{2}$/i, postalLabel: "Postcode", hasStates: false, dialCode: "44" },
+    { code: "CA", name: "Canada", postalPattern: /^[A-Z]\d[A-Z]\s*\d[A-Z]\d$/i, postalLabel: "Postal code", hasStates: true, dialCode: "1" },
+    { code: "AU", name: "Australia", postalPattern: /^\d{4}$/, postalLabel: "Postcode", hasStates: true, dialCode: "61" },
+    { code: "NZ", name: "New Zealand", postalPattern: /^\d{4}$/, postalLabel: "Postcode", hasStates: false, dialCode: "64" },
+    { code: "SG", name: "Singapore", postalPattern: /^\d{6}$/, postalLabel: "Postal code", hasStates: false, dialCode: "65" },
+    { code: "MY", name: "Malaysia", postalPattern: /^\d{5}$/, postalLabel: "Postcode", hasStates: false, dialCode: "60" },
+    { code: "JP", name: "Japan", postalPattern: /^\d{3}-?\d{4}$/, postalLabel: "Postal code", hasStates: false, dialCode: "81" },
+    { code: "DE", name: "Germany", postalPattern: /^\d{5}$/, postalLabel: "PLZ", hasStates: false, dialCode: "49" },
+    { code: "FR", name: "France", postalPattern: /^\d{5}$/, postalLabel: "Code postal", hasStates: false, dialCode: "33" },
+    { code: "NL", name: "Netherlands", postalPattern: /^\d{4}\s*[A-Z]{2}$/i, postalLabel: "Postcode", hasStates: false, dialCode: "31" },
+    { code: "IT", name: "Italy", postalPattern: /^\d{5}$/, postalLabel: "CAP", hasStates: false, dialCode: "39" },
+    { code: "ES", name: "Spain", postalPattern: /^\d{5}$/, postalLabel: "Código postal", hasStates: false, dialCode: "34" },
+    { code: "AE", name: "United Arab Emirates", postalPattern: null, postalLabel: "Postal code", hasStates: false, dialCode: "971" },
+    { code: "SA", name: "Saudi Arabia", postalPattern: /^\d{5}$/, postalLabel: "Postal code", hasStates: false, dialCode: "966" },
+    { code: "LK", name: "Sri Lanka", postalPattern: /^\d{5}$/, postalLabel: "Postal code", hasStates: false, dialCode: "94" },
+    { code: "BD", name: "Bangladesh", postalPattern: /^\d{4}$/, postalLabel: "Postal code", hasStates: false, dialCode: "880" },
+    { code: "NP", name: "Nepal", postalPattern: /^\d{5}$/, postalLabel: "Postal code", hasStates: false, dialCode: "977" },
+    { code: "PK", name: "Pakistan", postalPattern: /^\d{5}$/, postalLabel: "Postal code", hasStates: false, dialCode: "92" },
+    { code: "CN", name: "China", postalPattern: /^\d{6}$/, postalLabel: "Postal code", hasStates: false, dialCode: "86" },
+    { code: "HK", name: "Hong Kong", postalPattern: null, postalLabel: "Postal code", hasStates: false, dialCode: "852" },
+    { code: "TH", name: "Thailand", postalPattern: /^\d{5}$/, postalLabel: "Postal code", hasStates: false, dialCode: "66" },
+    { code: "ID", name: "Indonesia", postalPattern: /^\d{5}$/, postalLabel: "Postal code", hasStates: false, dialCode: "62" },
+    { code: "PH", name: "Philippines", postalPattern: /^\d{4}$/, postalLabel: "Postal code", hasStates: false, dialCode: "63" },
+    { code: "ZA", name: "South Africa", postalPattern: /^\d{4}$/, postalLabel: "Postal code", hasStates: false, dialCode: "27" },
+    { code: "BR", name: "Brazil", postalPattern: /^\d{5}-?\d{3}$/, postalLabel: "CEP", hasStates: false, dialCode: "55" },
+    { code: "MX", name: "Mexico", postalPattern: /^\d{5}$/, postalLabel: "Código postal", hasStates: false, dialCode: "52" },
+];
+export const COUNTRIES = Object.fromEntries(COUNTRY_LIST.map((c) => [c.code, c]));
+export const COUNTRY_CODES = COUNTRY_LIST.map((c) => c.code);
+/** Where this marketplace is, and what an address defaults to. */
+export 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 function countryFor(value) {
+    if (!value)
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return null;
+    const byCode = COUNTRIES[trimmed.toUpperCase()];
+    if (byCode)
+        return byCode;
+    const lower = trimmed.toLowerCase();
+    return COUNTRY_LIST.find((c) => c.name.toLowerCase() === lower) ?? null;
+}
+/** The postal pattern for a country, or `null` when none is known. */
+export function postalPatternFor(country) {
+    return countryFor(country)?.postalPattern ?? null;
+}
+/** "PIN code" / "ZIP code" / "Postcode" — what to put on the label. */
+export function postalLabelFor(country) {
+    return countryFor(country)?.postalLabel ?? "Postal code";
+}
+/**
+ * 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 function isValidPostalCode(country, postalCode) {
+    const code = (postalCode ?? "").trim();
+    if (!code)
+        return false;
+    const pattern = postalPatternFor(country);
+    if (pattern)
+        return pattern.test(code);
+    return code.length >= POSTAL_MIN && code.length <= POSTAL_MAX;
+}

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

@@ -0,0 +1,13 @@
+/** India's 28 states + 8 union territories. */
+declare const INDIA: readonly ["Andhra Pradesh", "Arunachal Pradesh", "Assam", "Bihar", "Chhattisgarh", "Goa", "Gujarat", "Haryana", "Himachal Pradesh", "Jharkhand", "Karnataka", "Kerala", "Madhya Pradesh", "Maharashtra", "Manipur", "Meghalaya", "Mizoram", "Nagaland", "Odisha", "Punjab", "Rajasthan", "Sikkim", "Tamil Nadu", "Telangana", "Tripura", "Uttar Pradesh", "Uttarakhand", "West Bengal", "Andaman and Nicobar Islands", "Chandigarh", "Dadra and Nagar Haveli and Daman and Diu", "Delhi", "Jammu and Kashmir", "Ladakh", "Lakshadweep", "Puducherry"];
+export type IndianState = (typeof INDIA)[number];
+/** Country code → its subdivisions, alphabetical within each. */
+export declare const SUBDIVISIONS: Record<string, readonly string[]>;
+/**
+ * The subdivisions for a country, or an empty list when it has none.
+ *
+ * An empty list is the signal to render a free-text State input rather than a
+ * picker — see `hasStates` on the country definition.
+ */
+export declare function subdivisionsFor(countryCode: string | undefined | null): readonly string[];
+export {};

package/dist/constants/geo/subdivisions.js

@@ -0,0 +1,104 @@
+/*
+ * WHY: `INDIAN_STATES` existed and was used by **one** file — the admin
+ *      address editor — while the user-facing `AddressForm` and
+ *      `SellerAddressesView` both wrote the same `AddressDocument.state`
+ *      through a FREE TEXT input. So the same field held "Karnataka",
+ *      "karnataka", "KA" and "Karnatka" depending on which of the three
+ *      surfaces created the row, and nothing could group or filter on it.
+ * WHAT: Country → subdivisions, for every country whose `hasStates` is true.
+ *
+ * ## Only what is enumerated
+ *
+ * A country appears here when `COUNTRIES[code].hasStates` is true, and the two
+ * must agree — `audit-address-shape` checks that. A country with `hasStates`
+ * and no list would render an empty picker with no way to type a state, which
+ * is strictly worse than the free-text box this replaces.
+ *
+ * EXPORTS: SUBDIVISIONS, subdivisionsFor, type IndianState
+ *
+ * @tag domain:geo
+ * @tag layer:constants
+ * @tag pattern:registry
+ * @tag access:isomorphic
+ * @tag consumers:address forms
+ * @tag sideEffects:none
+ */
+/** India's 28 states + 8 union territories. */
+const INDIA = [
+    "Andhra Pradesh",
+    "Arunachal Pradesh",
+    "Assam",
+    "Bihar",
+    "Chhattisgarh",
+    "Goa",
+    "Gujarat",
+    "Haryana",
+    "Himachal Pradesh",
+    "Jharkhand",
+    "Karnataka",
+    "Kerala",
+    "Madhya Pradesh",
+    "Maharashtra",
+    "Manipur",
+    "Meghalaya",
+    "Mizoram",
+    "Nagaland",
+    "Odisha",
+    "Punjab",
+    "Rajasthan",
+    "Sikkim",
+    "Tamil Nadu",
+    "Telangana",
+    "Tripura",
+    "Uttar Pradesh",
+    "Uttarakhand",
+    "West Bengal",
+    "Andaman and Nicobar Islands",
+    "Chandigarh",
+    "Dadra and Nagar Haveli and Daman and Diu",
+    "Delhi",
+    "Jammu and Kashmir",
+    "Ladakh",
+    "Lakshadweep",
+    "Puducherry",
+];
+const US = [
+    "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado",
+    "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia",
+    "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky",
+    "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota",
+    "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire",
+    "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota",
+    "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island",
+    "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont",
+    "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming",
+];
+const CA = [
+    "Alberta", "British Columbia", "Manitoba", "New Brunswick",
+    "Newfoundland and Labrador", "Northwest Territories", "Nova Scotia",
+    "Nunavut", "Ontario", "Prince Edward Island", "Quebec", "Saskatchewan",
+    "Yukon",
+];
+const AU = [
+    "Australian Capital Territory", "New South Wales", "Northern Territory",
+    "Queensland", "South Australia", "Tasmania", "Victoria",
+    "Western Australia",
+];
+/** Country code → its subdivisions, alphabetical within each. */
+export const SUBDIVISIONS = {
+    IN: INDIA,
+    US,
+    CA,
+    AU,
+};
+/**
+ * The subdivisions for a country, or an empty list when it has none.
+ *
+ * An empty list is the signal to render a free-text State input rather than a
+ * picker — see `hasStates` on the country definition.
+ */
+export function subdivisionsFor(countryCode) {
+    if (!countryCode)
+        return [];
+    return SUBDIVISIONS[countryCode.trim().toUpperCase()] ?? [];
+}

package/dist/constants/index.d.ts

@@ -9,7 +9,7 @@
  *   import { COLLECTION_CACHE_PATHS } from "@mohasinac/appkit/constants";
  *   import { resolveEndpoint } from "@mohasinac/appkit/constants";
  */
-export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, CHAT_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, COPILOT_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, PROMOTION_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, STORE_ENDPOINTS, WISHLIST_ENDPOINTS, PROFILE_STATS_ENDPOINTS, } from "./api-endpoints";
+export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, COPILOT_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, PROMOTION_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, STORE_ENDPOINTS, WISHLIST_ENDPOINTS, PROFILE_STATS_ENDPOINTS, } from "./api-endpoints";
 export { COLLECTION_CACHE_PATHS } from "./cache-invalidation";
 export { PAGE_SIZES, MAX_PAGE_SIZE, FEATURED_LIMITS, SITEMAP_LIMITS, } from "./pagination-presets";
 export type { PageSizeKey } from "./pagination-presets";
@@ -18,6 +18,6 @@ export type { NotificationType } from "./notification-types";
 export { resolveEndpoint, resolveEndpointFn } from "./api-endpoint-resolver";
 export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "../next/routing/route-map";
 export { WISHLIST_MAX, HISTORY_MAX, CART_MAX_ITEMS, WISHLIST_DOC_ID, HISTORY_DOC_ID, WISHLIST_COLLECTION, HISTORY_COLLECTION, } from "./limits";
-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 "./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 "./field-names";
 export { SELLER_LISTING_TABS, type SellerListingTabId, } 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";

package/dist/constants/index.js

@@ -9,7 +9,7 @@
  *   import { COLLECTION_CACHE_PATHS } from "@mohasinac/appkit/constants";
  *   import { resolveEndpoint } from "@mohasinac/appkit/constants";
  */
-export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, CHAT_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, COPILOT_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, PROMOTION_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, STORE_ENDPOINTS, WISHLIST_ENDPOINTS, PROFILE_STATS_ENDPOINTS, } from "./api-endpoints";
+export { API_ENDPOINTS, API_ROUTES, LOGS_ENDPOINTS, AUTH_ENDPOINTS, ACCOUNT_ENDPOINTS, NOTIFICATIONS_ENDPOINTS, SITE_SETTINGS_ENDPOINTS, ADMIN_ENDPOINTS, AUCTION_ENDPOINTS, BID_ENDPOINTS, CART_ENDPOINTS, CATEGORY_ENDPOINTS, CHECKOUT_ENDPOINTS, PAYMENT_ENDPOINTS, COLLECTION_ENDPOINTS, CONSULTATION_ENDPOINTS, COPILOT_ENDPOINTS, CORPORATE_ENDPOINTS, EVENT_ENDPOINTS, FAQ_ENDPOINTS, HOMEPAGE_ENDPOINTS, LOYALTY_ENDPOINTS, ANALYTICS_ENDPOINTS, MEDIA_ENDPOINTS, ORDER_ENDPOINTS, PREORDER_ENDPOINTS, PRODUCT_ENDPOINTS, PROMOTION_ENDPOINTS, REVIEW_ENDPOINTS, SEARCH_ENDPOINTS, SELLER_ENDPOINTS, BLOG_ENDPOINTS, STORE_ENDPOINTS, WISHLIST_ENDPOINTS, PROFILE_STATS_ENDPOINTS, } from "./api-endpoints";
 export { COLLECTION_CACHE_PATHS } from "./cache-invalidation";
 export { PAGE_SIZES, MAX_PAGE_SIZE, FEATURED_LIMITS, SITEMAP_LIMITS, } from "./pagination-presets";
 export { NOTIFICATION_TYPES, NOTIFICATION_TYPE_TABS, } from "./notification-types";
@@ -21,7 +21,7 @@ export { WISHLIST_MAX, HISTORY_MAX, CART_MAX_ITEMS, WISHLIST_DOC_ID, HISTORY_DOC
 // derived objects (e.g. Object.values(...) for a Zod enum) at module-eval
 // time, which needs a small, synchronously-resolvable subpath rather than
 // the much larger client.ts barrel.
-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 "./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 "./field-names";
 // Dashboard filter-tab sets — same rationale as the field-name maps above.
 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";

package/dist/constants/table-keys.d.ts

@@ -68,6 +68,30 @@ export declare const TABLE_KEYS: {
     readonly LIVE_TRANSPORT_METHOD: "liveTransportMethod";
 };
 export type TableKey = (typeof TABLE_KEYS)[keyof typeof TABLE_KEYS];
+/**
+ * The one delimiter joining several values of ONE filter key in a URL.
+ *
+ * 🛑 `"|"`, never `","`. sievejs reads same-field `|` as an OR-group, which the
+ * Firestore adapter upgrades to an `in` query. A comma is a clause SEPARATOR —
+ * `condition==new,condition==used` is an AND of two equalities on one field and
+ * can never match a document.
+ *
+ * Two filter systems disagreed on this. `ProductFilters` and the 11 sites like
+ * it wrote `vals.join("|")`; `usePendingFilters` and `FilterPanel` split and
+ * joined on `","` for the SAME URL keys. Nothing broke visibly, because a
+ * pipe-joined string survives a comma split as a single element and round-trips
+ * intact — but it counts as ONE, so the active-filter badge reported 1 for a
+ * three-category selection, and `usePendingTable.get`'s `[0]` returned the
+ * whole `"a|b|c"` string and appeared correct for the same wrong reason.
+ *
+ * Split and join through the two helpers below rather than inlining either
+ * character; that is what keeps the count, the wire format and Sieve agreeing.
+ */
+export declare const FILTER_VALUE_DELIMITER = "|";
+/** Parse a multi-value filter param. Empty string → no values, never `[""]`. */
+export declare function splitFilterValues(raw: string | null | undefined): string[];
+/** Serialise a multi-value filter param for the URL. */
+export declare function joinFilterValues(values: readonly string[]): string;
 export declare const VIEW_MODE: {
     readonly GRID: "grid";
     readonly LIST: "list";

package/dist/constants/table-keys.js

@@ -70,6 +70,34 @@ export const TABLE_KEYS = {
     LIVE_SEX: "liveSex",
     LIVE_TRANSPORT_METHOD: "liveTransportMethod",
 };
+/**
+ * The one delimiter joining several values of ONE filter key in a URL.
+ *
+ * 🛑 `"|"`, never `","`. sievejs reads same-field `|` as an OR-group, which the
+ * Firestore adapter upgrades to an `in` query. A comma is a clause SEPARATOR —
+ * `condition==new,condition==used` is an AND of two equalities on one field and
+ * can never match a document.
+ *
+ * Two filter systems disagreed on this. `ProductFilters` and the 11 sites like
+ * it wrote `vals.join("|")`; `usePendingFilters` and `FilterPanel` split and
+ * joined on `","` for the SAME URL keys. Nothing broke visibly, because a
+ * pipe-joined string survives a comma split as a single element and round-trips
+ * intact — but it counts as ONE, so the active-filter badge reported 1 for a
+ * three-category selection, and `usePendingTable.get`'s `[0]` returned the
+ * whole `"a|b|c"` string and appeared correct for the same wrong reason.
+ *
+ * Split and join through the two helpers below rather than inlining either
+ * character; that is what keeps the count, the wire format and Sieve agreeing.
+ */
+export const FILTER_VALUE_DELIMITER = "|";
+/** Parse a multi-value filter param. Empty string → no values, never `[""]`. */
+export function splitFilterValues(raw) {
+    return raw ? raw.split(FILTER_VALUE_DELIMITER).filter(Boolean) : [];
+}
+/** Serialise a multi-value filter param for the URL. */
+export function joinFilterValues(values) {
+    return values.filter(Boolean).join(FILTER_VALUE_DELIMITER);
+}
 export const VIEW_MODE = {
     GRID: "grid",
     LIST: "list",

package/dist/contracts/extend.d.ts

@@ -52,15 +52,6 @@ export interface WithTransformOpts<Base, Target extends Base = Base> {
  * Convenience helper: build a response type for list endpoints that mirrors
  * the package's standard list-response shape but with a generic item type.
  */
-export interface GenericListResponse<T> {
-    items: T[];
-    total: number;
-    page: number;
-    pageSize?: number;
-    perPage?: number;
-    totalPages: number;
-    hasMore?: boolean;
-}
 /**
  * A single column definition for data tables.
  * Defined here in contracts so feat-* packages can export default column sets

package/dist/contracts/index.d.ts

@@ -17,7 +17,7 @@ export type { ExtraFormField, ExtraFieldRenderArgs } from "./form";
 export { registerFormFields, resolveFormFields, removeFormFields, _resetFormFields, } from "./form";
 export type { RouteStub, ApiRouteStub, FeatureManifest, FeaturesConfig, } from "./feature";
 export type { SiteConfig, NavItem } from "./config";
-export type { WithTransformOpts, GenericListResponse, TableColumn, ColumnPriority, ColumnExtensionOpts, LayoutSlots, FeatureExtension, } from "./extend";
+export type { WithTransformOpts, TableColumn, ColumnPriority, ColumnExtensionOpts, LayoutSlots, FeatureExtension, } from "./extend";
 export { COLUMN_PRIORITY_CLASS, COLUMN_PRIORITY_CLASS_BLOCK } from "./extend";
 export type { PaginationConfig, StickyConfig, TableConfig, TableViewMode, } from "./table";
 export { DEFAULT_PAGINATION_CONFIG, DEFAULT_STICKY_CONFIG, DEFAULT_TABLE_CONFIG, mergeTableConfig, } from "./table";