@mohasinac/appkit 4.66.0 → 4.68.0

package/dist/_internal/shared/listing-types/hidden-surfaces.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Which public BROWSE ROUTES must not be served, given the admin flags and the
+ * measured counts.
+ *
+ * ## Why this is one function and not two copies
+ *
+ * Two places need this answer and they must never disagree:
+ *
+ *   · `buildSitemap` — decides which browse URLs are advertised.
+ *   · `toPublicSiteSettings` → `src/proxy.ts` — decides which browse URLs 404.
+ *
+ * A disagreement is not cosmetic: the sitemap advertising a URL the edge 404s
+ * is a crawl error on a page we told Google to fetch, and the reverse serves a
+ * surface we have decided is closed. They were two hand-written copies of the
+ * same two loops when this was extracted.
+ *
+ * ## 🛑 EXACT PATHS, never prefixes
+ *
+ * `art`, `stickers`, `spares` and `standard` all detail at `/products/{slug}`,
+ * so a prefix rule would delist — or 404 — the entire standard catalogue the
+ * day `spares` emptied. An empty type contributes no detail URLs anyway, since
+ * its own fetcher returns none, so the exact-path rule loses nothing real.
+ *
+ * ## 🛑 A SHARED route survives while ANY of its types is visible
+ *
+ * `/art` spans `art` and `stickers`; `/products` spans `standard` plus several
+ * others. Without the second pass, hiding `stickers` alone would close a page
+ * `art` still fills — and hiding `spares` alone would close `/products`.
+ *
+ * @tag domain:products
+ * @tag layer:shared
+ * @tag access:isomorphic
+ * @tag sideEffects:none
+ */
+import { type SurfaceCountSnapshot } from "./feature-flags";
+/** The snapshot shape `isListingSurfaceVisible` reads its admin flags from. */
+interface SettingsSnapshot {
+    listings?: {
+        listingTypes?: Partial<Record<string, boolean>>;
+    };
+}
+export declare function hiddenSurfaceRoutes(settings: SettingsSnapshot | null | undefined, counts: SurfaceCountSnapshot | null | undefined): string[];
+export {};

package/dist/_internal/shared/listing-types/hidden-surfaces.js

@@ -0,0 +1,57 @@
+/**
+ * Which public BROWSE ROUTES must not be served, given the admin flags and the
+ * measured counts.
+ *
+ * ## Why this is one function and not two copies
+ *
+ * Two places need this answer and they must never disagree:
+ *
+ *   · `buildSitemap` — decides which browse URLs are advertised.
+ *   · `toPublicSiteSettings` → `src/proxy.ts` — decides which browse URLs 404.
+ *
+ * A disagreement is not cosmetic: the sitemap advertising a URL the edge 404s
+ * is a crawl error on a page we told Google to fetch, and the reverse serves a
+ * surface we have decided is closed. They were two hand-written copies of the
+ * same two loops when this was extracted.
+ *
+ * ## 🛑 EXACT PATHS, never prefixes
+ *
+ * `art`, `stickers`, `spares` and `standard` all detail at `/products/{slug}`,
+ * so a prefix rule would delist — or 404 — the entire standard catalogue the
+ * day `spares` emptied. An empty type contributes no detail URLs anyway, since
+ * its own fetcher returns none, so the exact-path rule loses nothing real.
+ *
+ * ## 🛑 A SHARED route survives while ANY of its types is visible
+ *
+ * `/art` spans `art` and `stickers`; `/products` spans `standard` plus several
+ * others. Without the second pass, hiding `stickers` alone would close a page
+ * `art` still fills — and hiding `spares` alone would close `/products`.
+ *
+ * @tag domain:products
+ * @tag layer:shared
+ * @tag access:isomorphic
+ * @tag sideEffects:none
+ */
+import { ALL_LISTING_TYPES, isListingSurfaceVisible, } from "./feature-flags.js";
+import { pluginFor } from "./_registry.js";
+export function hiddenSurfaceRoutes(settings, counts) {
+    const hidden = new Set();
+    const routeOf = (type) => String(pluginFor(type).browseRoute ?? "");
+    for (const type of ALL_LISTING_TYPES) {
+        if (isListingSurfaceVisible(type, settings, counts))
+            continue;
+        const route = routeOf(type);
+        if (route)
+            hidden.add(route);
+    }
+    /*
+     * Second pass, deliberately not folded into the first: a route is only
+     * hidden once EVERY type that browses there is hidden, and the first pass
+     * cannot know that until it has seen them all.
+     */
+    for (const type of ALL_LISTING_TYPES) {
+        if (isListingSurfaceVisible(type, settings, counts))
+            hidden.delete(routeOf(type));
+    }
+    return [...hidden];
+}

