@mohasinac/appkit 4.30.18 → 4.31.0

package/dist/core/browser.js

@@ -3,7 +3,7 @@ export { Queue } from "./Queue";
 export { StorageManager, storageManager } from "./StorageManager";
 export { EventBus, eventBus } from "./EventBus";
 export { CacheManager, cacheManager } from "./CacheManager";
-export { SITE_CONFIG, FEATURE_FLAGS, createSiteConfig, resolveSiteConfig, } from "./site-config";
+export { SITE_CONFIG, createSiteConfig, resolveSiteConfig, } from "./site-config";
 export { useSiteSettings } from "./hooks/useSiteSettings";
 export { MUTATION_EVENTS, emitMutation, onMutation, inferMutationEvent, } from "./mutation-events";
 export { configureMarketDefaults, resetMarketDefaults, getMarketProfile, getDefaultCurrency, getDefaultLocale, getDefaultCountry, getDefaultPhonePrefix, getDefaultTimezone, getDefaultCurrencySymbol, } from "./baseline-resolver";

package/dist/core/index.d.ts

@@ -14,7 +14,7 @@ export { EventBus, eventBus } from "./EventBus";
 export type { EventSubscription } from "./EventBus";
 export { CacheManager, cacheManager } from "./CacheManager";
 export type { CacheOptions, CacheEntry } from "./CacheManager";
-export { SITE_CONFIG, FEATURE_FLAGS, createSiteConfig, resolveSiteConfig, } from "./site-config";
+export { SITE_CONFIG, createSiteConfig, resolveSiteConfig, } from "./site-config";
 export type { RuntimeSiteConfig } from "./site-config";
 export { CopilotLogRepository, copilotLogRepository, } from "./copilot-log.repository";
 export type { CopilotFeedback, CopilotLogDocument, CopilotLogCreateInput, } from "./copilot-log.repository";

package/dist/core/index.js

@@ -9,7 +9,7 @@ export { Queue } from "./Queue";
 export { StorageManager, storageManager } from "./StorageManager";
 export { EventBus, eventBus } from "./EventBus";
 export { CacheManager, cacheManager } from "./CacheManager";
-export { SITE_CONFIG, FEATURE_FLAGS, createSiteConfig, resolveSiteConfig, } from "./site-config";
+export { SITE_CONFIG, createSiteConfig, resolveSiteConfig, } from "./site-config";
 export { CopilotLogRepository, copilotLogRepository, } from "./copilot-log.repository";
 export { COPILOT_LOGS_COLLECTION, COPILOT_LOGS_INDEXED_FIELDS, copilotLogQueryHelpers, } from "./copilot-log.repository";
 export { useSiteSettings } from "./hooks/useSiteSettings";

package/dist/core/site-config.d.ts

@@ -26,8 +26,5 @@ export interface RuntimeSiteConfig {
     };
 }
 export declare const SITE_CONFIG: RuntimeSiteConfig;
-export declare const FEATURE_FLAGS: {
-    readonly CHAT_ENABLED: false;
-};
 export declare function createSiteConfig(overrides: Partial<RuntimeSiteConfig>): RuntimeSiteConfig;
 export declare function resolveSiteConfig(resolver?: () => Promise<Partial<RuntimeSiteConfig>>): Promise<RuntimeSiteConfig>;

package/dist/core/site-config.js

@@ -51,9 +51,6 @@ export const SITE_CONFIG = {
         keywords: "ssr, appkit, webapp",
     },
 };
