@mohasinac/appkit 4.30.19 → 4.31.0

package/dist/features/admin/constants/site-settings-tabs.d.ts

@@ -0,0 +1,120 @@
+export interface SiteSettingsTab {
+    id: string;
+    /** The label on the tab, numbering included — it is a long strip. */
+    label: string;
+    /** What lives in here, for anyone who does not know the tab's name. */
+    description: string;
+    keywords: string[];
+}
+export declare const SITE_SETTINGS_TABS: readonly [{
+    readonly id: "about";
+    readonly label: "⓪ About";
+    readonly description: "The About page: hero, mission, values, milestones and the team.";
+    readonly keywords: ["about us", "team", "mission", "our story", "milestones"];
+}, {
+    readonly id: "branding";
+    readonly label: "① Branding";
+    readonly description: "Site name, tagline, logo and favicon.";
+    readonly keywords: ["logo", "favicon", "site name", "tagline", "brand"];
+}, {
+    readonly id: "appearance";
+    readonly label: "② Appearance";
+    readonly description: "Colours, backgrounds and the default light or dark mode.";
+    readonly keywords: ["colours", "colors", "background", "dark mode", "look"];
+}, {
+    readonly id: "themes";
+    readonly label: "②ᵃ Themes";
+    readonly description: "Create and edit colour themes, and pick the default for each mode.";
+    readonly keywords: ["theme", "palette", "colours", "dark theme", "light theme"];
+}, {
+    readonly id: "announcement";
+    readonly label: "③ Announcement";
+    readonly description: "The banner across the top of every page.";
+    readonly keywords: ["banner", "notice", "message bar", "top bar"];
+}, {
+    readonly id: "seo";
+    readonly label: "④ SEO";
+    readonly description: "Default page titles, descriptions, and whether search engines may index the site.";
+    readonly keywords: ["google", "meta description", "noindex", "search engines", "sitemap"];
+}, {
+    readonly id: "contact";
+    readonly label: "⑤ Contact & Social";
+    readonly description: "Support email, phone, address and every social profile link.";
+    readonly keywords: ["email", "phone", "instagram", "whatsapp number", "social links"];
+}, {
+    readonly id: "watermark";
+    readonly label: "⑥ Watermark";
+    readonly description: "The mark stamped onto uploaded product photos.";
+    readonly keywords: ["logo on images", "photo watermark", "branding images"];
+}, {
+    readonly id: "fees";
+    readonly label: "⑦ Fees";
+    readonly description: "Platform commission, add-on charges, COD handling and the payout split.";
+    readonly keywords: ["commission", "charges", "cod fee", "gift wrap", "platform fee"];
+}, {
+    readonly id: "integrations";
+    readonly label: "⑧ Integrations";
+    readonly description: "Google Analytics, Facebook Pixel, Tag Manager and API credentials.";
+    readonly keywords: ["google analytics", "ga4", "facebook pixel", "gtm", "api keys", "tracking"];
+}, {
+    readonly id: "shipping";
+    readonly label: "⑨ Shipping";
+    readonly description: "Default delivery charges, free-shipping threshold and dispatch times.";
+    readonly keywords: ["delivery", "postage", "free shipping", "courier", "dispatch"];
+}, {
+    readonly id: "auction";
+    readonly label: "⑩ Auction";
+    readonly description: "Bid increments, anti-sniping extension and reserve-price rules.";
+    readonly keywords: ["bidding", "increment", "sniping", "reserve price", "extension"];
+}, {
+    readonly id: "limits";
+    readonly label: "⑪ Limits";
+    readonly description: "Upload sizes, listing counts and per-account caps.";
+    readonly keywords: ["maximum", "upload size", "cap", "quota", "how many"];
+}, {
+    readonly id: "legal";
+    readonly label: "⑫ Legal";
+    readonly description: "Terms, privacy policy, refund policy and the GST registration details.";
+    readonly keywords: ["terms", "privacy", "policy", "gstin", "refund policy", "compliance"];
+}, {
+    readonly id: "whatsapp";
+    readonly label: "⑬ WhatsApp";
+    readonly description: "WhatsApp Business credentials and which messages go out over it.";
+    readonly keywords: ["whatsapp", "meta", "business api", "order updates"];
+}, {
+    readonly id: "notifications";
+    readonly label: "⑭ Notifications";
+    readonly description: "Which channels are on — email, WhatsApp, SMS — and the daily digest.";
+    readonly keywords: ["email", "sms", "alerts", "digest", "notify"];
+}, {
+    readonly id: "procurement";
+    readonly label: "⑮ Procurement";
+    readonly description: "Labour rate and the defaults used to price inbound shipments.";
+    readonly keywords: ["labour rate", "labor", "import", "landed cost", "supplier"];
+}, {
+    readonly id: "emi";
+    readonly label: "⑯ EMI";
+    readonly description: "Instalment plans: eligibility threshold, tenures and the surcharge split.";
+    readonly keywords: ["instalments", "installments", "emi", "pay monthly", "finance"];
+}, {
+    readonly id: "gst";
+    readonly label: "⑰ GST";
+    readonly description: "GST rates, HSN defaults and the registered business details.";
+    readonly keywords: ["tax", "gst", "hsn", "vat", "invoice tax"];
+}, {
+    readonly id: "listings";
+    readonly label: "⑱ Listings";
+    readonly description: "Which listing types sellers may create, and their defaults.";
+    readonly keywords: ["listing types", "auctions on", "enable", "categories"];
+}];
+export declare const SITE_SETTINGS_TAB_IDS: ("about" | "shipping" | "whatsapp" | "notifications" | "contact" | "auction" | "seo" | "listings" | "appearance" | "emi" | "gst" | "watermark" | "integrations" | "limits" | "announcement" | "branding" | "themes" | "fees" | "legal" | "procurement")[];
+/**
+ * The union `?tab=` is validated against.
+ *
+ * W7's `AIX_DEAD_DEEPLINK` check needs exactly this: a deep link naming a tab
+ * that does not exist opens the settings page on its default tab and looks
+ * like the search simply missed.
+ */
+export type SiteSettingsTabId = (typeof SITE_SETTINGS_TABS)[number]["id"];
+/** Whether a `?tab=` value names a real tab. */
+export declare function isSiteSettingsTabId(value: string | null | undefined): value is SiteSettingsTabId;

