@mohasinac/appkit 3.2.16 → 3.2.17

package/dist/features/wishlist/repository/user-wishlist.repository.js

@@ -8,6 +8,7 @@
  * - hard cap WISHLIST_MAX (20); idempotent re-add is a no-op; over-cap throws WishlistFullError
  * - all mutations run inside a Firestore transaction (concurrent-write safe)
  */
+import { normalizeError } from "../../../errors/normalize";
 import { getAdminDb } from "../../../providers/db-firebase";
 import { serverLogger } from "../../../monitoring";
 import { WISHLIST_COLLECTION, WISHLIST_DOC_ID, WISHLIST_MAX, } from "../../../constants/limits";
@@ -76,7 +77,8 @@ export class UserWishlistRepository {
                 const doc = await db.collection("products").doc(item.productId).get();
                 return doc.exists ? item : null;
             }
-            catch {
+            catch (_err) {
+                void normalizeError(_err);
                 return item;
             }
         }));

package/dist/features/wishlist/utils/guest-wishlist.js

@@ -1,3 +1,4 @@
+import { normalizeError } from "../../../errors/normalize";
 const DEFAULT_GUEST_WISHLIST_KEY = process.env.NEXT_PUBLIC_APP_ID
     ? `${process.env.NEXT_PUBLIC_APP_ID}_guest_wishlist`
     : "guest_wishlist";
@@ -16,7 +17,8 @@ function readItems(storage, key) {
         const parsed = JSON.parse(raw);
         return Array.isArray(parsed) ? parsed : [];
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return [];
     }
 }

package/dist/http/api-handler.js

@@ -1,3 +1,4 @@
+import { normalizeError } from "../errors/normalize";
 import { createApiHandlerFactory } from "../next";
 import { applyRateLimit } from "../security";
 import { AuthenticationError, AuthorizationError, ERROR_MESSAGES, handleApiError, } from "../errors";