-export const FEATURE_FLAGS = {
-    CHAT_ENABLED: false,
-};
 export function createSiteConfig(overrides) {
     return {
         ...SITE_CONFIG,

package/dist/errors/index.d.ts

@@ -12,7 +12,7 @@ export { DatabaseError } from "./database-error";
 export { RazorpayUnreachableError } from "./razorpay-unreachable";
 export { handleApiError, logError, isAppError } from "./error-handler";
 export { mapToHttpError, HTTP_ERROR_CODES, type MappedError, type HttpErrorCode, } from "./error-mapping";
-export { ERROR_DISPLAY_MAP, getErrorDisplay, type ErrorDisplayEntry, } from "./error-display-map";
+export { ERROR_DISPLAY_MAP, getErrorDisplay, toUserMessage, GENERIC_USER_MESSAGE, type ErrorDisplayEntry, } from "./error-display-map";
 export { safeRead, installDegradedReadReporter, type DegradedReadReport, } from "./safe-read";
 export { normalizeError, getErrorMessage, isAuthError, isApiNormalized, isAppNormalized, isFirebaseAuthNormalized, isFirebaseFirestoreNormalized, isFirebaseStorageNormalized, isNativeNormalized, isNetworkNormalized, isUnknownNormalized, isZodNormalized, } from "./normalize";
 export type { NormalizedError, NormalizedApiError, NormalizedAppError, NormalizedFirebaseAuthError, NormalizedFirebaseFirestoreError, NormalizedFirebaseStorageError, NormalizedNativeError, NormalizedNetworkError, NormalizedUnknownThrownValue, NormalizedZodError, } from "./normalize";

package/dist/errors/index.js

@@ -17,7 +17,7 @@ export { RazorpayUnreachableError } from "./razorpay-unreachable";
 export { handleApiError, logError, isAppError } from "./error-handler";
 // Code→HTTP mapper (server) — and the i18n / inline-field map (client-safe)
 export { mapToHttpError, HTTP_ERROR_CODES, } from "./error-mapping";
-export { ERROR_DISPLAY_MAP, getErrorDisplay, } from "./error-display-map";
+export { ERROR_DISPLAY_MAP, getErrorDisplay, toUserMessage, GENERIC_USER_MESSAGE, } from "./error-display-map";
 // safeRead is server-only (uses the persisted log reporter)
 export { safeRead, installDegradedReadReporter, } from "./safe-read";
 // W3 — catch-clause normalizer. Every catch (e: unknown) funnels through

package/dist/errors/messages.d.ts

@@ -329,14 +329,6 @@ export declare const ERROR_MESSAGES: {
         readonly NOT_OWNED_BY_STORE: "This feature is not owned by your store";
         readonly NO_STORE: "No store found for this account";
     };
-    readonly CONVERSATIONS: {
-        readonly NOT_FOUND: "Conversation not found";
-        readonly FETCH_FAILED: "Failed to load conversations";
-        readonly SEND_FAILED: "Failed to send message";
-        readonly BODY_REQUIRED: "Message body is required";
-        readonly BODY_TOO_LONG: "Message too long";
-        readonly NOT_PARTICIPANT: "You are not a participant of this conversation";
-    };
     readonly BID: {
         readonly FETCH_FAILED: "Failed to load bids";
         readonly CREATE_FAILED: "Failed to place bid";

package/dist/errors/messages.js

@@ -355,15 +355,6 @@ export const ERROR_MESSAGES = {
         NOT_OWNED_BY_STORE: "This feature is not owned by your store",
         NO_STORE: "No store found for this account",
     },
-    // Buyer ↔ seller conversations (D5 + VC7)
-    CONVERSATIONS: {
-        NOT_FOUND: "Conversation not found",
-        FETCH_FAILED: "Failed to load conversations",
-        SEND_FAILED: "Failed to send message",
-        BODY_REQUIRED: "Message body is required",
-        BODY_TOO_LONG: "Message too long",
-        NOT_PARTICIPANT: "You are not a participant of this conversation",
-    },
     BID: {
         FETCH_FAILED: "Failed to load bids",
         CREATE_FAILED: "Failed to place bid",

package/dist/features/about/components/DeveloperView.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
+import { serverLogger } from "../../../monitoring/server-logger";
 import { Anchor, Avatar, Badge, Div, Heading, Row, Section, Span, Stack, Text, TextLink } from "../../../ui";
 import { ROUTES } from "../../../constants";
 import { PAGE_CONTAINER } from "../../../_internal/shared/styles/page";
@@ -21,8 +22,12 @@ export async function DeveloperView({ labels = {} }) {
         milestones = Array.isArray(aboutContent.milestones) ? aboutContent.milestones : [];
     }
     catch (_err) {
-        void normalizeError(_err);
-        // Firestore unavailable — render the empty state below rather than crash.
+        // Firestore unavailable — render the empty state below rather than crash,
+        // but say so: an empty Developers page is indistinguishable from a settings
+        // document that genuinely has no `isDeveloper` members.
+        serverLogger.warn("about.developerView: siteSettings.aboutContent read failed", {
+            error: normalizeError(_err).message,
+        });
     }
     const developers = teamMembers.filter((m) => m.isDeveloper);
     return (_jsxs(Div, { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", children: [_jsx(Section, { color: "inverse", tone: "accent-banner", padding: "banner", children: _jsxs(Div, { className: `${page.container.sm}`, children: [_jsx(Heading, { color: "inverse", level: 1, variant: "none", className: "mb-3", children: labels.title ?? "Meet the Developer" }), _jsx(Text, { color: "inverse", variant: "none", className: "/80", size: "sm", children: labels.subtitle ?? "The person building LetItRip, one feature at a time." })] }) }), _jsxs(Div, { className: `${page.container.sm}`, padding: "content-banner", children: [developers.length === 0 ? (_jsx(Text, { variant: "secondary", children: labels.empty ?? "Developer profile coming soon." })) : (_jsx(Stack, { gap: "xl", children: developers.map((dev) => (_jsxs(Stack, { gap: "md", surface: "default", padding: "lg", rounded: "xl", border: "default", children: [_jsxs(Row, { gap: "md", align: "center", children: [_jsx(Avatar, { src: dev.photoUrl, name: dev.name, alt: dev.name, size: "lg" }), _jsxs(Stack, { gap: "xs", children: [_jsx(Heading, { level: 2, children: dev.name }), _jsxs(Row, { gap: "xs", wrap: true, children: [_jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: dev.role }), dev.isFounder && _jsx(Badge, { variant: "primary", size: "xs", children: "Founder" }), _jsx(Badge, { variant: "secondary", size: "xs", children: "Developer" })] })] })] }), _jsx(Text, { variant: "secondary", className: "leading-relaxed", children: dev.bio }), dev.githubUrl && (_jsx(Anchor, { href: dev.githubUrl, tone: "brand", size: "sm", underline: "hover", children: "GitHub \u2197" }))] }, dev.name))) })), milestones.length > 0 && (_jsxs(Div, { className: "mt-14 border-t", border: "default", padding: "t-xl", children: [_jsx(Heading, { level: 3, className: "mb-6", color: "muted", size: "sm", weight: "semibold", transform: "uppercase", children: labels.journeyTitle ?? "The Journey" }), _jsx(Stack, { className: "relative border-l-2 border-primary/30 max-w-2xl pl-[2rem]", gap: "lg", children: milestones.map(({ year, text }) => (_jsxs(Div, { className: "relative", children: [_jsx(Div, { className: "absolute -left-10 top-1 w-4 h-4 bg-primary border-2 border-white", rounded: "full" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary tracking-wide", transform: "uppercase", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] })), _jsx(Div, { className: "mt-10", children: _jsx(TextLink, { href: String(ROUTES.PUBLIC.ABOUT), variant: "muted", size: "sm", children: labels.backToTeam ?? "← Meet the whole team" }) })] })] }));