package/dist/features/admin/constants/site-settings-tabs.js

@@ -0,0 +1,152 @@
+/*
+ * WHY: The 19 site-settings tabs were a `[value, label]` array literal written
+ *      inline in the middle of an 1800-line component's JSX. Nothing else could
+ *      read them, so `?tab=` deep links had no union to be validated against —
+ *      and the view did not accept `?tab=` at all, which is why "search for
+ *      maintenance and land on the maintenance toggle" had nowhere to land.
+ * WHAT: The tab union, and the metadata that lets each tab be found by what it
+ *       CONTAINS rather than by its own name.
+ *
+ * ## Why the descriptions matter more here than in the sidebar
+ *
+ * A settings tab is the one place where the label is reliably NOT what someone
+ * searches for. Nobody looks for "Integrations"; they look for "Google
+ * Analytics". Nobody looks for "Limits"; they look for "maximum upload size".
+ * The tab name is an filing decision, and the search has to survive it.
+ *
+ * EXPORTS: SITE_SETTINGS_TABS, SITE_SETTINGS_TAB_IDS, type SiteSettingsTabId
+ *
+ * @tag domain:admin
+ * @tag layer:constants
+ * @tag pattern:registry
+ * @tag access:isomorphic
+ * @tag consumers:AdminSiteSettingsView,action index
+ * @tag sideEffects:none
+ */
+export const SITE_SETTINGS_TABS = [
+    {
+        id: "about",
+        label: "⓪ About",
+        description: "The About page: hero, mission, values, milestones and the team.",
+        keywords: ["about us", "team", "mission", "our story", "milestones"],
+    },
+    {
+        id: "branding",
+        label: "① Branding",
+        description: "Site name, tagline, logo and favicon.",
+        keywords: ["logo", "favicon", "site name", "tagline", "brand"],
+    },
+    {
+        id: "appearance",
+        label: "② Appearance",
+        description: "Colours, backgrounds and the default light or dark mode.",
+        keywords: ["colours", "colors", "background", "dark mode", "look"],
+    },
+    {
+        id: "themes",
+        label: "②ᵃ Themes",
+        description: "Create and edit colour themes, and pick the default for each mode.",
+        keywords: ["theme", "palette", "colours", "dark theme", "light theme"],
+    },
+    {
+        id: "announcement",
+        label: "③ Announcement",
+        description: "The banner across the top of every page.",
+        keywords: ["banner", "notice", "message bar", "top bar"],
+    },
+    {
+        id: "seo",
+        label: "④ SEO",
+        description: "Default page titles, descriptions, and whether search engines may index the site.",
+        keywords: ["google", "meta description", "noindex", "search engines", "sitemap"],
+    },
+    {
+        id: "contact",
+        label: "⑤ Contact & Social",
+        description: "Support email, phone, address and every social profile link.",
+        keywords: ["email", "phone", "instagram", "whatsapp number", "social links"],
+    },
+    {
+        id: "watermark",
+        label: "⑥ Watermark",
+        description: "The mark stamped onto uploaded product photos.",
+        keywords: ["logo on images", "photo watermark", "branding images"],
+    },
+    {
+        id: "fees",
+        label: "⑦ Fees",
+        description: "Platform commission, add-on charges, COD handling and the payout split.",
+        keywords: ["commission", "charges", "cod fee", "gift wrap", "platform fee"],
+    },
+    {
+        id: "integrations",
+        label: "⑧ Integrations",
+        description: "Google Analytics, Facebook Pixel, Tag Manager and API credentials.",
+        keywords: ["google analytics", "ga4", "facebook pixel", "gtm", "api keys", "tracking"],
+    },
+    {
+        id: "shipping",
+        label: "⑨ Shipping",
+        description: "Default delivery charges, free-shipping threshold and dispatch times.",
+        keywords: ["delivery", "postage", "free shipping", "courier", "dispatch"],
+    },
+    {
+        id: "auction",
+        label: "⑩ Auction",
+        description: "Bid increments, anti-sniping extension and reserve-price rules.",
+        keywords: ["bidding", "increment", "sniping", "reserve price", "extension"],
+    },
+    {
+        id: "limits",
+        label: "⑪ Limits",
+        description: "Upload sizes, listing counts and per-account caps.",
+        keywords: ["maximum", "upload size", "cap", "quota", "how many"],
+    },
+    {
+        id: "legal",
+        label: "⑫ Legal",
+        description: "Terms, privacy policy, refund policy and the GST registration details.",
+        keywords: ["terms", "privacy", "policy", "gstin", "refund policy", "compliance"],
+    },
+    {
+        id: "whatsapp",
+        label: "⑬ WhatsApp",
+        description: "WhatsApp Business credentials and which messages go out over it.",
+        keywords: ["whatsapp", "meta", "business api", "order updates"],
+    },
+    {
+        id: "notifications",
+        label: "⑭ Notifications",
+        description: "Which channels are on — email, WhatsApp, SMS — and the daily digest.",
+        keywords: ["email", "sms", "alerts", "digest", "notify"],
+    },
+    {
+        id: "procurement",
+        label: "⑮ Procurement",
+        description: "Labour rate and the defaults used to price inbound shipments.",
+        keywords: ["labour rate", "labor", "import", "landed cost", "supplier"],
+    },
+    {
+        id: "emi",
+        label: "⑯ EMI",
+        description: "Instalment plans: eligibility threshold, tenures and the surcharge split.",
+        keywords: ["instalments", "installments", "emi", "pay monthly", "finance"],
+    },
+    {
+        id: "gst",
+        label: "⑰ GST",
+        description: "GST rates, HSN defaults and the registered business details.",
+        keywords: ["tax", "gst", "hsn", "vat", "invoice tax"],
+    },
+    {
+        id: "listings",
+        label: "⑱ Listings",
+        description: "Which listing types sellers may create, and their defaults.",
+        keywords: ["listing types", "auctions on", "enable", "categories"],
+    },
+];
+export const SITE_SETTINGS_TAB_IDS = SITE_SETTINGS_TABS.map((t) => t.id);
+/** Whether a `?tab=` value names a real tab. */
+export function isSiteSettingsTabId(value) {
+    return !!value && SITE_SETTINGS_TAB_IDS.includes(value);
+}

