@mohasinac/appkit 4.70.0 → 4.71.2

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

@@ -175,6 +175,13 @@ export declare const ADMIN_ENDPOINTS: {
     readonly POINTS: "/api/admin/points";
     readonly MAINTENANCE_GATEWAY_EVENTS: "/api/admin/maintenance/gateway-events";
     readonly MAINTENANCE_OBLIGATIONS: "/api/admin/maintenance/obligations";
+    readonly MAINTENANCE_CACHE: "/api/admin/maintenance/cache";
+    /** Admin-facing assistant — Phase 2E-ii (overhaul brief). Distinct from `ASSISTANT_ENDPOINTS.ASK`, which is the buyer-scoped one. */
+    readonly ASSISTANT_ASK: "/api/admin/assistant/ask";
+    /** Admin-composable page regions — Phase 3B (overhaul brief), first slice. `pageId` is a stable, hand-chosen id, not route-derived. */
+    readonly PAGE_REGION_BY_ID: (pageId: string) => string;
+    /** Admin field-visibility override — Phase 3B. `surfaceId` is a stable, hand-chosen id identifying a form/display surface, same convention as `PAGE_REGION_BY_ID`. */
+    readonly FIELD_VISIBILITY_BY_ID: (surfaceId: string) => string;
     readonly SHIPMENTS: "/api/admin/shipments";
     readonly SHIPMENT_BY_ID: (id: string) => string;
     readonly SHIPMENT_LOTS: (id: string) => string;
@@ -196,16 +203,16 @@ export declare const ADMIN_ENDPOINTS: {
     readonly EVENT_BY_ID: (id: string) => string;
     readonly EVENT_STATUS: (id: string) => string;
     /**
-     * The ONLY sanctioned writer of `lotteryConfig`. The generic EVENT_BY_ID
+     * The ONLY sanctioned writer of `giveawayConfig`. The generic EVENT_BY_ID
      * PATCH rejects that field — it is `.passthrough()`, and letting a slot
      * array through it erased every already-pulled slot.
      */
-    readonly EVENT_LOTTERY_CONFIG: (id: string) => string;
+    readonly EVENT_GIVEAWAY_CONFIG: (id: string) => string;
     readonly EVENT_STATS: (id: string) => string;
     readonly EVENT_ENTRIES: (id: string) => string;
     readonly EVENT_ENTRIES_EXPORT: (id: string) => string;
     readonly EVENT_ENTRY_BY_ID: (eventId: string, entryId: string) => string;
-    readonly EVENT_TRIGGER_RAFFLE: (id: string) => string;
+    readonly EVENT_TRIGGER_GIVEAWAY: (id: string) => string;
     readonly COUPONS: "/api/admin/coupons";
     readonly COUPON_BY_ID: (id: string) => string;
     readonly SECTIONS: "/api/admin/sections";
@@ -228,11 +235,6 @@ export declare const ADMIN_ENDPOINTS: {
     readonly ADMIN_HISTORY: "/api/admin/history";
     readonly NEWSLETTER_EXPORT: "/api/admin/newsletter/export";
     readonly STORE_ADDRESSES: "/api/admin/store-addresses";
-    readonly CAROUSEL: "/api/admin/carousel";
-    readonly CAROUSEL_BY_ID: (id: string) => string;
-    readonly CAROUSEL_REORDER: "/api/admin/carousel/reorder";
-    readonly CAROUSELS: "/api/admin/carousels";
-    readonly CAROUSELS_BY_ID: (id: string) => string;
     readonly NAVIGATION: "/api/admin/navigation";
     readonly NAVIGATION_BY_ID: (id: string) => string;
     readonly ADMIN_SITE: "/api/admin/site";
@@ -267,8 +269,8 @@ export declare const ADMIN_ENDPOINTS: {
     readonly CACHE_REVALIDATE: "/api/admin/cache/revalidate";
     readonly MEDIA_LIST: "/api/admin/media";
 };
-export declare const AUCTION_ENDPOINTS: {
-    readonly LIST: "/api/auctions";
+export declare const COLLECTOR_DROP_ENDPOINTS: {
+    readonly LIST: "/api/collector-drops";
     readonly BY_SLUG: (slug: string) => string;
     readonly BIDS: (slug: string) => string;
 };
@@ -396,10 +398,18 @@ export declare const CHECKOUT_ENDPOINTS: {
     readonly PREFLIGHT: "/api/checkout/preflight";
     readonly PLACE_ORDER: "/api/checkout";
     readonly PRICING_PREVIEW: "/api/checkout/pricing-preview";
+    /**
+     * Item 1.39 — the buyer-policy clause set + hash for the current cart. The
+     * client renders what this returns and echoes its `version`/`hash` back when
+     * placing the order; it never derives either for itself.
+     */
+    readonly POLICY: "/api/checkout/policy";
 };
 export declare const PAYMENT_ENDPOINTS: {
     readonly CREATE_ORDER: "/api/payment/create-order";
     readonly VERIFY: "/api/payment/verify";
+    /** Mints the RTDB event subscription token for the live payment-status signal. */
+    readonly EVENT_INIT: "/api/payment/event/init";
 };
 export declare const COLLECTION_ENDPOINTS: {
     readonly LIST: "/api/collections";
@@ -433,6 +443,9 @@ export declare const MESSAGE_ENDPOINTS: {
     readonly TOKEN: (conversationId: string) => string;
     readonly UNREAD_COUNT: "/api/messages/unread-count";
 };
+export declare const ASSISTANT_ENDPOINTS: {
+    readonly ASK: "/api/assistant/ask";
+};
 export declare const EVENT_ENDPOINTS: {
     readonly LIST: "/api/events";
     readonly BY_ID: (id: string) => string;
@@ -447,10 +460,10 @@ export declare const EVENT_ENDPOINTS: {
      */
     readonly LIKES: (id: string) => string;
     readonly LIKERS: (id: string, offset: number) => string;
-    readonly LOTTERY_PULL: (id: string) => string;
-    readonly LOTTERY_ENTRIES: (id: string) => string;
+    readonly GIVEAWAY_PULL: (id: string) => string;
+    readonly GIVEAWAY_ENTRIES: (id: string) => string;
 };
-export declare const LOTTERY_ENDPOINTS: {
+export declare const GIVEAWAY_ENDPOINTS: {
     readonly FLAG_ENTRY: (entryId: string) => string;
     readonly REOPEN_SLOT: (entryId: string) => string;
 };
@@ -493,8 +506,8 @@ export declare const PRODUCT_ENDPOINTS: {
     readonly LIST: "/api/products";
     readonly BY_SLUG: (slug: string) => string;
     readonly BY_ID: (id: string) => string;
-    readonly LOTTERY_PULL: (id: string) => string;
-    readonly LOTTERY_ENTRIES: (id: string) => string;
+    readonly GIVEAWAY_PULL: (id: string) => string;
+    readonly GIVEAWAY_ENTRIES: (id: string) => string;
     readonly SEARCH: (query: string, pageSize?: number) => string;
     /** @param ids — comma-separated product ids, e.g. for a compare-tray fetch */
     readonly BY_IDS: (ids: string) => string;
@@ -535,7 +548,7 @@ export declare const SELLER_ENDPOINTS: {
      */
     readonly ORDER_SHIP: (orderId: string) => string;
     readonly ORDER_OPEN_BALANCE: (orderId: string) => string;
-    readonly AUCTIONS: "/api/store/products";
+    readonly COLLECTOR_DROPS: "/api/store/products";
     readonly COUPONS: "/api/store/coupons";
     readonly COUPON_BY_ID: (id: string) => string;
     readonly OFFERS: "/api/store/offers";
@@ -547,6 +560,7 @@ export declare const SELLER_ENDPOINTS: {
     readonly REVIEW_CONTEST: (id: string) => string;
     readonly REVIEW_FEEDBACK: (id: string) => string;
     readonly SHIPPING: "/api/store/shipping";
+    readonly SHIPPING_OFFER: "/api/store/shipping-offer";
     readonly STORE: "/api/store/storefront";
     readonly STORE_ADDRESSES: "/api/store/addresses";
     readonly STORE_ADDRESS_BY_ID: (id: string) => string;
@@ -604,7 +618,7 @@ export declare const STORE_ENDPOINTS: {
     readonly LIST: "/api/stores";
     readonly BY_SLUG: (slug: string) => string;
     readonly PRODUCTS: (slug: string) => string;
-    readonly AUCTIONS: (slug: string) => string;
+    readonly COLLECTOR_DROPS: (slug: string) => string;
     readonly REVIEWS: (slug: string) => string;
 };
 export declare const WISHLIST_ENDPOINTS: {
@@ -810,6 +824,13 @@ export declare const API_ENDPOINTS: {
         readonly POINTS: "/api/admin/points";
         readonly MAINTENANCE_GATEWAY_EVENTS: "/api/admin/maintenance/gateway-events";
         readonly MAINTENANCE_OBLIGATIONS: "/api/admin/maintenance/obligations";
+        readonly MAINTENANCE_CACHE: "/api/admin/maintenance/cache";
+        /** Admin-facing assistant — Phase 2E-ii (overhaul brief). Distinct from `ASSISTANT_ENDPOINTS.ASK`, which is the buyer-scoped one. */
+        readonly ASSISTANT_ASK: "/api/admin/assistant/ask";
+        /** Admin-composable page regions — Phase 3B (overhaul brief), first slice. `pageId` is a stable, hand-chosen id, not route-derived. */
+        readonly PAGE_REGION_BY_ID: (pageId: string) => string;
+        /** Admin field-visibility override — Phase 3B. `surfaceId` is a stable, hand-chosen id identifying a form/display surface, same convention as `PAGE_REGION_BY_ID`. */
+        readonly FIELD_VISIBILITY_BY_ID: (surfaceId: string) => string;
         readonly SHIPMENTS: "/api/admin/shipments";
         readonly SHIPMENT_BY_ID: (id: string) => string;
         readonly SHIPMENT_LOTS: (id: string) => string;
@@ -831,16 +852,16 @@ export declare const API_ENDPOINTS: {
         readonly EVENT_BY_ID: (id: string) => string;
         readonly EVENT_STATUS: (id: string) => string;
         /**
-         * The ONLY sanctioned writer of `lotteryConfig`. The generic EVENT_BY_ID
+         * The ONLY sanctioned writer of `giveawayConfig`. The generic EVENT_BY_ID
          * PATCH rejects that field — it is `.passthrough()`, and letting a slot
          * array through it erased every already-pulled slot.
          */
-        readonly EVENT_LOTTERY_CONFIG: (id: string) => string;
+        readonly EVENT_GIVEAWAY_CONFIG: (id: string) => string;
         readonly EVENT_STATS: (id: string) => string;
         readonly EVENT_ENTRIES: (id: string) => string;
         readonly EVENT_ENTRIES_EXPORT: (id: string) => string;
         readonly EVENT_ENTRY_BY_ID: (eventId: string, entryId: string) => string;
-        readonly EVENT_TRIGGER_RAFFLE: (id: string) => string;
+        readonly EVENT_TRIGGER_GIVEAWAY: (id: string) => string;
         readonly COUPONS: "/api/admin/coupons";
         readonly COUPON_BY_ID: (id: string) => string;
         readonly SECTIONS: "/api/admin/sections";
@@ -863,11 +884,6 @@ export declare const API_ENDPOINTS: {
         readonly ADMIN_HISTORY: "/api/admin/history";
         readonly NEWSLETTER_EXPORT: "/api/admin/newsletter/export";
         readonly STORE_ADDRESSES: "/api/admin/store-addresses";
-        readonly CAROUSEL: "/api/admin/carousel";
-        readonly CAROUSEL_BY_ID: (id: string) => string;
-        readonly CAROUSEL_REORDER: "/api/admin/carousel/reorder";
-        readonly CAROUSELS: "/api/admin/carousels";
-        readonly CAROUSELS_BY_ID: (id: string) => string;
         readonly NAVIGATION: "/api/admin/navigation";
         readonly NAVIGATION_BY_ID: (id: string) => string;
         readonly ADMIN_SITE: "/api/admin/site";
@@ -902,8 +918,8 @@ export declare const API_ENDPOINTS: {
         readonly CACHE_REVALIDATE: "/api/admin/cache/revalidate";
         readonly MEDIA_LIST: "/api/admin/media";
     };
-    readonly AUCTIONS: {
-        readonly LIST: "/api/auctions";
+    readonly COLLECTOR_DROPS: {
+        readonly LIST: "/api/collector-drops";
         readonly BY_SLUG: (slug: string) => string;
         readonly BIDS: (slug: string) => string;
     };
@@ -978,10 +994,18 @@ export declare const API_ENDPOINTS: {
         readonly PREFLIGHT: "/api/checkout/preflight";
         readonly PLACE_ORDER: "/api/checkout";
         readonly PRICING_PREVIEW: "/api/checkout/pricing-preview";
+        /**
+         * Item 1.39 — the buyer-policy clause set + hash for the current cart. The
+         * client renders what this returns and echoes its `version`/`hash` back when
+         * placing the order; it never derives either for itself.
+         */
+        readonly POLICY: "/api/checkout/policy";
     };
     readonly PAYMENT: {
         readonly CREATE_ORDER: "/api/payment/create-order";
         readonly VERIFY: "/api/payment/verify";
+        /** Mints the RTDB event subscription token for the live payment-status signal. */
+        readonly EVENT_INIT: "/api/payment/event/init";
     };
     readonly COLLECTIONS: {
         readonly LIST: "/api/collections";
@@ -1015,6 +1039,9 @@ export declare const API_ENDPOINTS: {
         readonly TOKEN: (conversationId: string) => string;
         readonly UNREAD_COUNT: "/api/messages/unread-count";
     };
+    readonly ASSISTANT: {
+        readonly ASK: "/api/assistant/ask";
+    };
     readonly EVENTS: {
         readonly LIST: "/api/events";
         readonly BY_ID: (id: string) => string;
@@ -1029,10 +1056,10 @@ export declare const API_ENDPOINTS: {
          */
         readonly LIKES: (id: string) => string;
         readonly LIKERS: (id: string, offset: number) => string;
-        readonly LOTTERY_PULL: (id: string) => string;
-        readonly LOTTERY_ENTRIES: (id: string) => string;
+        readonly GIVEAWAY_PULL: (id: string) => string;
+        readonly GIVEAWAY_ENTRIES: (id: string) => string;
     };
-    readonly LOTTERY: {
+    readonly GIVEAWAY: {
         readonly FLAG_ENTRY: (entryId: string) => string;
         readonly REOPEN_SLOT: (entryId: string) => string;
     };
@@ -1075,8 +1102,8 @@ export declare const API_ENDPOINTS: {
         readonly LIST: "/api/products";
         readonly BY_SLUG: (slug: string) => string;
         readonly BY_ID: (id: string) => string;
-        readonly LOTTERY_PULL: (id: string) => string;
-        readonly LOTTERY_ENTRIES: (id: string) => string;
+        readonly GIVEAWAY_PULL: (id: string) => string;
+        readonly GIVEAWAY_ENTRIES: (id: string) => string;
         readonly SEARCH: (query: string, pageSize?: number) => string;
         /** @param ids — comma-separated product ids, e.g. for a compare-tray fetch */
         readonly BY_IDS: (ids: string) => string;
@@ -1114,7 +1141,7 @@ export declare const API_ENDPOINTS: {
          */
         readonly ORDER_SHIP: (orderId: string) => string;
         readonly ORDER_OPEN_BALANCE: (orderId: string) => string;
-        readonly AUCTIONS: "/api/store/products";
+        readonly COLLECTOR_DROPS: "/api/store/products";
         readonly COUPONS: "/api/store/coupons";
         readonly COUPON_BY_ID: (id: string) => string;
         readonly OFFERS: "/api/store/offers";
@@ -1126,6 +1153,7 @@ export declare const API_ENDPOINTS: {
         readonly REVIEW_CONTEST: (id: string) => string;
         readonly REVIEW_FEEDBACK: (id: string) => string;
         readonly SHIPPING: "/api/store/shipping";
+        readonly SHIPPING_OFFER: "/api/store/shipping-offer";
         readonly STORE: "/api/store/storefront";
         readonly STORE_ADDRESSES: "/api/store/addresses";
         readonly STORE_ADDRESS_BY_ID: (id: string) => string;
@@ -1183,7 +1211,7 @@ export declare const API_ENDPOINTS: {
         readonly LIST: "/api/stores";
         readonly BY_SLUG: (slug: string) => string;
         readonly PRODUCTS: (slug: string) => string;
-        readonly AUCTIONS: (slug: string) => string;
+        readonly COLLECTOR_DROPS: (slug: string) => string;
         readonly REVIEWS: (slug: string) => string;
     };
     readonly SUBLISTING_CATEGORIES: {
@@ -1410,6 +1438,13 @@ export declare const API_ROUTES: {
         readonly POINTS: "/api/admin/points";
         readonly MAINTENANCE_GATEWAY_EVENTS: "/api/admin/maintenance/gateway-events";
         readonly MAINTENANCE_OBLIGATIONS: "/api/admin/maintenance/obligations";
+        readonly MAINTENANCE_CACHE: "/api/admin/maintenance/cache";
+        /** Admin-facing assistant — Phase 2E-ii (overhaul brief). Distinct from `ASSISTANT_ENDPOINTS.ASK`, which is the buyer-scoped one. */
+        readonly ASSISTANT_ASK: "/api/admin/assistant/ask";
+        /** Admin-composable page regions — Phase 3B (overhaul brief), first slice. `pageId` is a stable, hand-chosen id, not route-derived. */
+        readonly PAGE_REGION_BY_ID: (pageId: string) => string;
+        /** Admin field-visibility override — Phase 3B. `surfaceId` is a stable, hand-chosen id identifying a form/display surface, same convention as `PAGE_REGION_BY_ID`. */
+        readonly FIELD_VISIBILITY_BY_ID: (surfaceId: string) => string;
         readonly SHIPMENTS: "/api/admin/shipments";
         readonly SHIPMENT_BY_ID: (id: string) => string;
         readonly SHIPMENT_LOTS: (id: string) => string;
@@ -1431,16 +1466,16 @@ export declare const API_ROUTES: {
         readonly EVENT_BY_ID: (id: string) => string;
         readonly EVENT_STATUS: (id: string) => string;
         /**
-         * The ONLY sanctioned writer of `lotteryConfig`. The generic EVENT_BY_ID
+         * The ONLY sanctioned writer of `giveawayConfig`. The generic EVENT_BY_ID
          * PATCH rejects that field — it is `.passthrough()`, and letting a slot
          * array through it erased every already-pulled slot.
          */
-        readonly EVENT_LOTTERY_CONFIG: (id: string) => string;
+        readonly EVENT_GIVEAWAY_CONFIG: (id: string) => string;
         readonly EVENT_STATS: (id: string) => string;
         readonly EVENT_ENTRIES: (id: string) => string;
         readonly EVENT_ENTRIES_EXPORT: (id: string) => string;
         readonly EVENT_ENTRY_BY_ID: (eventId: string, entryId: string) => string;
-        readonly EVENT_TRIGGER_RAFFLE: (id: string) => string;
+        readonly EVENT_TRIGGER_GIVEAWAY: (id: string) => string;
         readonly COUPONS: "/api/admin/coupons";
         readonly COUPON_BY_ID: (id: string) => string;
         readonly SECTIONS: "/api/admin/sections";
@@ -1463,11 +1498,6 @@ export declare const API_ROUTES: {
         readonly ADMIN_HISTORY: "/api/admin/history";
         readonly NEWSLETTER_EXPORT: "/api/admin/newsletter/export";
         readonly STORE_ADDRESSES: "/api/admin/store-addresses";
-        readonly CAROUSEL: "/api/admin/carousel";
-        readonly CAROUSEL_BY_ID: (id: string) => string;
-        readonly CAROUSEL_REORDER: "/api/admin/carousel/reorder";
-        readonly CAROUSELS: "/api/admin/carousels";
-        readonly CAROUSELS_BY_ID: (id: string) => string;
         readonly NAVIGATION: "/api/admin/navigation";
         readonly NAVIGATION_BY_ID: (id: string) => string;
         readonly ADMIN_SITE: "/api/admin/site";
@@ -1502,8 +1532,8 @@ export declare const API_ROUTES: {
         readonly CACHE_REVALIDATE: "/api/admin/cache/revalidate";
         readonly MEDIA_LIST: "/api/admin/media";
     };
-    readonly AUCTIONS: {
-        readonly LIST: "/api/auctions";
+    readonly COLLECTOR_DROPS: {
+        readonly LIST: "/api/collector-drops";
         readonly BY_SLUG: (slug: string) => string;
         readonly BIDS: (slug: string) => string;
     };
@@ -1578,10 +1608,18 @@ export declare const API_ROUTES: {
         readonly PREFLIGHT: "/api/checkout/preflight";
         readonly PLACE_ORDER: "/api/checkout";
         readonly PRICING_PREVIEW: "/api/checkout/pricing-preview";
+        /**
+         * Item 1.39 — the buyer-policy clause set + hash for the current cart. The
+         * client renders what this returns and echoes its `version`/`hash` back when
+         * placing the order; it never derives either for itself.
+         */
+        readonly POLICY: "/api/checkout/policy";
     };
     readonly PAYMENT: {
         readonly CREATE_ORDER: "/api/payment/create-order";
         readonly VERIFY: "/api/payment/verify";
+        /** Mints the RTDB event subscription token for the live payment-status signal. */
+        readonly EVENT_INIT: "/api/payment/event/init";
     };
     readonly COLLECTIONS: {
         readonly LIST: "/api/collections";
@@ -1615,6 +1653,9 @@ export declare const API_ROUTES: {
         readonly TOKEN: (conversationId: string) => string;
         readonly UNREAD_COUNT: "/api/messages/unread-count";
     };
+    readonly ASSISTANT: {
+        readonly ASK: "/api/assistant/ask";
+    };
     readonly EVENTS: {
         readonly LIST: "/api/events";
         readonly BY_ID: (id: string) => string;
@@ -1629,10 +1670,10 @@ export declare const API_ROUTES: {
          */
         readonly LIKES: (id: string) => string;
         readonly LIKERS: (id: string, offset: number) => string;
-        readonly LOTTERY_PULL: (id: string) => string;
-        readonly LOTTERY_ENTRIES: (id: string) => string;
+        readonly GIVEAWAY_PULL: (id: string) => string;
+        readonly GIVEAWAY_ENTRIES: (id: string) => string;
     };
-    readonly LOTTERY: {
+    readonly GIVEAWAY: {
         readonly FLAG_ENTRY: (entryId: string) => string;
         readonly REOPEN_SLOT: (entryId: string) => string;
     };
@@ -1675,8 +1716,8 @@ export declare const API_ROUTES: {
         readonly LIST: "/api/products";
         readonly BY_SLUG: (slug: string) => string;
         readonly BY_ID: (id: string) => string;
-        readonly LOTTERY_PULL: (id: string) => string;
-        readonly LOTTERY_ENTRIES: (id: string) => string;
+        readonly GIVEAWAY_PULL: (id: string) => string;
+        readonly GIVEAWAY_ENTRIES: (id: string) => string;
         readonly SEARCH: (query: string, pageSize?: number) => string;
         /** @param ids — comma-separated product ids, e.g. for a compare-tray fetch */
         readonly BY_IDS: (ids: string) => string;
@@ -1714,7 +1755,7 @@ export declare const API_ROUTES: {
          */
         readonly ORDER_SHIP: (orderId: string) => string;
         readonly ORDER_OPEN_BALANCE: (orderId: string) => string;
-        readonly AUCTIONS: "/api/store/products";
+        readonly COLLECTOR_DROPS: "/api/store/products";
         readonly COUPONS: "/api/store/coupons";
         readonly COUPON_BY_ID: (id: string) => string;
         readonly OFFERS: "/api/store/offers";
@@ -1726,6 +1767,7 @@ export declare const API_ROUTES: {
         readonly REVIEW_CONTEST: (id: string) => string;
         readonly REVIEW_FEEDBACK: (id: string) => string;
         readonly SHIPPING: "/api/store/shipping";
+        readonly SHIPPING_OFFER: "/api/store/shipping-offer";
         readonly STORE: "/api/store/storefront";
         readonly STORE_ADDRESSES: "/api/store/addresses";
         readonly STORE_ADDRESS_BY_ID: (id: string) => string;
@@ -1783,7 +1825,7 @@ export declare const API_ROUTES: {
         readonly LIST: "/api/stores";
         readonly BY_SLUG: (slug: string) => string;
         readonly PRODUCTS: (slug: string) => string;
-        readonly AUCTIONS: (slug: string) => string;
+        readonly COLLECTOR_DROPS: (slug: string) => string;
         readonly REVIEWS: (slug: string) => string;
     };
     readonly SUBLISTING_CATEGORIES: {

package/dist/constants/api-endpoints.js

@@ -222,6 +222,13 @@ export const ADMIN_ENDPOINTS = {
     POINTS: "/api/admin/points",
     MAINTENANCE_GATEWAY_EVENTS: "/api/admin/maintenance/gateway-events",
     MAINTENANCE_OBLIGATIONS: "/api/admin/maintenance/obligations",
+    MAINTENANCE_CACHE: "/api/admin/maintenance/cache",
+    /** Admin-facing assistant — Phase 2E-ii (overhaul brief). Distinct from `ASSISTANT_ENDPOINTS.ASK`, which is the buyer-scoped one. */
+    ASSISTANT_ASK: "/api/admin/assistant/ask",
+    /** Admin-composable page regions — Phase 3B (overhaul brief), first slice. `pageId` is a stable, hand-chosen id, not route-derived. */
+    PAGE_REGION_BY_ID: (pageId) => `/api/admin/page-regions/${pageId}`,
+    /** Admin field-visibility override — Phase 3B. `surfaceId` is a stable, hand-chosen id identifying a form/display surface, same convention as `PAGE_REGION_BY_ID`. */
+    FIELD_VISIBILITY_BY_ID: (surfaceId) => `/api/admin/field-visibility/${surfaceId}`,
     SHIPMENTS: "/api/admin/shipments",
     SHIPMENT_BY_ID: (id) => `/api/admin/shipments/${id}`,
     SHIPMENT_LOTS: (id) => `/api/admin/shipments/${id}/lots`,
@@ -244,17 +251,21 @@ export const ADMIN_ENDPOINTS = {
     EVENT_BY_ID: (id) => `/api/admin/events/${id}`,
     EVENT_STATUS: (id) => `/api/admin/events/${id}/status`,
     /**
-     * The ONLY sanctioned writer of `lotteryConfig`. The generic EVENT_BY_ID
+     * The ONLY sanctioned writer of `giveawayConfig`. The generic EVENT_BY_ID
      * PATCH rejects that field — it is `.passthrough()`, and letting a slot
      * array through it erased every already-pulled slot.
      */
-    EVENT_LOTTERY_CONFIG: (id) => `/api/admin/events/${id}/lottery-config`,
+    EVENT_GIVEAWAY_CONFIG: (id) => `/api/admin/events/${id}/giveaway-config`,
     EVENT_STATS: (id) => `/api/admin/events/${id}/stats`,
     EVENT_ENTRIES: (id) => `/api/admin/events/${id}/entries`,
     EVENT_ENTRIES_EXPORT: (id) => `/api/admin/events/${id}/entries/export`,
     EVENT_ENTRY_BY_ID: (eventId, entryId) => `/api/admin/events/${eventId}/entries/${entryId}`,
     // SB9-D — admin manual raffle trigger
-    EVENT_TRIGGER_RAFFLE: (id) => `/api/admin/events/${id}/trigger-raffle`,
+    // Route segment renamed 2026-10-31 with the `giveaway` EventType. There is
+    // deliberately no alias for the old path: it is an admin-only POST with one
+    // caller (`AdminEventEditorView`), both shipped together, so nothing
+    // external can be holding the old URL.
+    EVENT_TRIGGER_GIVEAWAY: (id) => `/api/admin/events/${id}/trigger-giveaway`,
     COUPONS: "/api/admin/coupons",
     COUPON_BY_ID: (id) => `/api/admin/coupons/${id}`,
     SECTIONS: "/api/admin/sections",
@@ -277,11 +288,6 @@ export const ADMIN_ENDPOINTS = {
     ADMIN_HISTORY: "/api/admin/history",
     NEWSLETTER_EXPORT: "/api/admin/newsletter/export",
     STORE_ADDRESSES: "/api/admin/store-addresses",
-    CAROUSEL: "/api/admin/carousel",
-    CAROUSEL_BY_ID: (id) => `/api/admin/carousel/${id}`,
-    CAROUSEL_REORDER: "/api/admin/carousel/reorder",
-    CAROUSELS: "/api/admin/carousels",
-    CAROUSELS_BY_ID: (id) => `/api/admin/carousels/${id}`,
     NAVIGATION: "/api/admin/navigation",
     NAVIGATION_BY_ID: (id) => `/api/admin/navigation/${id}`,
     ADMIN_SITE: "/api/admin/site",
@@ -327,12 +333,12 @@ export const ADMIN_ENDPOINTS = {
     MEDIA_LIST: "/api/admin/media",
 };
 // ---------------------------------------------------------------------------
-// Auctions
+// Collector Drops
 // ---------------------------------------------------------------------------
-export const AUCTION_ENDPOINTS = {
-    LIST: "/api/auctions",
-    BY_SLUG: (slug) => `/api/auctions/${slug}`,
-    BIDS: (slug) => `/api/auctions/${slug}/bids`,
+export const COLLECTOR_DROP_ENDPOINTS = {
+    LIST: "/api/collector-drops",
+    BY_SLUG: (slug) => `/api/collector-drops/${slug}`,
+    BIDS: (slug) => `/api/collector-drops/${slug}/bids`,
 };
 // ---------------------------------------------------------------------------
 // Bids
@@ -474,6 +480,12 @@ export const CHECKOUT_ENDPOINTS = {
     PREFLIGHT: "/api/checkout/preflight",
     PLACE_ORDER: "/api/checkout",
     PRICING_PREVIEW: "/api/checkout/pricing-preview",
+    /**
+     * Item 1.39 — the buyer-policy clause set + hash for the current cart. The
+     * client renders what this returns and echoes its `version`/`hash` back when
+     * placing the order; it never derives either for itself.
+     */
+    POLICY: "/api/checkout/policy",
 };
 // ---------------------------------------------------------------------------
 // Payment
@@ -481,6 +493,8 @@ export const CHECKOUT_ENDPOINTS = {
 export const PAYMENT_ENDPOINTS = {
     CREATE_ORDER: "/api/payment/create-order",
     VERIFY: "/api/payment/verify",
+    /** Mints the RTDB event subscription token for the live payment-status signal. */
+    EVENT_INIT: "/api/payment/event/init",
 };
 // ---------------------------------------------------------------------------
 // Collections
@@ -543,6 +557,12 @@ export const MESSAGE_ENDPOINTS = {
     UNREAD_COUNT: "/api/messages/unread-count",
 };
 // ---------------------------------------------------------------------------
+// Assistant — the customer-assistant floating widget / full-chat page
+// ---------------------------------------------------------------------------
+export const ASSISTANT_ENDPOINTS = {
+    ASK: "/api/assistant/ask",
+};
+// ---------------------------------------------------------------------------
 // Events
 // ---------------------------------------------------------------------------
 export const EVENT_ENDPOINTS = {
@@ -560,16 +580,16 @@ export const EVENT_ENDPOINTS = {
      */
     LIKES: (id) => `/api/events/${id}/likes`,
     LIKERS: (id, offset) => `/api/events/${id}/likes?offset=${offset}`,
-    // Lottery: user self-pull (draw happens immediately on submit)
-    LOTTERY_PULL: (id) => `/api/events/${id}/lottery-pull`,
-    LOTTERY_ENTRIES: (id) => `/api/events/${id}/lottery-entries`,
+    // Giveaway: user self-pull (draw happens immediately on submit)
+    GIVEAWAY_PULL: (id) => `/api/events/${id}/giveaway-pull`,
+    GIVEAWAY_ENTRIES: (id) => `/api/events/${id}/giveaway-entries`,
 };
 // ---------------------------------------------------------------------------
-// Lottery
+// Giveaway
 // ---------------------------------------------------------------------------
-export const LOTTERY_ENDPOINTS = {
-    FLAG_ENTRY: (entryId) => `/api/lottery-entries/${entryId}/flag`,
-    REOPEN_SLOT: (entryId) => `/api/lottery-entries/${entryId}/reopen-slot`,
+export const GIVEAWAY_ENDPOINTS = {
+    FLAG_ENTRY: (entryId) => `/api/giveaway-entries/${entryId}/flag`,
+    REOPEN_SLOT: (entryId) => `/api/giveaway-entries/${entryId}/reopen-slot`,
 };
 // ---------------------------------------------------------------------------
 // FAQ
@@ -648,9 +668,9 @@ export const PRODUCT_ENDPOINTS = {
     LIST: "/api/products",
     BY_SLUG: (slug) => `/api/products/${slug}`,
     BY_ID: (id) => `/api/products/${id}`,
-    // Lottery: user self-pull for prize-draw products in lottery mode
-    LOTTERY_PULL: (id) => `/api/products/${id}/lottery-pull`,
-    LOTTERY_ENTRIES: (id) => `/api/products/${id}/lottery-entries`,
+    // Giveaway: user self-pull for prize-draw products in giveaway mode
+    GIVEAWAY_PULL: (id) => `/api/products/${id}/giveaway-pull`,
+    GIVEAWAY_ENTRIES: (id) => `/api/products/${id}/giveaway-entries`,
     SEARCH: (query, pageSize = 20) => `/api/products?q=${encodeURIComponent(query)}&pageSize=${pageSize}`,
     /** @param ids — comma-separated product ids, e.g. for a compare-tray fetch */
     BY_IDS: (ids) => `/api/products?ids=${encodeURIComponent(ids)}`,
@@ -658,7 +678,7 @@ export const PRODUCT_ENDPOINTS = {
 };
 // ---------------------------------------------------------------------------
 // Prize Draws — no client-callable endpoints. Reveal is fully automatic
-// (assignPrizeDrawWinner, triggered by payment confirmation / sellout /
+// (assignClearanceWinner, triggered by payment confirmation / sellout /
 // expiry) — there is no buyer-facing reveal action to call anymore.
 // ---------------------------------------------------------------------------
 // ---------------------------------------------------------------------------
@@ -717,7 +737,7 @@ export const SELLER_ENDPOINTS = {
      * arrived, and the buyer's 7-day window runs from that moment.
      */
     ORDER_OPEN_BALANCE: (orderId) => `/api/store/orders/${orderId}/open-balance`,
-    AUCTIONS: "/api/store/products",
+    COLLECTOR_DROPS: "/api/store/products",
     COUPONS: "/api/store/coupons",
     COUPON_BY_ID: (id) => `/api/store/coupons/${id}`,
     OFFERS: "/api/store/offers",
@@ -729,6 +749,10 @@ export const SELLER_ENDPOINTS = {
     REVIEW_CONTEST: (id) => `/api/store/reviews/${id}/contest`,
     REVIEW_FEEDBACK: (id) => `/api/store/reviews/${id}/feedback`,
     SHIPPING: "/api/store/shipping",
+    /* The seller's two-axis shipping OFFER — writes `StoreDocument.shippingPricing`,
+     * which is the field the checkout money path reads. `SHIPPING` above writes
+     * the legacy flat number on the seller profile. */
+    SHIPPING_OFFER: "/api/store/shipping-offer",
     STORE: "/api/store/storefront",
     STORE_ADDRESSES: "/api/store/addresses",
     STORE_ADDRESS_BY_ID: (id) => `/api/store/addresses/${id}`,
@@ -795,7 +819,7 @@ export const STORE_ENDPOINTS = {
     LIST: "/api/stores",
     BY_SLUG: (slug) => `/api/stores/${slug}`,
     PRODUCTS: (slug) => `/api/stores/${slug}/products`,
-    AUCTIONS: (slug) => `/api/stores/${slug}/auctions`,
+    COLLECTOR_DROPS: (slug) => `/api/stores/${slug}/collector-drops`,
     REVIEWS: (slug) => `/api/stores/${slug}/reviews`,
 };
 // ---------------------------------------------------------------------------
@@ -867,7 +891,7 @@ export const API_ENDPOINTS = {
     NOTIFICATIONS: NOTIFICATIONS_ENDPOINTS,
     SITE_SETTINGS: SITE_SETTINGS_ENDPOINTS,
     ADMIN: ADMIN_ENDPOINTS,
-    AUCTIONS: AUCTION_ENDPOINTS,
+    COLLECTOR_DROPS: COLLECTOR_DROP_ENDPOINTS,
     BIDS: BID_ENDPOINTS,
     CART: CART_ENDPOINTS,
     CATEGORIES: CATEGORY_ENDPOINTS,
@@ -880,8 +904,9 @@ export const API_ENDPOINTS = {
     CONTACT: CONTACT_ENDPOINTS,
     ADS: AD_ENDPOINTS,
     MESSAGES: MESSAGE_ENDPOINTS,
+    ASSISTANT: ASSISTANT_ENDPOINTS,
     EVENTS: EVENT_ENDPOINTS,
-    LOTTERY: LOTTERY_ENDPOINTS,
+    GIVEAWAY: GIVEAWAY_ENDPOINTS,
     FAQS: FAQ_ENDPOINTS,
     HOMEPAGE: HOMEPAGE_ENDPOINTS,
     ANALYTICS: ANALYTICS_ENDPOINTS,