@mohasinac/appkit 2.3.0 → 2.3.1

package/dist/errors/messages.js

@@ -0,0 +1,504 @@
+/**
+ * Error Messages Constants
+ *
+ * Generic error messages shared across all consumer applications.
+ * Split into a separate file to avoid Turbopack chunk-generation issues
+ * (EcmascriptModuleContent::new_merged error in Next.js 16 Turbopack when
+ * a large pure-data file is merged across Browser/SSR/Edge runtimes).
+ */
+export const ERROR_MESSAGES = {
+    // Authentication Errors
+    AUTH: {
+        UNAUTHORIZED: "You must be logged in to access this resource",
+        FORBIDDEN: "You do not have permission to access this resource",
+        INSUFFICIENT_PERMISSIONS: "You do not have sufficient permissions for this action",
+        SESSION_EXPIRED: "Your session has expired. Please login again",
+        SESSION_CREATION_FAILED: "Failed to create session. Please try again",
+        INVALID_CREDENTIALS: "Invalid email or password",
+        ACCOUNT_DISABLED: "Your account has been disabled",
+        EMAIL_NOT_VERIFIED: "Please verify your email address to continue",
+        REGISTRATION_FAILED: "Registration failed. Please try again",
+        LOGIN_FAILED: "Login failed. Please try again",
+        SIGN_IN_FAILED: "Sign-in failed. Please try again",
+        SIGN_IN_CANCELLED: "Sign-in was cancelled",
+        POPUP_BLOCKED: "Pop-up blocked by browser. Please allow pop-ups and try again",
+        API_KEY_NOT_CONFIGURED: "Firebase API key not configured",
+        TOKEN_EXCHANGE_FAILED: "Failed to exchange custom token for ID token",
+        ADMIN_ACCESS_REQUIRED: "Admin access required",
+        WRONG_PASSWORD: "Incorrect email or password. Please try again.",
+        EMAIL_IN_USE: "An account with this email already exists. Try signing in.",
+        INVALID_SIGNATURE: "Invalid webhook signature.",
+        /** Auth event bridge — pre-session OAuth signal channel */
+        AUTH_EVENT_MISSING: "Authentication event not found or already used.",
+        AUTH_EVENT_EXPIRED: "Authentication event has expired. Please try again.",
+        OAUTH_STATE_INVALID: "OAuth state parameter is invalid or missing.",
+        OAUTH_CODE_EXCHANGE_FAILED: "Failed to exchange OAuth authorisation code.",
+        OAUTH_USER_INFO_FAILED: "Failed to retrieve user info from OAuth provider.",
+        GOOGLE_TOKEN_INVALID: "Google ID token could not be verified.",
+        PAYMENT_EVENT_MISSING: "Payment event not found or already used.",
+        SIGNIN_INIT_FAILED: "Failed to initialise sign-in. Please try again.",
+        SIGNIN_CONNECTION_LOST: "Sign-in connection lost. Please try again.",
+        SIGNIN_TIMED_OUT: "Sign-in timed out. Please try again.",
+    },
+    // Validation Errors
+    VALIDATION: {
+        REQUIRED_FIELD: "This field is required",
+        INVALID_EMAIL: "Please enter a valid email address",
+        INVALID_PHONE: "Please enter a valid phone number",
+        INVALID_INDIAN_MOBILE: "Enter a valid 10-digit mobile number",
+        INVALID_PINCODE: "Enter a valid 6-digit pincode",
+        PASSWORD_TOO_SHORT: "Password must be at least 8 characters",
+        PASSWORD_NO_LOWERCASE: "Password must contain at least one lowercase letter",
+        PASSWORD_NO_UPPERCASE: "Password must contain at least one uppercase letter",
+        PASSWORD_NO_NUMBER: "Password must contain at least one number",
+        PASSWORD_MISMATCH: "Passwords do not match",
+        INVALID_INPUT: "Invalid input provided",
+        FAILED: "Validation failed",
+        MESSAGE_TOO_SHORT: "Message must be at least 10 characters",
+        TOKEN_REQUIRED: "Verification token is required",
+        VERIFICATION_FIELDS_REQUIRED: "Verification ID and code are required",
+        VERIFICATION_CODE_FORMAT: "Verification code must be 6 digits",
+        PRODUCT_ID_REQUIRED: "productId is required",
+        INVALID_TIME_RANGE: "Invalid time range",
+        INVALID_JSON: "Request body contains invalid JSON.",
+    },
+    // User/Profile Errors
+    USER: {
+        NOT_FOUND: "User not found",
+        ALREADY_EXISTS: "A user with this email or phone already exists",
+        EMAIL_ALREADY_REGISTERED: "This email is already registered",
+        UPDATE_FAILED: "Failed to update user profile",
+        PROFILE_INCOMPLETE: "Please complete your profile",
+        NOT_AUTHENTICATED: "User not authenticated",
+        CANNOT_MODIFY_SELF: "You cannot modify your own account",
+        INSUFFICIENT_ROLE_PERMISSION: "You do not have permission to assign this role",
+        ACCOUNT_DISABLED: "Your account has been disabled",
+        TERMS_NOT_ACCEPTED: "You must accept the terms and conditions to register",
+        ALREADY_A_SELLER: "You are already registered as a seller",
+        SELLER_APPLICATION_FAILED: "Failed to submit seller application. Please try again.",
+    },
+    // Password Errors
+    PASSWORD: {
+        REQUIRED: "Password is required",
+        TOO_SHORT: "Password must be at least 8 characters",
+        NO_UPPERCASE: "Password must contain at least one uppercase letter",
+        NO_LOWERCASE: "Password must contain at least one lowercase letter",
+        NO_NUMBER: "Password must contain at least one number",
+        INCORRECT: "Current password is incorrect",
+        CHANGE_FAILED: "Failed to change password",
+        RESET_FAILED: "Failed to reset password",
+        TOKEN_INVALID: "Invalid or expired reset token",
+        TOKEN_EXPIRED: "Reset token has expired",
+        TOKEN_USED: "Reset token has already been used",
+        SOCIAL_PROVIDER_NO_PASSWORD: "Password change not available. You signed in with a social provider.",
+        TOO_WEAK: "Password is too weak. Please use a stronger password.",
+        SAME_AS_CURRENT: "New password must be different from current password",
+    },
+    // Email Verification Errors
+    EMAIL: {
+        SEND_FAILED: "Failed to send email. Please try again",
+        VERIFICATION_FAILED: "Failed to verify email",
+        ALREADY_VERIFIED: "Email is already verified",
+        TOKEN_INVALID: "Invalid or expired verification token",
+        TOKEN_EXPIRED: "Verification token has expired",
+        NO_EMAIL: "No email address associated with this account",
+    },
+    // File Upload Errors
+    UPLOAD: {
+        INVALID_TYPE: "Invalid file type",
+        FILE_TOO_LARGE: "File size exceeds maximum allowed",
+        UPLOAD_FAILED: "Failed to upload file",
+        UPLOAD_ERROR: "Upload error:",
+        SAVE_FAILED: "Failed to save. Upload has been rolled back",
+        SAVE_ROLLBACK: "Save failed, cleaning up:",
+        AUTH_REQUIRED: "Authentication required. Please sign in and try again",
+        DELETE_FAILED: "Failed to remove photo",
+        DELETE_OLD_FILE_FAILED: "Failed to delete old file:",
+        CLEANUP_FAILED: "Failed to cleanup uploaded file:",
+    },
+    // Generic Errors
+    GENERIC: {
+        INTERNAL_ERROR: "An unexpected error occurred. Please try again",
+        NOT_FOUND: "The requested resource was not found",
+        BAD_REQUEST: "Invalid request",
+        NETWORK_ERROR: "Network error. Please check your connection",
+        TIMEOUT: "Request timed out. Please try again",
+        UNKNOWN: "An unknown error occurred",
+        USER_ID_REQUIRED: "User ID is required",
+        PROFILE_PRIVATE: "This profile is private",
+        SERVER_CONFIG_ERROR: "Server configuration error",
+        NOT_IMPLEMENTED: "This feature is not yet implemented",
+        TRY_AGAIN: "Something went wrong. Please try again in a moment.",
+        RATE_LIMIT_EXCEEDED: "Too many requests. Please try again later.",
+        UNSAVED_CHANGES: "You have unsaved changes. Leave without saving?",
+    },
+    // Network Errors
+    NETWORK: {
+        OFFLINE: "You appear to be offline. Check your connection and try again.",
+        TIMEOUT: "The request is taking too long. Please check your connection.",
+    },
+    // Database Errors
+    DATABASE: {
+        FETCH_FAILED: "Failed to fetch data",
+        NOT_FOUND: "Record not found",
+        CONNECTION_ERROR: "Database connection error",
+    },
+    // Session Errors
+    SESSION: {
+        FETCH_FAILED: "Failed to fetch sessions",
+        FETCH_USER_PROFILE_ERROR: "Error fetching user profile",
+        FIRESTORE_SUBSCRIPTION_ERROR: "Firestore subscription error",
+        VALIDATION_FAILED: "Session validation failed",
+        SERVER_LOGOUT_ERROR: "Server logout error",
+        SIGN_OUT_ERROR: "Sign out error",
+        CREATION_ERROR: "Session creation error",
+        NOT_FOUND: "Session not found",
+        INVALID: "Invalid session",
+        ID_REQUIRED: "Session ID required",
+        INVALID_COOKIE: "Invalid session cookie",
+        REVOKED_OR_EXPIRED: "Session revoked or expired",
+        USER_NOT_FOUND_OR_DISABLED: "User not found or disabled",
+        CANNOT_REVOKE_OTHERS: "You can only revoke your own sessions",
+    },
+    // Admin Errors
+    ADMIN: {
+        REVOKE_SESSION_FAILED: "Failed to revoke session",
+        REVOKE_USER_SESSIONS_FAILED: "Failed to revoke user sessions",
+        UPDATE_USER_ROLE_FAILED: "Failed to update user role",
+        BAN_USER_FAILED: "Failed to ban user",
+        UNBAN_USER_FAILED: "Failed to unban user",
+        DELETE_USER_FAILED: "Failed to delete user",
+        LOAD_SETTINGS_FAILED: "Failed to load settings",
+        SAVE_SETTINGS_FAILED: "Failed to save settings",
+    },
+    // Review Errors
+    REVIEW: {
+        APPROVE_FAILED: "Failed to approve review",
+        REJECT_FAILED: "Failed to reject review",
+        DELETE_FAILED: "Failed to delete review",
+        APPROVE_BULK_FAILED: "Failed to approve some reviews",
+        FETCH_FAILED: "Failed to load reviews",
+        SUBMIT_FAILED: "Failed to submit review",
+        NOT_FOUND: "Review not found",
+        ALREADY_REVIEWED: "You have already reviewed this product",
+        PURCHASE_REQUIRED: "You must purchase this product before leaving a review",
+        UPDATE_NOT_ALLOWED: "You do not have permission to update this review",
+        DELETE_NOT_ALLOWED: "You do not have permission to delete this review",
+        UPDATE_FAILED: "Failed to update review",
+        VOTE_FAILED: "Failed to record vote",
+    },
+    // FAQ Errors
+    FAQ: {
+        VOTE_FAILED: "Failed to submit vote",
+        SAVE_FAILED: "Failed to save FAQ",
+        DELETE_FAILED: "Failed to delete FAQ",
+        FETCH_FAILED: "Failed to load FAQs",
+        UPDATE_FAILED: "Failed to update FAQ",
+        NOT_FOUND: "FAQ not found",
+        CREATE_FAILED: "Failed to create FAQ",
+    },
+    // Category Errors
+    CATEGORY: {
+        SAVE_FAILED: "Failed to save category",
+        DELETE_FAILED: "Failed to delete category",
+        FETCH_FAILED: "Failed to load categories",
+        UPDATE_FAILED: "Failed to update category",
+        CREATE_FAILED: "Failed to create category",
+        NOT_FOUND: "Category not found",
+        NOT_FOUND_AFTER_UPDATE: "Category not found after update",
+        HAS_CHILDREN: "Cannot delete category with children",
+        HAS_PRODUCTS: "Cannot delete category with products",
+    },
+    // Carousel Errors
+    CAROUSEL: {
+        SAVE_FAILED: "Failed to save slide",
+        DELETE_FAILED: "Failed to delete slide",
+        FETCH_FAILED: "Failed to load carousel slides",
+        UPDATE_FAILED: "Failed to update slide",
+        CREATE_FAILED: "Failed to create slide",
+        NOT_FOUND: "Carousel slide not found",
+        MAX_ACTIVE_REACHED: "Maximum 5 active carousel slides allowed",
+        REORDER_FAILED: "Failed to reorder carousel slides",
+    },
+    // Homepage Section Errors
+    SECTION: {
+        SAVE_FAILED: "Failed to save section",
+        DELETE_FAILED: "Failed to delete section",
+        FETCH_FAILED: "Failed to load sections",
+        UPDATE_FAILED: "Failed to update section",
+        CREATE_FAILED: "Failed to create section",
+        NOT_FOUND: "Homepage section not found",
+        REORDER_FAILED: "Failed to reorder homepage sections",
+    },
+    // Order Errors
+    ORDER: {
+        FETCH_FAILED: "Failed to load orders",
+        UPDATE_FAILED: "Failed to update order",
+        CREATE_FAILED: "Failed to create order",
+        CANCEL_FAILED: "Failed to cancel order",
+        NOT_FOUND: "Order not found",
+        CANNOT_CANCEL: "This order cannot be cancelled",
+    },
+    // Payout Errors
+    PAYOUT: {
+        FETCH_FAILED: "Failed to load payouts",
+        CREATE_FAILED: "Failed to create payout request",
+        UPDATE_FAILED: "Failed to update payout",
+        NOT_FOUND: "Payout not found",
+        NO_EARNINGS: "No available earnings to request a payout",
+        ALREADY_PENDING: "You already have a pending payout request",
+        INVALID_METHOD: "Invalid payment method",
+    },
+    // Product Errors
+    PRODUCT: {
+        FETCH_FAILED: "Failed to load products",
+        UPDATE_FAILED: "Failed to update product",
+        CREATE_FAILED: "Failed to create product",
+        DELETE_FAILED: "Failed to delete product",
+        NOT_FOUND: "Product not found",
+        NOT_FOUND_AFTER_UPDATE: "Product not found after update",
+        UPDATE_NOT_ALLOWED: "You do not have permission to update this product",
+        DELETE_NOT_ALLOWED: "You do not have permission to delete this product",
+        INVALID_STATUS_TRANSITION: "This status change is not allowed",
+    },
+    // Phone Errors
+    PHONE: {
+        NO_PHONE: "No phone number associated with this account",
+        ALREADY_IN_USE: "Phone number is already in use",
+        VERIFY_FAILED: "Failed to verify phone number",
+        ADD_FAILED: "Failed to add phone number",
+    },
+    // Media Errors
+    MEDIA: {
+        TRIM_FAILED: "Failed to trim video",
+        CROP_FAILED: "Failed to crop image",
+        NO_FILE: "No file provided",
+    },
+    // Address Errors
+    ADDRESS: {
+        FETCH_FAILED: "Failed to load addresses",
+        CREATE_FAILED: "Failed to add address",
+        UPDATE_FAILED: "Failed to update address",
+        DELETE_FAILED: "Failed to delete address",
+        SET_DEFAULT_FAILED: "Failed to set default address",
+        NOT_FOUND: "Address not found",
+    },
+    // Cart Errors
+    CART: {
+        FETCH_FAILED: "Failed to load cart",
+        ADD_FAILED: "Failed to add item to cart",
+        UPDATE_FAILED: "Failed to update cart item",
+        REMOVE_FAILED: "Failed to remove item from cart",
+        CLEAR_FAILED: "Failed to clear cart",
+        ITEM_NOT_FOUND: "Cart item not found",
+        PRODUCT_NOT_FOUND: "Product not found or unavailable",
+        OUT_OF_STOCK: "Product is out of stock",
+        INSUFFICIENT_STOCK: "Insufficient stock available",
+    },
+    // Checkout Errors
+    CHECKOUT: {
+        FAILED: "Failed to place order. Please try again.",
+        CART_EMPTY: "Your cart is empty",
+        ADDRESS_REQUIRED: "Please select a shipping address",
+        PRODUCT_UNAVAILABLE: "One or more products are no longer available",
+        INSUFFICIENT_STOCK: "Insufficient stock for one or more items",
+        PAYMENT_FAILED: "Payment processing failed",
+        PAYMENT_DECLINED: "Payment was declined.",
+        PAYMENT_TRACKING_INIT_FAILED: "Failed to initialise payment tracking. Please check your order status.",
+        PAYMENT_TRACKING_CONNECTION_LOST: "Payment tracking connection lost. Please check your order status.",
+        PAYMENT_TRACKING_TIMED_OUT: "Payment confirmation timed out. Please check your order status.",
+        PAYMENT_NOT_COMPLETED: "Payment was not completed. Please try again.",
+        OTP_DAILY_LIMIT: "OTP limit reached for today. Please try again tomorrow.",
+    },
+    COUPON: {
+        NOT_FOUND: "Coupon not found",
+        FETCH_FAILED: "Failed to load coupons",
+        CREATE_FAILED: "Failed to create coupon",
+        UPDATE_FAILED: "Failed to update coupon",
+        DELETE_FAILED: "Failed to delete coupon",
+        INVALID: "This coupon is invalid or has expired",
+        ALREADY_USED: "You have already used this coupon",
+        USAGE_LIMIT_REACHED: "This coupon has reached its usage limit",
+        MIN_PURCHASE_NOT_MET: "Minimum purchase amount not met for this coupon",
+        NOT_APPLICABLE: "This coupon is not applicable to your cart",
+        DUPLICATE_CODE: "A coupon with this code already exists",
+    },
+    NEWSLETTER: {
+        SUBSCRIBE_FAILED: "Failed to subscribe to newsletter",
+        INVALID_EMAIL: "Please enter a valid email address to subscribe",
+        FETCH_FAILED: "Failed to load newsletter subscribers",
+        UPDATE_FAILED: "Failed to update subscriber",
+        DELETE_FAILED: "Failed to delete subscriber",
+        NOT_FOUND: "Subscriber not found",
+    },
+    // Wishlist Errors
+    WISHLIST: {
+        FETCH_FAILED: "Failed to load wishlist",
+        ADD_FAILED: "Failed to add item to wishlist",
+        REMOVE_FAILED: "Failed to remove item from wishlist",
+        ALREADY_EXISTS: "Item is already in your wishlist",
+        NOT_FOUND: "Item not found in wishlist",
+    },
+    BID: {
+        FETCH_FAILED: "Failed to load bids",
+        CREATE_FAILED: "Failed to place bid",
+        NOT_FOUND: "Bid not found",
+        AUCTION_ENDED: "This auction has already ended",
+        AUCTION_NOT_FOUND: "Auction product not found",
+        NOT_AN_AUCTION: "This product is not an auction",
+        BID_TOO_LOW: "Your bid must be higher than the current bid",
+        OWN_AUCTION: "You cannot bid on your own auction",
+    },
+    CONTACT: {
+        SEND_FAILED: "Failed to send your message. Please try again.",
+        VALIDATION_FAILED: "Please fill in all required fields.",
+    },
+    BLOG: {
+        NOT_FOUND: "Blog post not found",
+        FETCH_FAILED: "Failed to fetch blog posts",
+        FETCH_POST_FAILED: "Failed to fetch blog post",
+        CREATE_FAILED: "Failed to create blog post",
+        UPDATE_FAILED: "Failed to update blog post",
+        DELETE_FAILED: "Failed to delete blog post",
+        SLUG_TAKEN: "A post with this slug already exists",
+    },
+    PROMOTIONS: {
+        FETCH_FAILED: "Failed to fetch promotions",
+    },
+    NOTIFICATION: {
+        NOT_FOUND: "Notification not found",
+        FETCH_FAILED: "Failed to fetch notifications",
+        CREATE_FAILED: "Failed to create notification",
+        UPDATE_FAILED: "Failed to update notification",
+        DELETE_FAILED: "Failed to delete notification",
+        COUNT_FAILED: "Failed to get unread count",
+    },
+    // API Route Errors (server-side logging)
+    API: {
+        ROUTE_ERROR: "error:", // Used as suffix: "GET /api/endpoint error:"
+        CAROUSEL_GET_ERROR: "GET /api/carousel error:",
+        CAROUSEL_POST_ERROR: "POST /api/carousel error:",
+        CAROUSEL_ID_GET_ERROR: "error:", // Template: `GET /api/carousel/${id} error:`
+        CAROUSEL_ID_PATCH_ERROR: "error:", // Template: `PATCH /api/carousel/${id} error:`
+        CAROUSEL_ID_DELETE_ERROR: "error:", // Template: `DELETE /api/carousel/${id} error:`
+        SITE_SETTINGS_GET_ERROR: "GET /api/site-settings error:",
+        SITE_SETTINGS_PATCH_ERROR: "PATCH /api/site-settings error:",
+        SITE_SETTINGS_AUDIT_LOG: "AUDIT: Admin updated site settings",
+        SETTINGS_CHANGE_NOTIFICATION_ERROR: "Failed to send settings change notification email",
+        REVIEWS_GET_ERROR: "GET /api/reviews error:",
+        REVIEW_NOTIFICATION_ERROR: "Failed to send review notification email",
+        REVIEWS_POST_ERROR: "POST /api/reviews error:",
+        REVIEWS_ID_GET_ERROR: "error:", // Template: `GET /api/reviews/${id} error:`
+        REVIEWS_ID_PATCH_ERROR: "error:", // Template: `PATCH /api/reviews/${id} error:`
+        REVIEWS_ID_DELETE_ERROR: "error:", // Template: `DELETE /api/reviews/${id} error:`
+        REVIEWS_VOTE_POST_ERROR: "error:", // Template: `POST /api/reviews/${id}/vote error:`
+        PRODUCTS_GET_ERROR: "GET /api/products error:",
+        PRODUCTS_POST_ERROR: "POST /api/products error:",
+        PRODUCTS_ID_GET_ERROR: "error:", // Template: `GET /api/products/${id} error:`
+        PRODUCTS_ID_PATCH_ERROR: "error:", // Template: `PATCH /api/products/${id} error:`
+        PRODUCTS_ID_DELETE_ERROR: "error:", // Template: `DELETE /api/products/${id} error:`
+        CART_GET_ERROR: "GET /api/cart error:",
+        CART_POST_ERROR: "POST /api/cart error:",
+        CART_ITEM_PATCH_ERROR: "error:", // Template: `PATCH /api/cart/${itemId} error:`
+        CART_ITEM_DELETE_ERROR: "error:", // Template: `DELETE /api/cart/${itemId} error:`
+        MEDIA_UPLOAD_ERROR: "POST /api/media/upload error:",
+        MEDIA_TRIM_ERROR: "POST /api/media/trim error:",
+        MEDIA_CROP_ERROR: "POST /api/media/crop error:",
+        PROFILE_UPDATE_ERROR: "Profile update error:",
+        ADMIN_SESSIONS_ERROR: "Admin sessions fetch error:",
+        LOGOUT_REVOCATION_ERROR: "Session revocation error:",
+        LOGOUT_TOKEN_ERROR: "Token revocation error:",
+    },
+    // Event errors
+    EVENT: {
+        NOT_FOUND: "Event not found",
+        FETCH_FAILED: "Failed to fetch events",
+        CREATE_FAILED: "Failed to create event",
+        UPDATE_FAILED: "Failed to update event",
+        DELETE_FAILED: "Failed to delete event",
+        ALREADY_ENTERED: "You have already submitted an entry for this event",
+        ENTRIES_CLOSED: "This event is no longer accepting entries",
+        LOGIN_REQUIRED: "You must be logged in to participate",
+        INVALID_TYPE: "Unknown event type",
+        ENTRY_REVIEW_FAILED: "Failed to update entry review status",
+        INVALID_STATUS_TRANSITION: "This status transition is not allowed",
+    },
+    // Offer errors
+    OFFER: {
+        LIMIT_REACHED: "You have reached the maximum of 3 offers for this product. Wait for the seller to update the listing.",
+        COUNTER_RANGE: "Your counter must be within 20% of the seller's counter price.",
+        NOT_COUNTERED: "There is no seller counter to respond to.",
+        ACTIVE_OFFER_EXISTS: "You already have an active offer on this product. Withdraw it before making a new one.",
+        EXPIRED: "This offer has expired and can no longer be acted on.",
+        PRODUCT_UNAVAILABLE: "This product is no longer available at the agreed price. Contact support.",
+    },
+    // AI Copilot errors
+    COPILOT: {
+        GENERATION_FAILED: "Failed to generate AI response",
+        MODEL_UNAVAILABLE: "AI model is temporarily unavailable",
+        PROMPT_TOO_LONG: "Prompt exceeds the maximum allowed length",
+        HISTORY_FAILED: "Failed to load conversation history",
+        FEEDBACK_FAILED: "Failed to save feedback",
+    },
+    // Chat errors
+    CHAT: {
+        FETCH_FAILED: "Failed to load chat",
+        SEND_FAILED: "Failed to send message",
+        ROOM_FAILED: "Failed to open chat room",
+        DELETE_FAILED: "Failed to delete chat",
+        NOT_AUTHORIZED: "You are not a participant in this chat",
+        MESSAGE_TOO_LONG: "Message exceeds the 1000 character limit",
+        TOKEN_FAILED: "Failed to obtain realtime token",
+        ADMIN_ONLY_GROUP: "Only admins can create group chats",
+    },
+    // Shipping errors
+    SHIPPING: {
+        FETCH_FAILED: "Failed to load shipping configuration",
+        UPDATE_FAILED: "Failed to save shipping configuration",
+        NOT_CONFIGURED: "Shipping is not configured for this store",
+        INVALID_METHOD: "Invalid shipping method selected",
+        CUSTOM_PRICE_REQUIRED: "A shipping price is required for custom shipping",
+        CARRIER_REQUIRED: "Carrier name is required for custom shipping",
+        PROVIDER_CREDS_REQUIRED: "Shipping provider email and password are required",
+        PROVIDER_AUTH_FAILED: "Failed to authenticate with shipping provider — check your credentials",
+        PICKUP_ADDRESS_REQUIRED: "A verified pickup address is required before shipping",
+        PICKUP_VERIFICATION_FAILED: "Pickup address OTP verification failed",
+        PICKUP_ADD_FAILED: "Failed to add pickup address with shipping provider",
+        ORDER_CREATE_FAILED: "Failed to create shipment with shipping provider",
+        AWB_ASSIGN_FAILED: "Failed to assign courier AWB number",
+        PICKUP_SCHEDULE_FAILED: "Failed to schedule pickup with shipping provider",
+        /** @deprecated Use PROVIDER_CREDS_REQUIRED */
+        SHIPROCKET_CREDS_REQUIRED: "Shipping provider email and password are required",
+        /** @deprecated Use PROVIDER_AUTH_FAILED */
+        SHIPROCKET_AUTH_FAILED: "Failed to authenticate with shipping provider — check your credentials",
+        TRACKING_FAILED: "Failed to fetch tracking details",
+        INVALID_TRACKING_URL: "Please provide a valid tracking URL",
+        CARRIER_NAME_REQUIRED: "Carrier name is required when providing tracking details",
+        ORDER_ALREADY_SHIPPED: "This order has already been marked as shipped",
+        ORDER_NOT_SHIPPABLE: "Only confirmed orders can be shipped",
+        ORDER_NOT_FOUND: "Order not found or does not belong to your store",
+    },
+    // Payout settings errors
+    PAYOUT_SETTINGS: {
+        FETCH_FAILED: "Failed to load payout settings",
+        UPDATE_FAILED: "Failed to save payout settings",
+        UPI_REQUIRED: "A valid UPI ID is required",
+        BANK_DETAILS_REQUIRED: "Complete bank account details are required",
+        INVALID_IFSC: "Please enter a valid IFSC code (e.g. HDFC0001234)",
+        INVALID_ACCOUNT_NUMBER: "Please enter a valid account number",
+    },
+    // Bulk order action errors
+    BULK_ORDER: {
+        NO_ORDERS_SELECTED: "Please select at least one order",
+        NO_ELIGIBLE_ORDERS: "None of the selected orders are eligible for a payout request",
+        PAYOUT_REQUEST_FAILED: "Failed to submit payout request for selected orders",
+        ALREADY_REQUESTED: "A payout has already been requested for some of the selected orders",
+    },
+    // Realtime Event Bridge errors (useRealtimeEvent generic defaults)
+    REALTIME: {
+        INIT_FAILED: "Failed to initialise real-time connection. Please try again.",
+        CONNECTION_LOST: "Real-time connection lost. Please try again.",
+        TIMED_OUT: "The operation timed out. Please try again.",
+        OPERATION_FAILED: "The operation did not complete. Please try again.",
+    },
+};