package/dist/features/about/components/PolicyPageView.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { normalizeError } from "../../../errors/normalize";
+import { serverLogger } from "../../../monitoring/server-logger";
 import { Row } from "@mohasinac/appkit/ui";
 import { ROUTES } from "../../../constants";
 import { PAGE_CONTAINER } from "../../../_internal/shared/styles/page";
@@ -72,7 +73,14 @@ export async function PolicyPageView({ policy, }) {
     }
     catch (_err) {
         void normalizeError(_err);
-        // Firestore unavailable — fall back to i18n
+        // Falls back to the bundled i18n copy below, which is a complete policy in
+        // its own right — but an admin who has overridden this page would silently
+        // see the old text, so the failure has to be visible to an operator.
+        serverLogger.warn("about.policyPageView: siteSettings.legalPages read failed", {
+            policy,
+            field: meta.firestoreField,
+            error: normalizeError(_err).message,
+        });
     }
     // i18n fallback sections
     const rawSections = t.raw("sections");

package/dist/features/about/components/PublicProfileView.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import Link from "next/link";
 import { getPublicUserProfile, getProfileStoreProducts, getReviewsAuthoredBy, getReviewsReceivedBy } from "../../auth/actions/profile-actions";
 import { storeRepository } from "../../stores/repository/store.repository";
+import { safeRead } from "../../../errors/safe-read";
 import { ROUTES } from "../../../constants";
 import { PAGE_CONTAINER } from "../../../_internal/shared/styles/page";
 import { FLEX_CENTER } from "../../../_internal/shared/styles/themed";