package/dist/features/admin/index.d.ts

@@ -3,8 +3,5 @@ export * from "./types";
 export * from "./hooks/useAdmin";
 export * from "./hooks/useAdminListingData";
 export * from "./hooks/useAdminSectionsListing";
-export * from "./hooks/useChat";
 export * from "./components";
-export type { ChatRoomDocument, ChatRoomCreateInput, } from "./repository/chat.repository";
 export { manifest } from "./manifest";
-export { ADMIN_PAGE_PERMISSIONS } from "./permission-map";

package/dist/features/admin/index.js

@@ -3,7 +3,5 @@ export * from "./types";
 export * from "./hooks/useAdmin";
 export * from "./hooks/useAdminListingData";
 export * from "./hooks/useAdminSectionsListing";
-export * from "./hooks/useChat";
 export * from "./components";
 export { manifest } from "./manifest";
-export { ADMIN_PAGE_PERMISSIONS } from "./permission-map";

package/dist/features/admin/repository/analytics-rollup.repository.d.ts

@@ -14,6 +14,25 @@ export interface AnalyticsRollupDocument {
     deliveredOrderCount: number;
     computedAt: Date;
 }
+/**
+ * Lifetime page-view totals, so `pageViewPrune` can delete day-buckets without
+ * the long-run numbers going with them.
+ *
+ * `byEntityType` and not per-entity: a per-entity map would grow with the
+ * catalogue and reintroduce, in one document, exactly the unbounded growth the
+ * prune exists to stop — and a singleton has a 1 MiB ceiling it would eventually
+ * hit with no warning.
+ */
+export interface PageViewRollupDocument {
+    id: string;
+    /** Every counted view since the rollup began. */
+    totalViews: number;
+    /** Totals per entity type — a closed union, so this map cannot grow. */
+    byEntityType: Record<string, number>;
+    /** The last day-bucket folded in, so a re-run cannot double-count. */
+    throughDate: string;
+    computedAt: Date;
+}
 export declare class AnalyticsRollupRepository extends BaseRepository<AnalyticsRollupDocument> {
     constructor();
     getDashboardRollup(): Promise<AnalyticsRollupDocument | null>;
@@ -23,3 +42,19 @@ export declare class AnalyticsRollupRepository extends BaseRepository<AnalyticsR
     }): Promise<void>;
 }
 export declare const analyticsRollupRepository: AnalyticsRollupRepository;