package/dist/errors/not-found-error.d.ts

@@ -0,0 +1,4 @@
+import { AppError } from "./base-error";
+export declare class NotFoundError extends AppError {
+    constructor(message: string, data?: unknown);
+}

package/dist/errors/not-found-error.js

@@ -0,0 +1,6 @@
+import { AppError } from "./base-error";
+export class NotFoundError extends AppError {
+    constructor(message, data) {
+        super(404, message, "NOT_FOUND", data);
+    }
+}

package/dist/errors/validation-error.d.ts

@@ -0,0 +1,4 @@
+import { AppError } from "./base-error";
+export declare class ValidationError extends AppError {
+    constructor(message: string, fields?: unknown);
+}

package/dist/errors/validation-error.js

@@ -0,0 +1,6 @@
+import { AppError } from "./base-error";
+export class ValidationError extends AppError {
+    constructor(message, fields) {
+        super(400, message, "VALIDATION_ERROR", fields);
+    }
+}

package/dist/features/about/components/AboutView.d.ts

@@ -0,0 +1,38 @@
+import React from "react";
+export interface AboutHowItem {
+    title: string;
+    text: string;
+    icon: string;
+    color?: string;
+}
+export interface AboutValueItem {
+    title: string;
+    text: string;
+    icon: string;
+}
+export interface AboutMilestone {
+    year: string;
+    text: string;
+}
+export interface AboutViewProps {
+    labels?: {
+        title?: string;
+        subtitle?: string;
+        missionTitle?: string;
+        missionText?: string;
+        howItWorksTitle?: string;
+        valuesTitle?: string;
+        milestonesTitle?: string;
+        ctaTitle?: string;
+        ctaSell?: string;
+        ctaShop?: string;
+    };
+    howItems?: AboutHowItem[];
+    valueItems?: AboutValueItem[];
+    milestones?: AboutMilestone[];
+    heroBannerClass?: string;
+    ctaBannerClass?: string;
+    /** Render the CTA action buttons  */
+    renderCtaButtons?: () => React.ReactNode;
+}
+export declare function AboutView({ labels, howItems, valueItems, milestones, heroBannerClass, ctaBannerClass, renderCtaButtons, }: AboutViewProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Heading, Section, Span, Text } from "../../../ui";
+export function AboutView({ labels = {}, howItems = [], valueItems = [], milestones = [], heroBannerClass = "bg-gradient-to-br from-violet-600 to-indigo-600", ctaBannerClass = "bg-gradient-to-br from-violet-600 to-indigo-600", renderCtaButtons, }) {
+    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", "data-section": "aboutview-div-81", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-16 md:py-20 lg:py-24`, children: _jsxs("div", { className: "max-w-4xl mx-auto px-4 sm:px-6 lg:px-8 text-center", "data-section": "aboutview-div-82", children: [_jsx(Heading, { level: 1, variant: "none", className: "text-4xl md:text-5xl font-bold mb-6 text-white", children: labels.title }), _jsx(Text, { variant: "none", className: "text-xl text-white/80 max-w-2xl mx-auto", children: labels.subtitle })] }) }), _jsxs("div", { className: "max-w-5xl mx-auto px-4 sm:px-6 lg:px-8 py-16 md:py-20 space-y-16 md:space-y-20", "data-section": "aboutview-div-83", children: [_jsxs(Section, { className: "text-center max-w-3xl mx-auto", children: [_jsx(Heading, { level: 2, className: "mb-4", children: labels.missionTitle }), _jsx(Text, { size: "lg", variant: "secondary", className: "leading-relaxed", children: labels.missionText })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-12", children: labels.howItWorksTitle }), _jsx("div", { className: "grid md:grid-cols-3 gap-6 md:gap-8", "data-section": "aboutview-div-84", children: howItems.map(({ title, text, icon, color }) => (_jsxs("div", { className: `bg-gradient-to-br ${color ?? "from-primary/5 to-primary/5"} rounded-2xl p-6 space-y-3`, "data-section": "aboutview-div-85", children: [_jsx("div", { className: "text-4xl", "data-section": "aboutview-div-86", children: icon }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-12", children: labels.valuesTitle }), _jsx("div", { className: "grid md:grid-cols-3 gap-5 md:gap-6", "data-section": "aboutview-div-87", children: valueItems.map(({ title, text, icon }) => (_jsxs("div", { className: "bg-white dark:bg-slate-800 rounded-xl p-6 space-y-3 border border-neutral-200 dark:border-slate-700", "data-section": "aboutview-div-88", children: [_jsx("div", { className: "text-3xl", "data-section": "aboutview-div-89", children: icon }), _jsx(Heading, { level: 3, children: title }), _jsx(Text, { size: "sm", variant: "secondary", className: "leading-relaxed", children: text })] }, title))) })] }), _jsxs(Section, { children: [_jsx(Heading, { level: 2, className: "text-center mb-10", children: labels.milestonesTitle }), _jsx("div", { className: "relative border-l-2 border-primary/30 pl-8 space-y-8 max-w-2xl mx-auto", "data-section": "aboutview-div-90", children: milestones.map(({ year, text }) => (_jsxs("div", { className: "relative", "data-section": "aboutview-div-91", children: [_jsx("div", { className: "absolute -left-10 top-1 w-4 h-4 rounded-full bg-primary border-2 border-white dark:border-slate-900" }), _jsx(Span, { size: "xs", weight: "bold", className: "text-primary uppercase tracking-wide", children: year }), _jsx(Text, { className: "mt-1", children: text })] }, year))) })] }), _jsxs(Section, { className: `text-center ${ctaBannerClass} rounded-2xl p-8 md:p-12 text-white`, children: [_jsx(Heading, { level: 2, variant: "none", className: "text-3xl font-bold mb-8 text-white", children: labels.ctaTitle }), renderCtaButtons ? (renderCtaButtons()) : (_jsx("div", { className: "flex justify-center gap-3 flex-wrap", "data-section": "aboutview-div-92", children: _jsxs(Span, { className: "text-white/70 text-sm", children: [labels.ctaSell, " \u00B7 ", labels.ctaShop] }) }))] })] })] }));
+}

package/dist/features/about/components/FAQPageView.d.ts

@@ -0,0 +1,6 @@
+export interface FAQPageViewProps {
+    /** If provided, filter to this category slug */
+    category?: string;
+    heroBannerClass?: string;
+}
+export declare function FAQPageView({ category, heroBannerClass, }?: FAQPageViewProps): Promise<import("react/jsx-runtime").JSX.Element>;

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

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ROUTES } from "../../../constants";
+import { THEME_CONSTANTS } from "../../../tokens";
+import { Heading, Text, Section, Stack } from "../../../ui";
+import { TextLink } from "../../../ui";
+import { HelpCircle, ChevronRight } from "lucide-react";
+const DEFAULT_HERO_CLASS = "bg-gradient-to-br from-violet-700 to-indigo-700 dark:from-violet-800 dark:to-indigo-800";
+export async function FAQPageView({ category, heroBannerClass = DEFAULT_HERO_CLASS, } = {}) {
+    const { themed, flex, page } = THEME_CONSTANTS;
+    const { getTranslations } = await import("next-intl/server");
+    const t = await getTranslations("faqs");
+    // Each FAQ namespace must export:
+    //   title, subtitle, searchPlaceholder
+    //   categories: [{ slug, label, icon }]
+    //   items (or per-category items keyed by category slug): [{ question, answer }]
+    const rawCategories = t.raw("categories");
+    const categories = Array.isArray(rawCategories) ? rawCategories : [];
+    const rawItems = t.raw("items");
+    const allItems = Array.isArray(rawItems) ? rawItems : [];
+    const visibleItems = category
+        ? allItems.filter((item) => item.category === category)
+        : allItems;
+    const activeCategory = categories.find((c) => c.slug === category);
+    return (_jsxs("div", { className: "-mx-4 md:-mx-6 lg:-mx-8 -mt-6 sm:-mt-8 lg:-mt-10", "data-section": "faqpageview-div-93", children: [_jsx(Section, { className: `${heroBannerClass} text-white py-14 md:py-16 lg:py-20`, children: _jsxs("div", { className: `${page.container.md} text-center`, "data-section": "faqpageview-div-94", children: [_jsx(Heading, { level: 1, variant: "none", className: "mb-3 text-white", children: activeCategory ? activeCategory.label : t("title") }), _jsx(Text, { variant: "none", className: "text-white/80 max-w-2xl mx-auto", children: t("subtitle") })] }) }), _jsx("div", { className: `${page.container.md} py-10 md:py-12 lg:py-16`, "data-section": "faqpageview-div-95", children: _jsxs("div", { className: "flex flex-col md:flex-row gap-8", "data-section": "faqpageview-div-96", children: [categories.length > 0 && (_jsxs("aside", { className: "md:w-56 flex-shrink-0", children: [_jsx(Heading, { level: 3, className: "text-sm font-semibold uppercase tracking-wide text-neutral-500 mb-3", children: t("categoriesLabel") }), _jsxs("nav", { className: "space-y-1", children: [_jsxs(TextLink, { href: String(ROUTES.PUBLIC.FAQS), className: `flex items-center justify-between px-3 py-2 rounded-lg text-sm transition-colors ${!category
+                                                ? "bg-primary/10 text-primary font-semibold"
+                                                : "hover:bg-neutral-100 dark:hover:bg-neutral-800"}`, children: [_jsxs("span", { className: `${flex.row} gap-2`, children: [_jsx(HelpCircle, { className: "w-4 h-4" }), t("allCategories")] }), _jsx(ChevronRight, { className: "w-3.5 h-3.5 opacity-50" })] }), categories.map((cat) => (_jsxs(TextLink, { href: String(ROUTES.PUBLIC.FAQ_CATEGORY(cat.slug)), className: `flex items-center justify-between px-3 py-2 rounded-lg text-sm transition-colors ${category === cat.slug
+                                                ? "bg-primary/10 text-primary font-semibold"
+                                                : "hover:bg-neutral-100 dark:hover:bg-neutral-800"}`, children: [_jsxs("span", { className: `${flex.row} gap-2`, children: [_jsx("span", { children: cat.icon }), cat.label] }), _jsx(ChevronRight, { className: "w-3.5 h-3.5 opacity-50" })] }, cat.slug)))] })] })), _jsxs("div", { className: "flex-1 min-w-0", "data-section": "faqpageview-div-97", children: [visibleItems.length === 0 ? (_jsxs(Section, { className: `text-center py-16 rounded-2xl border ${themed.border} ${themed.bgSecondary}`, children: [_jsx(HelpCircle, { className: "w-10 h-10 mx-auto mb-3 text-neutral-300 dark:text-neutral-600" }), _jsx(Heading, { level: 3, className: "mb-2 text-base", children: t("emptyTitle") }), _jsx(Text, { variant: "secondary", className: "text-sm", children: t("emptyText") })] })) : (_jsx(Stack, { gap: "sm", className: "space-y-3", children: visibleItems.map((item, i) => (_jsxs("details", { className: `group rounded-xl border ${themed.border} ${themed.bgPrimary} overflow-hidden`, children: [_jsxs("summary", { className: `flex items-center justify-between px-5 py-4 cursor-pointer list-none select-none font-medium text-sm hover:bg-neutral-50 dark:hover:bg-neutral-800/50 transition-colors`, children: [_jsx("span", { children: item.question }), _jsx(ChevronRight, { className: "w-4 h-4 flex-shrink-0 ml-3 transition-transform group-open:rotate-90" })] }), _jsx("div", { className: "px-5 pb-5 pt-1", "data-section": "faqpageview-div-98", children: _jsx(Text, { variant: "secondary", className: "text-sm leading-relaxed whitespace-pre-line", children: item.answer }) })] }, i))) })), _jsxs(Section, { className: `mt-10 rounded-2xl p-6 text-center border ${themed.border} ${themed.bgSecondary}`, children: [_jsx(Heading, { level: 3, className: "mb-2 text-base", children: t("stillNeedHelpTitle") }), _jsx(Text, { variant: "secondary", className: "text-sm mb-4", children: t("stillNeedHelpText") }), _jsxs("div", { className: `${flex.center} gap-4 flex-wrap`, "data-section": "faqpageview-div-99", children: [_jsx(TextLink, { href: String(ROUTES.PUBLIC.HELP), children: t("helpCenter") }), _jsx(TextLink, { href: String(ROUTES.PUBLIC.CONTACT), variant: "muted", children: t("contactUs") })] })] })] })] }) })] }));
+}

package/dist/features/about/components/FeesView.d.ts

@@ -0,0 +1,4 @@
+export interface FeesViewProps {
+    heroBannerClass?: string;
+}
+export declare function FeesView({ heroBannerClass, }?: FeesViewProps): Promise<import("react/jsx-runtime").JSX.Element>;