package/dist/client.d.ts

@@ -422,6 +422,8 @@ export { useListingTypeFlags } from "./react/hooks/useListingTypeFlags";
 export type { ListingTypeFlags, ListingTypeFlagsShape, } from "./react/hooks/useListingTypeFlags";
 export { useBrowsePageFlags } from "./react/hooks/useBrowsePageFlags";
 export type { BrowsePageFlags, BrowsePageFlagsShape, } from "./react/hooks/useBrowsePageFlags";
+export { useListingSurfaceVisibility } from "./react/hooks/useListingSurfaceVisibility";
+export type { ListingSurfaceVisibility } from "./react/hooks/useListingSurfaceVisibility";
 export { useActionDispatch } from "./react/hooks/use-action-dispatch";
 export type { DispatchAction, UseActionDispatchOptions } from "./react/hooks/use-action-dispatch";
 export { usePanelStore } from "./stores/panel-store";
@@ -535,8 +537,8 @@ export type { TrackArgs as TrackHistoryArgs } from "./features/history/hooks/use
 export { WISHLIST_MAX, HISTORY_MAX, CART_MAX_ITEMS, } from "./constants/limits";
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/utils/listing-type";
 export { isFinalSale, acceptsChangeOfMindReturns, } from "./features/products/constants/final-sale";
-export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, isListingType, isBrowsePageEnabled, enabledBrowsePages, ALL_BROWSE_PAGES, isBrowsePageKey, } from "./_internal/shared/listing-types/feature-flags";
-export type { BrowsePageKey } from "./_internal/shared/listing-types/feature-flags";
+export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, isListingType, isBrowsePageEnabled, enabledBrowsePages, ALL_BROWSE_PAGES, isBrowsePageKey, isListingSurfaceVisible, isCountedSurfaceVisible, visibleListingTypes, } from "./_internal/shared/listing-types/feature-flags";
+export type { BrowsePageKey, SurfaceCountSnapshot, } from "./_internal/shared/listing-types/feature-flags";
 export { ADVANCED_LISTING_TYPE_CAPABILITY, ADVANCED_LISTING_TYPES, BASIC_LISTING_TYPES, LISTING_TYPE_TIER, hasAdvancedListingTypes, isAdvancedListingType, isListingTypeAllowedFor, listingTypesAllowedFor, } from "./_internal/shared/listing-types/tiers";
 export type { ListingTypeAccessContext, ListingTypeTier, } from "./_internal/shared/listing-types/tiers";
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type ActionEvent, type ActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";

package/dist/client.js

@@ -448,6 +448,11 @@ export { useListingTypeFlags } from "./react/hooks/useListingTypeFlags.js";
 // [CLIENT-ONLY] useBrowsePageFlags: read listings.browsePages from
 // siteSettings; drop nav/sidebar/footer links into a closed browse section.
 export { useBrowsePageFlags } from "./react/hooks/useBrowsePageFlags.js";
+// [CLIENT-ONLY] useListingSurfaceVisibility: the admin flag MINUS the surfaces
+// measured as empty. For BROWSING links only — authoring surfaces (the seller
+// type dropdown) must keep using useListingTypeFlags, or the first listing of
+// an emptied type becomes impossible to create.
+export { useListingSurfaceVisibility } from "./react/hooks/useListingSurfaceVisibility.js";
 // Action dispatch hook + panel store
 export { useActionDispatch } from "./react/hooks/use-action-dispatch.js";
 export { usePanelStore } from "./stores/panel-store.js";
@@ -542,7 +547,11 @@ export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabl
 // Browse-section gates. Client-safe and genuinely needed here: the nav,
 // sidebar, mobile sheet and footer all filter on them, and a link into a
 // closed section is a 404 on every page of the site.