@@ -22,7 +23,8 @@ function parseCookieHeader(cookieHeader) {
         try {
             result.set(key, decodeURIComponent(value));
         }
-        catch {
+        catch (_err) {
+            void normalizeError(_err);
             result.set(key, value);
         }
     }
@@ -38,7 +40,8 @@ async function getUserFromRequest(request) {
     try {
         decoded = await providers.session.verifySession(sessionCookie);
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         throw new AuthenticationError(ERROR_MESSAGES.USER.NOT_AUTHENTICATED);
     }
     const db = providers.db;

package/dist/monitoring/cache-metrics.d.ts

@@ -1,7 +1,3 @@
-/**
- * Cache Performance Metrics — pure localStorage implementation.
- * No Firebase dependencies.
- */
 interface CacheMetrics {
     hits: number;
     misses: number;

package/dist/monitoring/cache-metrics.js

@@ -2,6 +2,7 @@
  * Cache Performance Metrics — pure localStorage implementation.
  * No Firebase dependencies.
  */
+import { normalizeError } from "../errors/normalize";
 const STORAGE_KEY = "mohasinac:cache_metrics";
 const RESET_INTERVAL_MS = 3600000; // 1 hour
 function nowISO() {
@@ -40,8 +41,9 @@ export function getCacheMetrics() {
         }
         return m;
     }
-    catch {
-        return initializeMetrics();
+    catch (_err) {
+        void normalizeError(_err);
+        return initializeMetrics(); // stale or corrupt metrics record — reset to zero
     }
 }
 function saveMetrics(m) {

package/dist/monitoring/client-logger.js

@@ -7,6 +7,7 @@
  * For server-side logging use `server-logger.ts`.
  */
 import { logger } from "../core/Logger";
+import { normalizeError } from "../errors/normalize";
 import { AppError } from "../errors";
 function buildClientMeta(error, context) {
     const base = {
@@ -58,8 +59,9 @@ export const logApiError = async (endpoint, response, context) => {
     try {
         responseBody = await response.clone().json();
     }
-    catch {
-        responseBody = await response.clone().text();
+    catch (_err) {
+        void normalizeError(_err);
+        responseBody = await response.clone().text(); // response body is not JSON — read as plain text
     }
     logClientError(`API Error: ${endpoint}`, new Error(response.statusText), {
         ...context,

package/dist/monitoring/server-logger.js

@@ -74,7 +74,8 @@ function formatLogEntry(entry) {
         try {
             dataStr = `\n Data: ${JSON.stringify(sanitized, null, 2)}`;
         }
-        catch {
+        catch (_err) {
+            void normalizeError(_err);
             dataStr = `\n Data: [non-serializable — ${typeof sanitized}]`;
         }
     }
@@ -100,8 +101,8 @@ async function cleanOldLogFiles(logsDir) {
         const filesToDelete = filesWithStats.slice(0, filesWithStats.length - MAX_LOG_FILES);
         await Promise.all(filesToDelete.map((file) => unlink(file.path)));
     }
-    catch {
-        // Logger failures must never break the request path.
+    catch (_err) {
+        void normalizeError(_err); // Logger failures must never break the request path
     }
 }
 async function rotateLogFileIfNeeded(filePath) {
@@ -119,8 +120,8 @@ async function rotateLogFileIfNeeded(filePath) {
         await rename(filePath, rotatedPath);
         await cleanOldLogFiles(dir);
     }
-    catch {
-        // Logger failures must never break the request path.
+    catch (_err) {
+        void normalizeError(_err); // Logger failures must never break the request path
     }
 }
 async function writeLog(entry) {

package/dist/next/api/apiHandler.js

@@ -12,7 +12,8 @@ async function validateSchema(request, schema) {
         const data = (await request.json());
         return { validationError: false, data };
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return { validationError: false, data: undefined };
     }
 }

package/dist/next/api/routeHandler.js

@@ -66,7 +66,8 @@ async function verifySession(request) {
             ...payload.claims,
         };
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         throw Object.assign(new Error("Invalid or expired session"), {
             status: 401,
         });
@@ -150,7 +151,8 @@ export function createRouteHandler(options) {
                 try {
                     user = await verifySession(request);
                 }
-                catch {
+                catch (_err) {
+                    void normalizeError(_err);
                     // anonymous
                 }
             }
@@ -191,7 +193,8 @@ export function createRouteHandler(options) {
                 try {
                     raw = await request.json();
                 }
-                catch {
+                catch (_err) {
+                    void normalizeError(_err);
                     return errorJson(400, HTTP_ERROR_CODES.VALIDATION_FAILED, "Invalid JSON body", requestId);
                 }
                 const result = resolvedSchema.safeParse(raw);
@@ -204,7 +207,8 @@ export function createRouteHandler(options) {
                 try {
                     body = (await request.json());
                 }
-                catch {
+                catch (_err) {
+                    void normalizeError(_err);
                     return errorJson(400, HTTP_ERROR_CODES.VALIDATION_FAILED, "Invalid JSON body", requestId);
                 }
             }
@@ -214,7 +218,8 @@ export function createRouteHandler(options) {
                     const text = await request.text();
                     body = text ? JSON.parse(text) : undefined;
                 }
-                catch {
+                catch (_err) {
+                    void normalizeError(_err);
                     body = undefined;
                 }
             }

package/dist/next/middleware/pii-redactor.js

@@ -1,3 +1,4 @@
+import { normalizeError } from "../../errors/normalize";
 import { NextResponse } from "next/server";
 function maskPii(value) {
     if (value.includes("@")) {
@@ -56,7 +57,8 @@ export function createPiiRedactorMiddleware(rules) {
         try {
             body = (await response.json());
         }
-        catch {
+        catch (_err) {
+            void normalizeError(_err);
             return response;
         }
         for (const { fields, mask = true, unless } of rules) {

package/dist/next/middleware/pii-scrubber.js

@@ -1,3 +1,4 @@
+import { normalizeError } from "../../errors/normalize";
 import { NextResponse } from "next/server";
 const ENC_PREFIX = "enc:v1:";
 function scrubValue(value) {
@@ -32,7 +33,8 @@ export const piiScrubberMiddleware = async (_request, _ctx, next) => {
     try {
         body = await response.json();
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return response;
     }
     const scrubbed = scrubValue(body);

package/dist/providers/auth-firebase/helpers.js

@@ -166,7 +166,8 @@ export async function getUserFromRequest(request, findById) {
             return null;
         return findById(payload.uid);
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return null;
     }
 }

package/dist/providers/auth-firebase/session.js

@@ -70,7 +70,8 @@ export const firebaseSessionProvider = {
             const decoded = await getAdminAuthLite().verifySessionCookie(cookie, false);
             await getAdminAuthLite().revokeRefreshTokens(decoded.uid);
         }
-        catch {
+        catch (_err) {
+            void normalizeError(_err);
             // Best-effort: if cookie is already invalid, treat as already destroyed
         }
     },

package/dist/providers/db-firebase/admin.js

@@ -1,3 +1,4 @@
+import { normalizeError } from "../../errors/normalize";
 function nodePath() { return require("path"); }
 function nodeFs() { return require("fs"); }
 // process.cwd() is Node.js-only; access via module.require so the Edge
@@ -151,7 +152,8 @@ export function getAdminDb() {
         // HMR reloads and duplicate module instances.
         db.settings({ ignoreUndefinedProperties: true });
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         // Already configured — safe to ignore.
     }
     set("__mohasinac_firebase_admin_db__", db);

package/dist/providers/firebase-client/realtime.js

@@ -1,4 +1,5 @@
 import { getApps, initializeApp } from "firebase/app";
+import { normalizeError } from "../../errors/normalize";
 import { getDatabase, ref, onValue, off, } from "firebase/database";
 import { getAuth, signInWithCustomToken, signOut } from "firebase/auth";
 /**
@@ -19,7 +20,8 @@ export class FirebaseClientRealtimeProvider {
         try {
             await signOut(getAuth(this.app));
         }
-        catch {
+        catch (_err) {
+            void normalizeError(_err);
             // no-op — signing out of a secondary app can fail harmlessly
         }
     }

package/dist/providers/shipping-shiprocket/index.d.ts

@@ -1,24 +1,3 @@
-/**
- * @mohasinac/shipping-shiprocket — Shiprocket shipping API client
- *
- * Thin HTTP client for the Shiprocket REST API.
- * No credential management — caller is responsible for obtaining and
- * passing the JWT token (see your project's platform auth layer).
- *
- * API base: https://apiv2.shiprocket.in/v1/external
- *
- * @example
- * ```ts
- * import {
- * shiprocketAuthenticate,
- * shiprocketCreateOrder,
- * shiprocketTrackByAWB,
- * } from "@mohasinac/shipping-shiprocket";
- *
- * const { token } = await shiprocketAuthenticate({ email, password });
- * const order = await shiprocketCreateOrder(token, orderData);
- * ```
- */
 export interface ShiprocketAuthRequest {
     email: string;
     password: string;

package/dist/providers/shipping-shiprocket/index.js

@@ -19,6 +19,7 @@
  * const order = await shiprocketCreateOrder(token, orderData);
  * ```
  */
+import { normalizeError } from "../../errors/normalize";
 const BASE_URL = "https://apiv2.shiprocket.in/v1/external";
 // --- Internal fetch helper ----------------------------------------------------
 async function shiprocketFetch(endpoint, options = {}) {
@@ -38,7 +39,8 @@ async function shiprocketFetch(endpoint, options = {}) {
     try {
         json = JSON.parse(text);
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         throw new Error(`Shiprocket API non-JSON response ${response.status}: ${text.slice(0, 200)}`);
     }
     if (!response.ok) {

package/dist/react/contexts/SessionContext.js

@@ -146,7 +146,8 @@ export function SessionProvider({ children, initialUser, endpoints: endpointOver
                 dismissedBannerHash: data.dismissedBannerHash,
             };
         }
-        catch {
+        catch (_err) {
+            void normalizeError(_err);
             return null;
         }
     }, [ep.userProfile]);

package/dist/react/hooks/useFormStatePreservation.js

@@ -1,4 +1,5 @@
 "use client";
+import { normalizeError } from "../../errors/normalize";
 import { useEffect, useRef, useCallback } from "react";
 const PARAM_DEFAULT = "_s";
 function stripPii(values, stripFields) {
@@ -28,7 +29,8 @@ export function useFormStatePreservation({ values, onRestore, stripFields = [],
             const decoded = JSON.parse(atob(encoded));
             onRestore(decoded);
         }
-        catch {
+        catch (_err) {
+            void normalizeError(_err);
             // ignore corrupt payloads
         }
     }, [paramName, onRestore]);

package/dist/seed/seed-market-config.js

@@ -1,6 +1,7 @@
 // appkit/src/seed/seed-market-config.ts
 // Locale-specific data pools for seed factories and fixtures.
 // Default pools match current letitrip.in baseline (Indian market).
+import { normalizeError } from "../errors/normalize";
 import { getMarketProfile, getDefaultCurrency, getDefaultCurrencySymbol, getDefaultPhonePrefix, getDefaultCountry, } from "../core/baseline-resolver";
 // ---------------------------------------------------------------------------
 // Re-export baseline accessors for convenience within seed layer
@@ -167,7 +168,8 @@ export function formatSeedPrice(amount) {
             maximumFractionDigits: 0,
         }).format(amount);
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         // Fallback if Intl is unavailable or currency unknown
         return `${profile.currencySymbol}${amount.toLocaleString()}`;
     }

package/dist/ui/components/ClaimCouponButton.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { normalizeError } from "../../errors/normalize";
 /**
  * ClaimCouponButton — surfaced anywhere a user wins or earns a coupon
  * (SpinWheel "YOU WON" panel, raffle winner page, prize-draw reveal modal,
@@ -33,7 +34,8 @@ async function postClaim(couponCode, source) {
         });
         return res.ok;
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return false;
     }
 }
@@ -45,7 +47,8 @@ async function copyToClipboard(text) {
         await navigator.clipboard.writeText(text);
         return true;
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return false;
     }
 }

package/dist/ui/components/NavigationLoader.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { normalizeError } from "../../errors/normalize";
 import { useEffect, useRef, useState } from "react";
 import { usePathname, useSearchParams } from "next/navigation";
 import { Spinner } from "./Spinner";
@@ -102,7 +103,8 @@ export function NavigationLoader({ spinnerVariant = "pokeball", label = "Loading
                     return false;
                 return true;
             }
-            catch {
+            catch (_err) {
+                void normalizeError(_err);
                 return true;
             }
         }
@@ -115,7 +117,8 @@ export function NavigationLoader({ spinnerVariant = "pokeball", label = "Loading
                     const nextUrl = new URL(href, window.location.href);
                     showOverlay(`${nextUrl.pathname}?${nextUrl.searchParams.toString()}`);
                 }
-                catch {
+                catch (_err) {
+                    void normalizeError(_err);
                     showOverlay();
                 }
             }

package/dist/utils/id-generators.js

@@ -6,6 +6,7 @@
  * duplicating generator logic.
  */
 import { slugify } from "./string.formatter";
+import { normalizeError } from "../errors/normalize";
 function generateRandomString(length = 6) {
     const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
     const indices = new Uint8Array(length);
@@ -144,7 +145,8 @@ export async function idExists(getExistingId) {
         const doc = await getExistingId();
         return !!doc;
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return false;
     }
 }

package/dist/utils/string.formatter.d.ts

@@ -1,6 +1,3 @@
-/**
- * String Formatting and Manipulation Utilities
- */
 export declare function capitalize(str: string): string;
 export declare function capitalizeWords(str: string): string;
 export declare function truncate(str: string, maxLength: number, suffix?: string): string;

package/dist/utils/string.formatter.js

@@ -1,6 +1,7 @@
 /**
  * String Formatting and Manipulation Utilities
  */
+import { normalizeError } from "../errors/normalize";
 export function capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
 }
@@ -137,7 +138,8 @@ export function proseMirrorToHtml(value) {
         }
         return value;
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return value;
     }
 }

package/dist/validation/schemas.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { normalizeError } from "../errors/normalize";
 // ============================================
 // COMMON SCHEMAS
 // ============================================
@@ -29,7 +30,8 @@ export const mediaUrlSchema = z
         const { hostname } = new URL(url);
         return APPROVED_MEDIA_DOMAINS.some((domain) => hostname === domain || hostname.endsWith(`.${domain}`));
     }
-    catch {
+    catch (_err) {
+        void normalizeError(_err);
         return false;
     }
 }, { message: "Image or video URL must be hosted on an approved CDN domain" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "3.2.16",
+  "version": "3.2.17",
   "license": "MIT",
   "publishConfig": {
     "access": "public"