+/**
+ * The page-view rollup — same `analytics` collection, different document shape,
+ * so a different repository.
+ *
+ * 🛑 Deliberately NOT a second pair of methods on `AnalyticsRollupRepository`.
+ * `BaseRepository<T>` types `findById` as returning `T`, so two shapes behind
+ * one class means every read is either a lie or a cast — and `as unknown as X`
+ * at a data boundary is the zero-runtime-effect silence Root Cause #70 records.
+ * Two singletons with different fields are two types.
+ */
+export declare class PageViewRollupRepository extends BaseRepository<PageViewRollupDocument> {
+    constructor();
+    get(): Promise<PageViewRollupDocument | null>;
+    set(data: Pick<PageViewRollupDocument, "totalViews" | "byEntityType" | "throughDate">): Promise<void>;
+}
+export declare const pageViewRollupRepository: PageViewRollupRepository;

package/dist/features/admin/repository/analytics-rollup.repository.js

@@ -10,6 +10,7 @@
 import { BaseRepository } from "../../../providers/db-firebase";
 const ANALYTICS_COLLECTION = "analytics";
 const DASHBOARD_ROLLUP_ID = "dashboardRollup";
+const PAGE_VIEW_ROLLUP_ID = "pageViewRollup";
 export class AnalyticsRollupRepository extends BaseRepository {
     constructor() {
         super(ANALYTICS_COLLECTION);
@@ -29,3 +30,32 @@ export class AnalyticsRollupRepository extends BaseRepository {
     }
 }
 export const analyticsRollupRepository = new AnalyticsRollupRepository();
+/**
+ * The page-view rollup — same `analytics` collection, different document shape,
+ * so a different repository.
+ *
+ * 🛑 Deliberately NOT a second pair of methods on `AnalyticsRollupRepository`.
+ * `BaseRepository<T>` types `findById` as returning `T`, so two shapes behind
+ * one class means every read is either a lie or a cast — and `as unknown as X`
+ * at a data boundary is the zero-runtime-effect silence Root Cause #70 records.
+ * Two singletons with different fields are two types.
+ */
+export class PageViewRollupRepository extends BaseRepository {
+    constructor() {
+        super(ANALYTICS_COLLECTION);
+    }
+    async get() {
+        return this.findById(PAGE_VIEW_ROLLUP_ID);
+    }
+    async set(data) {
+        const existing = await this.findById(PAGE_VIEW_ROLLUP_ID);
+        const payload = { ...data, computedAt: new Date() };
+        if (existing) {
+            await this.update(PAGE_VIEW_ROLLUP_ID, payload);
+        }
+        else {
+            await this.createWithId(PAGE_VIEW_ROLLUP_ID, payload);
+        }
+    }
+}
+export const pageViewRollupRepository = new PageViewRollupRepository();

package/dist/features/admin/schemas/admin-editor-forms.d.ts

@@ -1,56 +1,5 @@
 import { z } from "zod";
-/**
- * An address written by an admin on someone's behalf.
- *
- * Shapes match `AddressDocument` (`addressLine1`, not `line1`) — deliberately
- * NOT `userAddressSchema`, which is the account-side view of the same data
- * under different field names. Reusing that one here would have meant
- * translating on every write.
- */
-export declare const adminAddressFormSchema: z.ZodObject<{
-    ownerType: z.ZodEnum<["user", "store"]>;
-    ownerId: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    fullName: z.ZodString;
-    phone: z.ZodString;
-    addressLine1: z.ZodString;
-    addressLine2: z.ZodOptional<z.ZodString>;
-    landmark: z.ZodOptional<z.ZodString>;
-    city: z.ZodString;
-    state: z.ZodString;
-    postalCode: z.ZodString;
-    country: z.ZodString;
-    isDefault: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    country: string;
-    ownerId: string;
-    ownerType: "user" | "store";
-    fullName: string;
-    phone: string;
-    addressLine1: string;
-    city: string;
-    state: string;
-    postalCode: string;
-    label?: string | undefined;
-    isDefault?: boolean | undefined;
-    addressLine2?: string | undefined;
-    landmark?: string | undefined;
-}, {
-    country: string;
-    ownerId: string;
-    ownerType: "user" | "store";
-    fullName: string;
-    phone: string;
-    addressLine1: string;
-    city: string;
-    state: string;
-    postalCode: string;
-    label?: string | undefined;
-    isDefault?: boolean | undefined;
-    addressLine2?: string | undefined;
-    landmark?: string | undefined;
-}>;
-export type AdminAddressFormValues = z.infer<typeof adminAddressFormSchema>;
+import { type StoreStatus } from "../../stores/schemas/firestore";
 /**
  * An admin changing a store's standing.
  *
@@ -59,35 +8,35 @@ export type AdminAddressFormValues = z.infer<typeof adminAddressFormSchema>;
  * the next admin, with nothing to appeal or review.
  */
 export declare const adminStoreUpdateSchema: z.ZodEffects<z.ZodObject<{
-    storeStatus: z.ZodEnum<["pending", "active", "suspended", "closed"]>;
+    storeStatus: z.ZodEnum<[StoreStatus, ...StoreStatus[]]>;
     isVerified: z.ZodOptional<z.ZodBoolean>;
     isFeatured: z.ZodOptional<z.ZodBoolean>;
     suspensionReason: z.ZodOptional<z.ZodString>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     adminNotes: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    storeStatus: "closed" | "pending" | "active" | "suspended";
+    storeStatus: StoreStatus;
     isVerified?: boolean | undefined;
     isFeatured?: boolean | undefined;
     adminNotes?: string | undefined;
     suspensionReason?: string | undefined;
     capabilities?: string[] | undefined;
 }, {
-    storeStatus: "closed" | "pending" | "active" | "suspended";
+    storeStatus: StoreStatus;
     isVerified?: boolean | undefined;
     isFeatured?: boolean | undefined;
     adminNotes?: string | undefined;
     suspensionReason?: string | undefined;
     capabilities?: string[] | undefined;
 }>, {
-    storeStatus: "closed" | "pending" | "active" | "suspended";
+    storeStatus: StoreStatus;
     isVerified?: boolean | undefined;
     isFeatured?: boolean | undefined;
     adminNotes?: string | undefined;
     suspensionReason?: string | undefined;
     capabilities?: string[] | undefined;
 }, {
-    storeStatus: "closed" | "pending" | "active" | "suspended";
+    storeStatus: StoreStatus;
     isVerified?: boolean | undefined;
     isFeatured?: boolean | undefined;
     adminNotes?: string | undefined;
@@ -117,3 +66,53 @@ export declare const announcementBarSchema: z.ZodObject<{
     enabled?: boolean | undefined;
 }>;
 export type AnnouncementBarValues = z.infer<typeof announcementBarSchema>;
+/**
+ * A brand, as an admin edits it.
+ *
+ * Lifted out of `AdminBrandEditorView`, where it was declared locally and
+ * unannotated — so it could not drive a generated form, and, more to the point,
+ * it never ran: the submit handler checked `name.trim()` and called the
+ * mutation. `website: z.string().url()` had therefore never rejected anything,
+ * and the raw `<Input>`s it would have reported on carry no `name`, so
+ * `applyZodIssues` had nowhere to put an error even if it had.
+ *
+ * ## "Logo" is the cover image, and the labels used to say the opposite
+ *
+ * `logoURL` maps to `display.coverImage` — the brand page's full-bleed hero
+ * banner. The form once offered a "Logo" input beside a "Banner" input, where
+ * the first drove the banner and the second wrote `brandBannerImage`, a field
+ * with no reader anywhere (Root Cause #51). The dead field is gone and the
+ * label now describes what it controls.
+ */
+export declare const brandFormSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    description: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    logoURL: z.ZodUnion<[z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>, z.ZodLiteral<"">]>;
+    website: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    country: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    founded: z.ZodOptional<z.ZodNumber>;
+    isActive: z.ZodBoolean;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    isActive: boolean;
+    country?: string | undefined;
+    slug?: string | undefined;
+    description?: string | undefined;
+    displayOrder?: number | undefined;
+    logoURL?: string | undefined;
+    website?: string | undefined;
+    founded?: number | undefined;
+}, {
+    name: string;
+    isActive: boolean;
+    country?: string | undefined;
+    slug?: string | undefined;
+    description?: string | undefined;
+    displayOrder?: number | undefined;
+    logoURL?: string | undefined;
+    website?: string | undefined;
+    founded?: number | undefined;
+}>;
+export type BrandFormValues = z.infer<typeof brandFormSchema>;