-isBrowsePageEnabled, enabledBrowsePages, ALL_BROWSE_PAGES, isBrowsePageKey, } from "./_internal/shared/listing-types/feature-flags.js";
+isBrowsePageEnabled, enabledBrowsePages, ALL_BROWSE_PAGES, isBrowsePageKey, 
+// Auto-hide: a surface measured as having nothing in it. Client-safe and
+// needed here for the same reason as the browse-section gates above — the
+// nav, sidebar, mobile sheet and footer all filter on them.
+isListingSurfaceVisible, isCountedSurfaceVisible, visibleListingTypes, } from "./_internal/shared/listing-types/feature-flags.js";
 // Basic/advanced listing-type split. Client-safe: the nav filter and any
 // seller-facing picker need the same rule the server enforces, and deriving it
 // twice is how the ten hand-written copies of the union happened.

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

@@ -264,6 +264,7 @@ export declare const ADMIN_ENDPOINTS: {
     readonly CHECKOUT_BYPASS: "/api/admin/checkout-bypass";
     readonly MAINTENANCE_ANALYSIS: "/api/admin/maintenance/analysis";
     readonly MAINTENANCE_CLOUD_LOGS: "/api/admin/maintenance/cloud-logs";
+    readonly CACHE_REVALIDATE: "/api/admin/cache/revalidate";
     readonly MEDIA_LIST: "/api/admin/media";
 };
 export declare const AUCTION_ENDPOINTS: {
@@ -898,6 +899,7 @@ export declare const API_ENDPOINTS: {
         readonly CHECKOUT_BYPASS: "/api/admin/checkout-bypass";
         readonly MAINTENANCE_ANALYSIS: "/api/admin/maintenance/analysis";
         readonly MAINTENANCE_CLOUD_LOGS: "/api/admin/maintenance/cloud-logs";
+        readonly CACHE_REVALIDATE: "/api/admin/cache/revalidate";
         readonly MEDIA_LIST: "/api/admin/media";
     };
     readonly AUCTIONS: {
@@ -1497,6 +1499,7 @@ export declare const API_ROUTES: {
         readonly CHECKOUT_BYPASS: "/api/admin/checkout-bypass";
         readonly MAINTENANCE_ANALYSIS: "/api/admin/maintenance/analysis";
         readonly MAINTENANCE_CLOUD_LOGS: "/api/admin/maintenance/cloud-logs";
+        readonly CACHE_REVALIDATE: "/api/admin/cache/revalidate";
         readonly MEDIA_LIST: "/api/admin/media";
     };
     readonly AUCTIONS: {

package/dist/constants/api-endpoints.js

@@ -313,6 +313,17 @@ export const ADMIN_ENDPOINTS = {
     CHECKOUT_BYPASS: "/api/admin/checkout-bypass",
     MAINTENANCE_ANALYSIS: "/api/admin/maintenance/analysis",
     MAINTENANCE_CLOUD_LOGS: "/api/admin/maintenance/cloud-logs",
+    /*
+     * Admin-session-gated cache invalidation.
+     *
+     * 🛑 Deliberately NOT `/api/cache/revalidate`, which authenticates on an
+     * `x-api-key` matching `CACHE_REVALIDATION_SECRET`. That secret belongs to
+     * the Firestore triggers and the seed CLI; shipping it to a browser so a
+     * button could call that endpoint would put a server secret in client code.
+     * This one carries no secret and is gated on the admin session like every
+     * other `/api/admin/*` route.
+     */
+    CACHE_REVALIDATE: "/api/admin/cache/revalidate",
     MEDIA_LIST: "/api/admin/media",
 };
 // ---------------------------------------------------------------------------

package/dist/features/products/schemas/surface-counts.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Site-wide "does this browse surface have anything in it" counters.
+ *
+ * ## Why a sibling singleton and not a field on `siteSettings`
+ *
+ * `siteSettings` is admin-authored CONFIG and is in the tester's PRESERVE tier.
+ * This is DERIVED measurement, rewritten by a job. Mixing the two means a
+ * reconciler writing into the document that holds live API credentials, and it
+ * means a reseed or a settings restore silently reverting a count. Same split
+ * `categoryCounts` already makes against `categories`, and for the same
+ * Root Cause #92 reason: nothing triggers on this collection, so writing it
+ * can never re-enter the trigger that produced it.
+ *
+ * ## 🛑 ABSENT MEANS UNKNOWN, NEVER ZERO
+ *
+ * This is the single rule the whole file exists to enforce, and getting it
+ * backwards hides the entire catalogue.
+ *
+ * A key missing from either map means "not measured yet" — a fresh install, a
+ * failed job, a type added since the last run. Every reader must treat that as
+ * **visible**, exactly as `getLiveCategoryCounts` returns `undefined` rather
+ * than 0 so its callers fall back to `metrics`. Root Cause #72 is this
+ * project's record of the opposite choice: a "hide it when it's empty" rule
+ * whose count map did not cover an option, so "unknown" read as "zero" and the
+ * section vanished.
+ *
+ * `Partial` is therefore load-bearing typing, not convenience — an explicit
+ * zero and an absent key MUST stay distinguishable.
+ *
+ * ## 🛑 These are AVAILABLE rows, which is a time-dependent question
+ *
+ * The counts come from `listPublicProducts`, the one function every public
+ * browse page already queries through — so a surface can never be hidden while
+ * its own page would have rendered rows, which is the correctness property
+ * that matters here and the reason this is not a bespoke `count()` query.
+ *
+ * It inherits that function's time-dependence: an auction becomes unavailable
+ * by the clock with no product write, so a type whose last row just ended stays
+ * "non-empty" until the next recompute. Erring toward VISIBLE is the right
+ * direction for this feature — showing an empty list is a cosmetic problem,
+ * hiding a live one is a lost sale.
+ *
+ * @tag domain:products
+ * @tag layer:schema
+ * @tag access:isomorphic
+ */
+import type { ListingType } from "../types/index";
+export declare const SURFACE_COUNTS_COLLECTION = "surfaceCounts";
+/** Singleton — these are site-wide totals, so there is exactly one row. */
+export declare const SURFACE_COUNTS_DOC_ID = "global";
+/**
+ * Public browse surfaces that are NOT a listing type and so have no
+ * `listings.listingTypes` flag to hang off.
+ *
+ * Deliberately just `reviews` today. A key here must have a real consumer —
+ * `/stores` and `/categories` already have their own `browsePages` flag and
+ * adding them here would be a second mechanism deciding one thing.
+ */
+export type CountedSurfaceKey = "reviews";
+export interface SurfaceCountsDocument {
+    id: string;
+    /**
+     * Available listings per type. Absent key = UNKNOWN = show.
+     *
+     * A map rather than scalar fields: the listing-type union has grown twice
+     * (nine → ten with `spares`), and a map needs no schema change for the next.
+     */
+    listingTypes: Partial<Record<ListingType, number>>;
+    /** Non-listing-type surfaces. Absent key = UNKNOWN = show. */
+    surfaces: Partial<Record<CountedSurfaceKey, number>>;
+    /**
+     * When the figures were taken. Read by the admin panel so an operator can
+     * tell "measured as empty an hour ago" from "never measured".
+     */
+    updatedAt: Date;
+}
+/**
+ * Is this surface known to be empty?
+ *
+ * Returns `false` for an unmeasured surface — the caller must not be able to
+ * express "hide it" without a measurement that says so.
+ */
+export declare function isKnownEmpty(count: number | undefined): boolean;

package/dist/features/products/schemas/surface-counts.js

@@ -0,0 +1,58 @@
+/**
+ * Site-wide "does this browse surface have anything in it" counters.
+ *
+ * ## Why a sibling singleton and not a field on `siteSettings`
+ *
+ * `siteSettings` is admin-authored CONFIG and is in the tester's PRESERVE tier.
+ * This is DERIVED measurement, rewritten by a job. Mixing the two means a
+ * reconciler writing into the document that holds live API credentials, and it
+ * means a reseed or a settings restore silently reverting a count. Same split
+ * `categoryCounts` already makes against `categories`, and for the same
+ * Root Cause #92 reason: nothing triggers on this collection, so writing it
+ * can never re-enter the trigger that produced it.
+ *
+ * ## 🛑 ABSENT MEANS UNKNOWN, NEVER ZERO
+ *
+ * This is the single rule the whole file exists to enforce, and getting it
+ * backwards hides the entire catalogue.
+ *
+ * A key missing from either map means "not measured yet" — a fresh install, a
+ * failed job, a type added since the last run. Every reader must treat that as
+ * **visible**, exactly as `getLiveCategoryCounts` returns `undefined` rather
+ * than 0 so its callers fall back to `metrics`. Root Cause #72 is this
+ * project's record of the opposite choice: a "hide it when it's empty" rule
+ * whose count map did not cover an option, so "unknown" read as "zero" and the
+ * section vanished.
+ *
+ * `Partial` is therefore load-bearing typing, not convenience — an explicit
+ * zero and an absent key MUST stay distinguishable.
+ *
+ * ## 🛑 These are AVAILABLE rows, which is a time-dependent question
+ *
+ * The counts come from `listPublicProducts`, the one function every public
+ * browse page already queries through — so a surface can never be hidden while
+ * its own page would have rendered rows, which is the correctness property
+ * that matters here and the reason this is not a bespoke `count()` query.
+ *
+ * It inherits that function's time-dependence: an auction becomes unavailable
+ * by the clock with no product write, so a type whose last row just ended stays
+ * "non-empty" until the next recompute. Erring toward VISIBLE is the right
+ * direction for this feature — showing an empty list is a cosmetic problem,
+ * hiding a live one is a lost sale.
+ *
+ * @tag domain:products
+ * @tag layer:schema
+ * @tag access:isomorphic
+ */
+export const SURFACE_COUNTS_COLLECTION = "surfaceCounts";
+/** Singleton — these are site-wide totals, so there is exactly one row. */
+export const SURFACE_COUNTS_DOC_ID = "global";
+/**
+ * Is this surface known to be empty?
+ *
+ * Returns `false` for an unmeasured surface — the caller must not be able to
+ * express "hide it" without a measurement that says so.
+ */
+export function isKnownEmpty(count) {
+    return count === 0;
+}

package/dist/index.d.ts

@@ -2190,8 +2190,8 @@ export { getProductSortOptions } from "./features/products/components/ProductFil
 export { getProductTableColumns } from "./features/products/columns/productTableColumns";
 export { normalizeListingType, isAuctionListing, isPreOrderListing, isStandardListing, isPrizeDrawListing, isClassifiedListing, isDigitalCodeListing, isLiveListing, isArtListing, isStickersListing, } from "./features/products/index";
 export { isFinalSale, acceptsChangeOfMindReturns, } from "./features/products/constants/final-sale";
-export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, isListingType, isBrowsePageEnabled, enabledBrowsePages, ALL_BROWSE_PAGES, isBrowsePageKey, } from "./_internal/shared/listing-types/feature-flags";
-export type { BrowsePageKey } from "./_internal/shared/listing-types/feature-flags";
+export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabledCategoryTypes, ALL_LISTING_TYPES, isListingType, isBrowsePageEnabled, enabledBrowsePages, ALL_BROWSE_PAGES, isBrowsePageKey, isListingSurfaceVisible, isCountedSurfaceVisible, visibleListingTypes, } from "./_internal/shared/listing-types/feature-flags";
+export type { BrowsePageKey, SurfaceCountSnapshot, } from "./_internal/shared/listing-types/feature-flags";
 export { ADVANCED_LISTING_TYPE_CAPABILITY, ADVANCED_LISTING_TYPES, BASIC_LISTING_TYPES, LISTING_TYPE_TIER, assertListingTypeAllowed, hasAdvancedListingTypes, isAdvancedListingType, isListingTypeAllowedFor, listingTypesAllowedFor, } from "./_internal/shared/listing-types/tiers";
 export type { ListingTypeAccessContext, ListingTypeTier, } from "./_internal/shared/listing-types/tiers";
 export { actionTracker, setActionTrackerSink, resetActionTrackerSink, type ActionEvent, type ActionTrackerSink, } from "./_internal/shared/listing-types/action-tracker";

package/dist/index.js

@@ -4083,7 +4083,9 @@ export { isListingTypeEnabled, isCategoryTypeEnabled, enabledListingTypes, enabl
 // file's ALL_LISTING_TYPES note: `server-entry.ts` re-exports index, so a
 // Server Component already reaches these from the bare specifier and a
 // second path would leak an `_internal/` symbol through a third barrel.
-isBrowsePageEnabled, enabledBrowsePages, ALL_BROWSE_PAGES, isBrowsePageKey, } from "./_internal/shared/listing-types/feature-flags.js";
+isBrowsePageEnabled, enabledBrowsePages, ALL_BROWSE_PAGES, isBrowsePageKey, 
+// Auto-hide gates — same barrel choice as the browse-section ones above.
+isListingSurfaceVisible, isCountedSurfaceVisible, visibleListingTypes, } from "./_internal/shared/listing-types/feature-flags.js";
 // Basic/advanced listing-type split — which types a store may create.
 // Pure (no firebase-admin in its import chain), so it is safe in index.ts.
 export { ADVANCED_LISTING_TYPE_CAPABILITY, ADVANCED_LISTING_TYPES, BASIC_LISTING_TYPES, LISTING_TYPE_TIER, assertListingTypeAllowed, hasAdvancedListingTypes, isAdvancedListingType, isListingTypeAllowedFor, listingTypesAllowedFor, } from "./_internal/shared/listing-types/tiers.js";