@@ -64,13 +65,30 @@ export async function PublicProfileView({ userId, tab, }) {
     const flex = { center: FLEX_CENTER };
     const { getTranslations } = await import("next-intl/server");
     const t = await getTranslations("publicProfile");
-    const profile = await getPublicUserProfile(userId).catch(() => null);
+    // The profile IS this page's subject — a read failure must surface, not turn
+    // into the same `null` a genuinely missing user produces. The `null` return
+    // from getPublicUserProfile still means "no such user".
+    const profile = await getPublicUserProfile(userId);
     const storeId = profile?.storeSlug ?? null;
     const [products, store, reviewsAuthored, reviewsReceivedAsBuyer] = await Promise.all([
-        storeId ? getProfileStoreProducts(storeId).catch(() => []) : Promise.resolve([]),
-        storeId ? storeRepository.findById(storeId).catch(() => null) : Promise.resolve(null),
-        getReviewsAuthoredBy(userId).catch(() => []),
-        getReviewsReceivedBy(userId).catch(() => []),
+        storeId
+            ? safeRead(() => getProfileStoreProducts(storeId), {
+                route: "/profile/[userId]",
+                key: "profile.storeProducts",
+                fallback: [],
+            })
+            : Promise.resolve([]),
+        storeId
+            ? safeRead(() => storeRepository.findById(storeId), {
+                route: "/profile/[userId]",
+                key: "profile.store",
+                fallback: null,
+            })
+            : Promise.resolve(null),
+        // Both already degrade internally via safeRead — anything still thrown here
+        // is a mapping bug, which should surface rather than render an empty rail.
+        getReviewsAuthoredBy(userId),
+        getReviewsReceivedBy(userId),
     ]);
     const isSeller = isSellerUser(profile) || isAdminUser(profile);
     // For sellers: lead with store identity (name + logo). For buyers: user identity.

package/dist/features/about/schemas/index.d.ts

@@ -138,6 +138,10 @@ export declare const aboutContentSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     title: string;
     subtitle: string;
+    milestones: {
+        text: string;
+        year: string;
+    }[];
     missionTitle: string;
     missionText: string;
     howItWorksTitle: string;
@@ -159,10 +163,6 @@ export declare const aboutContentSchema: z.ZodObject<{
         text: string;
         icon: string;
     }[];
-    milestones: {
-        text: string;
-        year: string;
-    }[];
     teamMembers: {
         role: string;
         name: string;
@@ -174,6 +174,10 @@ export declare const aboutContentSchema: z.ZodObject<{
 }, {
     title: string;
     subtitle: string;
+    milestones: {
+        text: string;
+        year: string;
+    }[];
     missionTitle: string;
     missionText: string;
     howItWorksTitle: string;
@@ -195,10 +199,6 @@ export declare const aboutContentSchema: z.ZodObject<{
         text: string;
         icon: string;
     }[];
-    milestones: {
-        text: string;
-        year: string;
-    }[];
     teamMembers: {
         role: string;
         name: string;

package/dist/features/account/components/AddressFilters.js

@@ -1,21 +1,42 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * WHY: All THREE facets here filtered on fields `AddressDocument` does not
+ *      have. `addressType` shipped a hardcoded six-option list (which did not
+ *      even match the three-option `ADDRESS_TYPES` constant it was presumably
+ *      copied from), `verified` read `a.verified` and `activeOnly` read
+ *      `a.active` — and the route reached all three through `as any` casts, so
+ *      the comparison was always against `""`.
+ *
+ *      Facets that render, count toward the filter-drawer badge, and can never
+ *      match a single row. Root Cause #62's shape one layer up: not a broken
+ *      link in the chain, a chain attached to nothing.
+ * WHAT: Two facets that read fields the document actually has.
+ *
+ * `isDefault` and `banStatus` are the only two worth filtering on: the rest of
+ * `AddressDocument` is free text a search box covers better than a facet.
+ *
+ * @tag domain:addresses
+ * @tag layer:component
+ * @tag pattern:none
+ * @tag access:client
+ * @tag consumers:AddressesIndexListing
+ * @tag sideEffects:none
+ */
 import { useTranslations } from "next-intl";
 import { FilterFacetSection } from "../../filters/FilterFacetSection";
 import { SwitchFilter } from "../../filters/SwitchFilter";
 import { Div } from "../../../ui";
+/** Mirrors `AddressBanStatus`. Absent means "in good standing". */
+const BAN_STATUS_OPTIONS = [
+    { value: "banned", label: "Banned" },
+    { value: "unban_requested", label: "Unban requested" },
+    { value: "suspicious", label: "Flagged as suspicious" },
+];
 export function AddressFilters({ table }) {
     const t = useTranslations("filters");
-    const typeOptions = [
-        { value: "home", label: t("addressTypeHome") },
-        { value: "work", label: t("addressTypeWork") },
-        { value: "shipping", label: t("addressTypeShipping") },
-        { value: "billing", label: t("addressTypeBilling") },
-        { value: "business", label: t("addressTypeBusiness") },
-        { value: "other", label: t("addressTypeOther") },
-    ];
-    const selectedTypes = table.get("addressType")
-        ? table.get("addressType").split("|").filter(Boolean)
+    const selectedBanStatus = table.get("banStatus")
+        ? table.get("banStatus").split("|").filter(Boolean)
         : [];
-    return (_jsxs(Div, { children: [_jsx(FilterFacetSection, { title: t("addressType"), options: typeOptions, selected: selectedTypes, onChange: (vals) => table.set("addressType", vals.join("|")), searchable: false, defaultCollapsed: false }), _jsx(SwitchFilter, { title: t("addressVerified"), label: t("showVerifiedAddressOnly"), checked: table.get("verified") === "true", onChange: (v) => table.set("verified", v ? "true" : ""), defaultCollapsed: true }), _jsx(SwitchFilter, { title: t("addressActive"), label: t("showActiveAddressOnly"), checked: table.get("activeOnly") === "true", onChange: (v) => table.set("activeOnly", v ? "true" : ""), defaultCollapsed: true })] }));
+    return (_jsxs(Div, { children: [_jsx(SwitchFilter, { title: t("addressDefault"), label: t("showDefaultAddressOnly"), checked: table.get("defaultOnly") === "true", onChange: (v) => table.set("defaultOnly", v ? "true" : ""), defaultCollapsed: false }), _jsx(FilterFacetSection, { title: t("addressBanStatus"), options: BAN_STATUS_OPTIONS, selected: selectedBanStatus, onChange: (vals) => table.set("banStatus", vals.join("|")), searchable: false, defaultCollapsed: true })] }));
 }

package/dist/features/account/components/AddressForm.d.ts

@@ -1,32 +1,34 @@
+/**
+ * The buyer's address form — sectionised, and on the shared address shape,
+ * 2026-08-30 (W5 / D19).
+ *
+ * ## What it was
+ *
+ * A local `addressFormSchema` declared right here, one of **eleven** address
+ * field shapes in the tree, with `postalCode: z.string().min(1)` — so `abc`
+ * passed every check the buyer could see and came back a server 400 with
+ * nothing on the field. `state` was a free-text input writing the same
+ * `AddressDocument.state` that the admin editor filled from a 36-option
+ * `INDIAN_STATES` select, and `country` was free text while the server's
+ * postal rule was India-only.
+ *
+ * All of that now comes from `addressFormSchema` in
+ * `features/addresses/schemas/address-form.ts`, whose postal rule is
+ * `COUNTRIES[country].postalPattern` and is the same rule the routes run.
+ *
+ * ## The lookup
+ *
+ * A complete postal code fills city and state — only when they are EMPTY. It
+ * never corrects what the buyer typed, and a miss or a network failure is a
+ * non-event: the fields stay editable and the submit is never blocked.
+ */
+import * as React from "react";
 import type { AddressFormData } from "../hooks/useAddresses";
 export interface AddressFormLabels {
-    label: string;
-    fullName: string;
-    phone: string;
-    addressLine1: string;
-    addressLine2: string;
-    landmark: string;
-    city: string;
-    state: string;
-    postalCode: string;
-    country: string;
-    setDefault: string;
     cancel: string;
     save: string;
     loading: string;
 }
-export interface AddressFormPlaceholders {
-    label: string;
-    fullName: string;
-    phone: string;
-    addressLine1: string;
-    addressLine2: string;
-    landmark: string;
-    city: string;
-    state: string;
-    postalCode: string;
-    country: string;
-}
 interface AddressFormProps {
     initialData?: Partial<AddressFormData>;
     onSubmit: (data: AddressFormData) => void | Promise<void>;
@@ -35,7 +37,6 @@ interface AddressFormProps {
     submitLabel?: string;
     defaultCountry?: string;
     labels?: Partial<AddressFormLabels>;
-    placeholders?: Partial<AddressFormPlaceholders>;
 }
-export declare function AddressForm({ initialData, onSubmit, onCancel, isLoading, submitLabel, defaultCountry, labels, placeholders, }: AddressFormProps): import("react").JSX.Element;
+export declare function AddressForm({ initialData, onSubmit, onCancel, isLoading, submitLabel, defaultCountry, labels, }: AddressFormProps): React.JSX.Element;
 export {};

package/dist/features/account/components/AddressForm.js

@@ -1,61 +1,45 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { normalizeError } from "../../../errors/normalize";
-import { useCallback, useEffect, useState } from "react";
-import { z } from "zod";
-import { Button, Checkbox, FormField, FormGroup, Row, useToast } from "../../../ui";
-import { Form } from "../../../ui/components/Form";
-import { useFormShellState, FormErrorSummary } from "../../../ui/forms";
-// Local form-input schema — `userAddressSchema` (account schemas) uses
-// different field names (`line1`/`line2`, no `fullName`) and a required
-// `id`, since it models the stored Firestore shape, not this form's input.
-const addressFormSchema = z.object({
-    label: z.string().optional(),
-    fullName: z.string().min(1, "Full name is required"),
-    phone: z.string().min(1, "Phone number is required"),
-    addressLine1: z.string().min(1, "Address is required"),
-    addressLine2: z.string().optional(),
-    landmark: z.string().max(100, "Keep the landmark under 100 characters.").optional(),
-    city: z.string().min(1, "City is required"),
-    state: z.string().min(1, "State is required"),
-    postalCode: z.string().min(1, "Postal code is required"),
-    country: z.string().optional(),
-    isDefault: z.boolean().optional(),
-});
-const DEFAULT_LABELS = {
-    label: "Address Label",
-    fullName: "Full Name",
-    phone: "Phone Number",
-    addressLine1: "Address Line 1",
-    addressLine2: "Address Line 2",
-    landmark: "Landmark",
-    city: "City",
-    state: "State",
-    postalCode: "Postal Code",
-    country: "Country",
-    setDefault: "Set as default address",
-    cancel: "Cancel",
-    save: "Save",
-    loading: "Saving...",
-};
-const DEFAULT_PLACEHOLDERS = {
-    label: "Home, Office, etc.",
-    fullName: "Recipient's full name",
-    phone: "Enter phone number",
-    addressLine1: "Street address, P.O. box",
-    addressLine2: "Apartment, suite, unit, building, floor, etc.",
-    landmark: "Opposite the Metro station, next to the temple, etc.",
-    city: "City",
-    state: "State/Province",
-    postalCode: "Postal/ZIP code",
-    country: "Country",
-};
-export function AddressForm({ initialData, onSubmit, onCancel, isLoading = false, submitLabel, defaultCountry = "India", labels, placeholders, }) {
-    const { showToast } = useToast();
-    const mergedLabels = { ...DEFAULT_LABELS, ...labels };
-    const mergedPlaceholders = { ...DEFAULT_PLACEHOLDERS, ...placeholders };
-    const effectiveSubmitLabel = submitLabel ?? mergedLabels.save;
-    const [formData, setFormData] = useState({
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The buyer's address form — sectionised, and on the shared address shape,
+ * 2026-08-30 (W5 / D19).
+ *
+ * ## What it was
+ *
+ * A local `addressFormSchema` declared right here, one of **eleven** address
+ * field shapes in the tree, with `postalCode: z.string().min(1)` — so `abc`
+ * passed every check the buyer could see and came back a server 400 with
+ * nothing on the field. `state` was a free-text input writing the same
+ * `AddressDocument.state` that the admin editor filled from a 36-option
+ * `INDIAN_STATES` select, and `country` was free text while the server's
+ * postal rule was India-only.
+ *
+ * All of that now comes from `addressFormSchema` in
+ * `features/addresses/schemas/address-form.ts`, whose postal rule is
+ * `COUNTRIES[country].postalPattern` and is the same rule the routes run.
+ *
+ * ## The lookup
+ *
+ * A complete postal code fills city and state — only when they are EMPTY. It
+ * never corrects what the buyer typed, and a miss or a network failure is a
+ * non-event: the fields stay editable and the submit is never blocked.
+ */
+import * as React from "react";
+import { Stack } from "../../../ui";
+import { FormErrorSummary, applyZodIssues } from "../../../ui/forms";
+import { FormShellContext, useFormShellState } from "../../../ui/forms/FormShell";
+import { buildSectionsFromSchema, visibleValues } from "../../shell/build-sections";
+import { SectionForm, useSectionFormNav } from "../../shell/SectionForm";
+import { addressFormSchema } from "../../addresses/schemas/address-form";
+import { usePostalLookup } from "../../addresses/hooks/usePostalLookup";
+import { AddressLocationFields } from "../../addresses/components/AddressLocationFields";
+import { COUNTRIES, DEFAULT_COUNTRY } from "../../../constants/geo/countries";
+const COUNTRY_OPTIONS = Object.values(COUNTRIES).map((c) => ({
+    value: c.code,
+    label: c.name,
+}));
+export function AddressForm({ initialData, onSubmit, onCancel, isLoading = false, submitLabel = "Save", defaultCountry = DEFAULT_COUNTRY, labels, }) {
+    const [form, setForm] = React.useState({
         label: initialData?.label || "",
         fullName: initialData?.fullName || "",
         phone: initialData?.phone || "",
@@ -68,55 +52,49 @@ export function AddressForm({ initialData, onSubmit, onCancel, isLoading = false
         country: initialData?.country || defaultCountry,
         isDefault: initialData?.isDefault || false,
     });
-    const { shellCtx, validate, setFieldError, clearErrors, markSubmitAttempted } = useFormShellState(addressFormSchema);
+    const patch = (partial) => setForm((prev) => Object.assign({}, prev, partial));
     /*
-     * ONE submit path, shared by the inline Save button and the pinned mobile
-     * bar. Two copies would be two chances for the bar to skip a check the
-     * button performs — and the bar is the one a phone user actually presses,
-     * since the inline row sits below the fold on a form this long.
+     * 🛑 Autofill lands only in an EMPTY field. Correcting an address the buyer
+     * deliberately typed is a bug they cannot report — they watch their own
+     * typing vanish and have no idea what did it.
      */
-    const submitAddress = useCallback(async (h) => {
-        const setErr = h?.setFieldError ?? setFieldError;
-        const clear = h?.clearErrors ?? clearErrors;
-        markSubmitAttempted();
-        clear();
-        const errs = {};
-        if (!formData.fullName.trim())
-            errs["fullName"] = "Full name is required";
-        if (!formData.phone.trim())
-            errs["phone"] = "Phone number is required";
-        if (!formData.addressLine1.trim())
-            errs["addressLine1"] = "Address is required";
-        if (!formData.city.trim())
-            errs["city"] = "City is required";
-        if (!formData.state.trim())
-            errs["state"] = "State is required";
-        if (!formData.postalCode.trim())
-            errs["postalCode"] = "Postal code is required";
-        if (Object.keys(errs).length > 0) {
-            Object.entries(errs).forEach(([k, v]) => setErr(k, v));
+    const { lookup, isLooking } = usePostalLookup({
+        onResolved: ({ city, state }) => setForm((prev) => ({
+            ...prev,
+            city: prev.city.trim() ? prev.city : city,
+            state: prev.state.trim() ? prev.state : state,
+        })),
+        enabled: !isLoading,
+    });
+    const sections = React.useMemo(() => buildSectionsFromSchema(addressFormSchema, {
+        options: { country: COUNTRY_OPTIONS },
+        renderers: {
+            /*
+             * State, postal code and country move together: the country decides
+             * whether state is a picker or free text AND what a valid postal
+             * code looks like, so one component owns all three rather than three
+             * renderers each re-deriving the same country.
+             */
+            state: ({ values, onChange, errors }) => (_jsx(AddressLocationFields, { country: values.country, state: values.state, postalCode: values.postalCode, errors: errors, isLooking: isLooking, onChange: onChange, onPostalSettled: lookup })),
+            // Rendered by the component above.
+            postalCode: () => null,
+            country: () => null,
+        },
+    }), [isLooking, lookup]);
+    const nav = useSectionFormNav(sections, form, { scope: "user:address" });
+    const { shellCtx, setFieldError, clearErrors } = useFormShellState(addressFormSchema, {
+        sections: nav.sectionMeta,
+        onGoToSection: nav.goToSection,
+        fieldToSectionIndex: nav.fieldToSectionIndex,
+    });
+    const submitAddress = async () => {
+        clearErrors();
+        const parsed = addressFormSchema.safeParse(visibleValues(addressFormSchema, form));
+        if (!parsed.success) {
+            applyZodIssues(parsed.error.issues, setFieldError);
             return;
         }
-        try {
-            await onSubmit(formData);
-        }
-        catch (err) {
-            void normalizeError(err);
-            showToast(err instanceof Error ? err.message : "Failed to save address", "error");
-        }
-    }, [formData, onSubmit, showToast, setFieldError, clearErrors, markSubmitAttempted]);
-    useEffect(() => {
-        validate(formData);
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [formData, validate]);
-    const handleChange = (field, value) => {
-        setFormData((prev) => ({ ...prev, [field]: value }));
+        await onSubmit(form);
     };
-    return (_jsx(Form, { onSubmit: (e) => e.preventDefault(), spacing: "md", shellCtx: shellCtx, bottomBar: {
-            onSubmit: submitAddress,
-            onCancel,
-            submitLabel: effectiveSubmitLabel,
-            cancelLabel: mergedLabels.cancel,
-            isLoading,
-        }, children: ({ setFieldError, clearErrors }) => (_jsxs(_Fragment, { children: [_jsx(FormField, { label: mergedLabels.label, name: "label", type: "text", value: formData.label, onChange: (value) => handleChange("label", value), placeholder: mergedPlaceholders.label, required: true }), _jsx(FormField, { label: mergedLabels.fullName, name: "fullName", type: "text", value: formData.fullName, onChange: (value) => handleChange("fullName", value), placeholder: mergedPlaceholders.fullName, required: true }), _jsx(FormField, { label: mergedLabels.phone, name: "phone", type: "tel", value: formData.phone, onChange: (value) => handleChange("phone", value), placeholder: mergedPlaceholders.phone, required: true }), _jsx(FormField, { label: mergedLabels.addressLine1, name: "addressLine1", type: "text", value: formData.addressLine1, onChange: (value) => handleChange("addressLine1", value), placeholder: mergedPlaceholders.addressLine1, required: true }), _jsx(FormField, { label: mergedLabels.addressLine2, name: "addressLine2", type: "text", value: formData.addressLine2, onChange: (value) => handleChange("addressLine2", value), placeholder: mergedPlaceholders.addressLine2 }), _jsx(FormField, { label: mergedLabels.landmark, name: "landmark", type: "text", value: formData.landmark ?? "", onChange: (value) => handleChange("landmark", value), placeholder: mergedPlaceholders.landmark }), _jsxs(FormGroup, { columns: 3, children: [_jsx(FormField, { label: mergedLabels.city, name: "city", type: "text", value: formData.city, onChange: (value) => handleChange("city", value), placeholder: mergedPlaceholders.city, required: true }), _jsx(FormField, { label: mergedLabels.state, name: "state", type: "text", value: formData.state, onChange: (value) => handleChange("state", value), placeholder: mergedPlaceholders.state, required: true }), _jsx(FormField, { label: mergedLabels.postalCode, name: "postalCode", type: "text", value: formData.postalCode, onChange: (value) => handleChange("postalCode", value), placeholder: mergedPlaceholders.postalCode, required: true })] }), _jsx(FormField, { label: mergedLabels.country, name: "country", type: "text", value: formData.country, onChange: (value) => handleChange("country", value), placeholder: mergedPlaceholders.country, required: true }), _jsx(Checkbox, { checked: formData.isDefault, onChange: (e) => handleChange("isDefault", e.target.checked), label: mergedLabels.setDefault }), _jsx(FormErrorSummary, {}), _jsxs(Row, { padding: "t-xs", align: "center", justify: "start", gap: "xs", children: [_jsx(Button, { type: "button", variant: "outline", onClick: onCancel, disabled: isLoading, children: mergedLabels.cancel }), _jsx(Button, { type: "submit", variant: "primary", disabled: isLoading, isLoading: isLoading, onClick: () => void submitAddress({ setFieldError, clearErrors }), children: isLoading ? mergedLabels.loading : effectiveSubmitLabel })] })] })) }));
+    return (_jsx(Stack, { gap: "md", children: _jsxs(FormShellContext.Provider, { value: shellCtx, children: [_jsx(FormErrorSummary, {}), _jsx(SectionForm, { sections: sections, values: form, onChange: patch, onSubmit: () => void submitAddress(), schema: addressFormSchema, openIds: nav.openIds, onOpenChange: nav.setOpenIds, isLoading: isLoading, submitLabel: submitLabel, onCancel: onCancel, cancelLabel: labels?.cancel ?? "Cancel" })] }) }));
 }

package/dist/features/account/components/AddressesIndexListing.js

@@ -7,7 +7,12 @@ import { Div, Grid, ListingFilterDrawer, ListingToolbar, Stack, Text } from "../
 import { AddressBook } from "./AddressBook";
 import { AddressFilters } from "./AddressFilters";
 import { TABLE_KEYS, VIEW_MODE } from "../../../constants/table-keys";
-const FILTER_KEYS = ["addressType", "verified", "activeOnly"];
+/*
+ * The two facets that read fields `AddressDocument` actually has. It was
+ * `["addressType", "verified", "activeOnly"]` — three keys the document has
+ * never carried, so every one of them inflated this badge and matched nothing.
+ */
+const FILTER_KEYS = ["defaultOnly", "banStatus"];
 export function AddressesIndexListing({ onAdd, onEdit, onDelete, }) {
     const table = useUrlTable({ defaults: {} });
     const [view, setView] = useState(table.get(TABLE_KEYS.VIEW) || VIEW_MODE.GRID);
@@ -68,9 +73,8 @@ export function AddressesIndexListing({ onAdd, onEdit, onDelete, }) {
     const { data: addresses = [], isLoading } = useAddresses({
         filters: {
             q: table.get(TABLE_KEYS.QUERY) || undefined,
-            addressType: table.get("addressType") || undefined,
-            verified: table.get("verified") === "true" || undefined,
-            activeOnly: table.get("activeOnly") === "true" || undefined,
+            defaultOnly: table.get("defaultOnly") === "true" || undefined,
+            banStatus: table.get("banStatus") || undefined,
         },
     });
     return (_jsxs(Stack, { gap: "md", children: [_jsx(ListingToolbar, { filterCount: activeFilterCount, onFiltersClick: openFilters, searchValue: searchInput, searchPlaceholder: "Search by address, postcode or label...", onSearchChange: setSearchInput, onSearchCommit: commitSearch, view: view, onViewChange: (v) => { if (v === "table")