package/dist/react/hooks/useListingSurfaceVisibility.d.ts

@@ -0,0 +1,44 @@
+import type { ListingType } from "../../features/products/types/index";
+/**
+ * Which public browse surfaces should be LINKED — the admin flag, minus the
+ * ones measured as having nothing in them.
+ *
+ * ## 🛑 Why this is not a change to `useListingTypeFlags`
+ *
+ * That hook answers a different question — *"does this marketplace sell X?"* —
+ * and its main consumer is the seller's type dropdown. A seller must still be
+ * able to list the first spare part when there are zero spares, so folding
+ * emptiness into it would make the catalogue unfillable the moment it emptied:
+ * the only control that could add stock would disappear for want of stock.
+ * Same split as `enabledListingTypes` vs `visibleListingTypes`.
+ *
+ * So: `useListingTypeFlags` for anything AUTHORING, this for anything
+ * BROWSING.
+ *
+ * ## 🛑 Defaults to VISIBLE while settings load
+ *
+ * Same reasoning as `useBrowsePageFlags`, and it bites harder here. This hook
+ * decides whether a nav entry renders, and `surfaceCounts` is absent from the
+ * payload until the rollup has run at least once — so a restrictive default
+ * would blank most of the navbar on every cold load, and would blank it
+ * permanently on an install whose job has never run.
+ *
+ * `isListingSurfaceVisible` encodes the rule (absent count → visible); this
+ * hook only supplies it with data. Do not re-derive the comparison here.
+ */
+export type ListingSurfaceVisibility = Record<ListingType, boolean> & {
+    /** True when the type's browse surface should be linked. */
+    isVisible: (type: ListingType) => boolean;
+    /**
+     * True when a non-listing-type surface (`"reviews"`) should be linked.
+     * Absent measurement → true.
+     */
+    isSurfaceVisible: (surface: string) => boolean;
+    /**
+     * True when a link may be shown — it points at no listing-type surface, or
+     * at one that is visible. Pass an href straight from a nav/footer constant,
+     * together with the href→types map the caller owns.
+     */
+    allowsTypes: (types: readonly ListingType[] | undefined) => boolean;
+};
+export declare function useListingSurfaceVisibility(): ListingSurfaceVisibility;

package/dist/react/hooks/useListingSurfaceVisibility.js

@@ -0,0 +1,20 @@
+"use client";
+import { useSiteSettings } from "../../core/hooks/useSiteSettings.js";
+import { ALL_LISTING_TYPES, isListingSurfaceVisible, isCountedSurfaceVisible, } from "../../_internal/shared/listing-types/feature-flags.js";
+export function useListingSurfaceVisibility() {
+    const { data } = useSiteSettings();
+    const settings = { listings: { listingTypes: data?.listings?.listingTypes } };
+    const counts = data?.surfaceCounts;
+    const flags = Object.fromEntries(ALL_LISTING_TYPES.map((t) => [t, isListingSurfaceVisible(t, settings, counts)]));
+    return {
+        ...flags,
+        isVisible: (type) => flags[type],
+        isSurfaceVisible: (surface) => isCountedSurfaceVisible(surface, counts),
+        /*
+         * ANY of the types, not every — matching the existing footer rule, whose
+         * comment states it: "/art stays reachable when stickers are off and art
+         * is on." A shared page is empty only when every type it spans is.
+         */
+        allowsTypes: (types) => !types || types.length === 0 || types.some((t) => flags[t]),
+    };
+}

package/dist/server.d.ts

@@ -662,3 +662,5 @@ export { AD_BOOKING_COLLECTION, AD_BOOKING_PAYMENT_STATES, AD_MODERATION_STATES,
 export type { AdBookingDocument, AdBookingCreative, AdBookingPaymentState, AdModerationState, AdPeriod, } from "./features/ads/schemas/firestore";
 export { getDashboardHubData } from "./_internal/server/features/dashboard/data";
 export type { DashboardHubData } from "./_internal/server/features/dashboard/data";
+export { getSurfaceCounts } from "./_internal/server/features/products/surface-counts";
+export type { PublicSurfaceCounts } from "./_internal/server/features/products/surface-counts";

package/dist/server.js

@@ -1872,3 +1872,15 @@ export { AD_BOOKING_COLLECTION, AD_BOOKING_PAYMENT_STATES, AD_MODERATION_STATES,
  * above reaches a consumer route.
  */
 export { getDashboardHubData } from "./_internal/server/features/dashboard/data.js";
+// Auto-hide: the measured "does this browse surface hold anything" document.
+// Server-only (firebase-admin via getAdminDb); the PREDICATE that reads it is
+// client-safe and lives in client.ts/index.ts beside the other visibility gates.
+export { getSurfaceCounts } from "./_internal/server/features/products/surface-counts.js";
+/*
+ * 🛑 `runSurfaceCountsRollup` / `computeSurfaceCounts` are deliberately NOT
+ * exported. They live under `_internal/server/jobs/core/` and their only
+ * caller is `countersReconcileHandler`, which imports them directly — so a
+ * barrel entry would leak an `_internal/` symbol for no consumer, which
+ * `audit-appkit-reexports` correctly blocks. Add one only if a consumer
+ * genuinely needs to trigger a rollup from outside appkit.
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "4.66.0",
+  "version": "4.68.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -23,6 +23,18 @@
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js"
     },
+    "./client/*": {
+      "types": "./dist/client/*.d.ts",
+      "import": "./dist/client/*.js"
+    },
+    "./hand-mode": {
+      "types": "./dist/hand-mode/index.d.ts",
+      "import": "./dist/hand-mode/index.js"
+    },
+    "./theme": {
+      "types": "./dist/theme/index.d.ts",
+      "import": "./dist/theme/index.js"
+    },
     "./next": {
       "types": "./dist/next/index.d.ts",
       "import": "./dist/next/index.js"
@@ -281,6 +293,26 @@
     "./views/tour-provider": {
       "types": "./dist/_internal/client/features/tour/TourProvider.d.ts",
       "import": "./dist/_internal/client/features/tour/TourProvider.js"
+    },
+    "./shipping/quote": {
+      "types": "./dist/_internal/shared/shipping/quote.d.ts",
+      "import": "./dist/_internal/shared/shipping/quote.js"
+    },
+    "./fees/calculator": {
+      "types": "./dist/_internal/shared/fees/calculator.d.ts",
+      "import": "./dist/_internal/shared/fees/calculator.js"
+    },
+    "./emi/choice": {
+      "types": "./dist/_internal/shared/features/emi/choice.d.ts",
+      "import": "./dist/_internal/shared/features/emi/choice.js"
+    },
+    "./layout/nav-portal": {
+      "types": "./dist/_internal/shared/features/layout/types.d.ts",
+      "import": "./dist/_internal/shared/features/layout/types.js"
+    },
+    "./views/digital-content-pool": {
+      "types": "./dist/_internal/client/features/digital-code/DigitalContentPoolManager.d.ts",
+      "import": "./dist/_internal/client/features/digital-code/DigitalContentPoolManager.js"
     }
   },
   "files": [