@mohasinac/appkit 2.4.11 → 2.5.0

package/dist/next/routing/route-map.d.ts

@@ -23,6 +23,12 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly AUCTION_DETAIL: (id: string) => string;
         readonly PRE_ORDERS: "/pre-orders";
         readonly PRE_ORDER_DETAIL: (id: string) => string;
+        readonly BUNDLES: "/bundles";
+        readonly BUNDLE_DETAIL: (slug: string) => string;
+        readonly PRIZE_DRAWS: "/prize-draws";
+        readonly PRIZE_DRAW_DETAIL: (slug: string) => string;
+        readonly SELLER_GUIDE_BUNDLES: "/seller-guide/bundles";
+        readonly SELLER_GUIDE_PRIZE_DRAWS: "/seller-guide/prize-draws";
         readonly SELLERS: "/sellers";
         readonly SELLER_DETAIL: (id: string) => string;
         readonly STORES: "/stores";
@@ -89,12 +95,14 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly SETTINGS: "/user/settings";
         readonly ORDERS: "/user/orders";
         readonly WISHLIST: "/wishlist";
+        readonly HISTORY: "/user/history";
         readonly ADDRESSES: "/user/addresses";
         readonly ADDRESSES_ADD: "/user/addresses/add";
         readonly ADDRESSES_EDIT: (id: string) => string;
         readonly ORDER_DETAIL: (id: string) => string;
         readonly ORDER_CANCEL: (id: string) => string;
         readonly ORDER_TRACK: (id: string) => string;
+        readonly ORDER_INVOICE: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
         readonly MESSAGES: "/user/messages";
         readonly BECOME_SELLER: "/user/become-seller";
@@ -104,6 +112,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly OFFERS: "/user/offers";
         readonly REVIEWS: "/user/reviews";
         readonly BIDS: "/user/bids";
+        readonly RETURNS: "/user/returns";
     };
     readonly STORE: {
         readonly DASHBOARD: "/store";
@@ -137,6 +146,16 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly SUBLISTING_CATEGORIES: "/store/sublisting-categories";
         readonly SUBLISTING_CATEGORIES_NEW: "/store/sublisting-categories/new";
         readonly SUBLISTING_CATEGORIES_EDIT: (id: string) => string;
+        readonly FEATURES: "/store/features";
+        readonly FEATURES_NEW: "/store/features/new";
+        readonly FEATURES_EDIT: (id: string) => string;
+        readonly SLUG: "/store/slug";
+        readonly BUNDLES: "/store/bundles";
+        readonly BUNDLES_NEW: "/store/bundles/new";
+        readonly BUNDLES_EDIT: (id: string) => string;
+        readonly PRIZE_DRAWS: "/store/prize-draws";
+        readonly PRIZE_DRAWS_NEW: "/store/prize-draws/new";
+        readonly PRIZE_DRAWS_EDIT: (id: string) => string;
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
@@ -145,6 +164,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly CAROUSEL: "/admin/carousel";
         readonly CAROUSEL_NEW: "/admin/carousel/new";
         readonly CAROUSEL_EDIT: (id: string) => string;
+        readonly CAROUSELS: "/admin/carousels";
+        readonly CAROUSEL_DETAIL: (id: string) => string;
         readonly SECTIONS: "/admin/sections";
         readonly NAVIGATION: "/admin/navigation";
         readonly CATEGORIES: "/admin/categories";
@@ -191,11 +212,19 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly NOTIFICATIONS: "/admin/notifications";
         readonly CARTS: "/admin/carts";
         readonly WISHLISTS: "/admin/wishlists";
+        readonly HISTORY: "/admin/history";
         readonly RETURN_REQUESTS: "/admin/return-requests";
         readonly STORE_ADDRESSES: "/admin/store-addresses";
         readonly SUBLISTING_CATEGORIES: "/admin/sublisting-categories";
         readonly SUBLISTING_CATEGORIES_NEW: "/admin/sublisting-categories/new";
         readonly SUBLISTING_CATEGORIES_EDIT: (id: string) => string;
+        readonly FEATURES: "/admin/features";
+        readonly FEATURES_NEW: "/admin/features/new";
+        readonly FEATURES_EDIT: (id: string) => string;
+        readonly BUNDLES: "/admin/bundles";
+        readonly BUNDLES_EDIT: (id: string) => string;
+        readonly PRIZE_DRAWS: "/admin/prize-draws";
+        readonly PRIZE_DRAWS_EDIT: (id: string) => string;
     };
     readonly DEMO: {
         readonly SEED: "/demo/seed";
@@ -218,6 +247,12 @@ export declare const ROUTES: {
         readonly AUCTION_DETAIL: (id: string) => string;
         readonly PRE_ORDERS: "/pre-orders";
         readonly PRE_ORDER_DETAIL: (id: string) => string;
+        readonly BUNDLES: "/bundles";
+        readonly BUNDLE_DETAIL: (slug: string) => string;
+        readonly PRIZE_DRAWS: "/prize-draws";
+        readonly PRIZE_DRAW_DETAIL: (slug: string) => string;
+        readonly SELLER_GUIDE_BUNDLES: "/seller-guide/bundles";
+        readonly SELLER_GUIDE_PRIZE_DRAWS: "/seller-guide/prize-draws";
         readonly SELLERS: "/sellers";
         readonly SELLER_DETAIL: (id: string) => string;
         readonly STORES: "/stores";
@@ -284,12 +319,14 @@ export declare const ROUTES: {
         readonly SETTINGS: "/user/settings";
         readonly ORDERS: "/user/orders";
         readonly WISHLIST: "/wishlist";
+        readonly HISTORY: "/user/history";
         readonly ADDRESSES: "/user/addresses";
         readonly ADDRESSES_ADD: "/user/addresses/add";
         readonly ADDRESSES_EDIT: (id: string) => string;
         readonly ORDER_DETAIL: (id: string) => string;
         readonly ORDER_CANCEL: (id: string) => string;
         readonly ORDER_TRACK: (id: string) => string;
+        readonly ORDER_INVOICE: (id: string) => string;
         readonly NOTIFICATIONS: "/user/notifications";
         readonly MESSAGES: "/user/messages";
         readonly BECOME_SELLER: "/user/become-seller";
@@ -299,6 +336,7 @@ export declare const ROUTES: {
         readonly OFFERS: "/user/offers";
         readonly REVIEWS: "/user/reviews";
         readonly BIDS: "/user/bids";
+        readonly RETURNS: "/user/returns";
     };
     readonly STORE: {
         readonly DASHBOARD: "/store";
@@ -332,6 +370,16 @@ export declare const ROUTES: {
         readonly SUBLISTING_CATEGORIES: "/store/sublisting-categories";
         readonly SUBLISTING_CATEGORIES_NEW: "/store/sublisting-categories/new";
         readonly SUBLISTING_CATEGORIES_EDIT: (id: string) => string;
+        readonly FEATURES: "/store/features";
+        readonly FEATURES_NEW: "/store/features/new";
+        readonly FEATURES_EDIT: (id: string) => string;
+        readonly SLUG: "/store/slug";
+        readonly BUNDLES: "/store/bundles";
+        readonly BUNDLES_NEW: "/store/bundles/new";
+        readonly BUNDLES_EDIT: (id: string) => string;
+        readonly PRIZE_DRAWS: "/store/prize-draws";
+        readonly PRIZE_DRAWS_NEW: "/store/prize-draws/new";
+        readonly PRIZE_DRAWS_EDIT: (id: string) => string;
     };
     readonly ADMIN: {
         readonly DASHBOARD: "/admin/dashboard";
@@ -340,6 +388,8 @@ export declare const ROUTES: {
         readonly CAROUSEL: "/admin/carousel";
         readonly CAROUSEL_NEW: "/admin/carousel/new";
         readonly CAROUSEL_EDIT: (id: string) => string;
+        readonly CAROUSELS: "/admin/carousels";
+        readonly CAROUSEL_DETAIL: (id: string) => string;
         readonly SECTIONS: "/admin/sections";
         readonly NAVIGATION: "/admin/navigation";
         readonly CATEGORIES: "/admin/categories";
@@ -386,11 +436,19 @@ export declare const ROUTES: {
         readonly NOTIFICATIONS: "/admin/notifications";
         readonly CARTS: "/admin/carts";
         readonly WISHLISTS: "/admin/wishlists";
+        readonly HISTORY: "/admin/history";
         readonly RETURN_REQUESTS: "/admin/return-requests";
         readonly STORE_ADDRESSES: "/admin/store-addresses";
         readonly SUBLISTING_CATEGORIES: "/admin/sublisting-categories";
         readonly SUBLISTING_CATEGORIES_NEW: "/admin/sublisting-categories/new";
         readonly SUBLISTING_CATEGORIES_EDIT: (id: string) => string;
+        readonly FEATURES: "/admin/features";
+        readonly FEATURES_NEW: "/admin/features/new";
+        readonly FEATURES_EDIT: (id: string) => string;
+        readonly BUNDLES: "/admin/bundles";
+        readonly BUNDLES_EDIT: (id: string) => string;
+        readonly PRIZE_DRAWS: "/admin/prize-draws";
+        readonly PRIZE_DRAWS_EDIT: (id: string) => string;
     };
     readonly DEMO: {
         readonly SEED: "/demo/seed";
@@ -433,6 +491,16 @@ export declare const SELLER_ROUTES: {
     readonly SUBLISTING_CATEGORIES: "/store/sublisting-categories";
     readonly SUBLISTING_CATEGORIES_NEW: "/store/sublisting-categories/new";
     readonly SUBLISTING_CATEGORIES_EDIT: (id: string) => string;
+    readonly FEATURES: "/store/features";
+    readonly FEATURES_NEW: "/store/features/new";
+    readonly FEATURES_EDIT: (id: string) => string;
+    readonly SLUG: "/store/slug";
+    readonly BUNDLES: "/store/bundles";
+    readonly BUNDLES_NEW: "/store/bundles/new";
+    readonly BUNDLES_EDIT: (id: string) => string;
+    readonly PRIZE_DRAWS: "/store/prize-draws";
+    readonly PRIZE_DRAWS_NEW: "/store/prize-draws/new";
+    readonly PRIZE_DRAWS_EDIT: (id: string) => string;
 };
 export declare const PUBLIC_ROUTES: readonly ["/", string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, "/unauthorized", "/auth/login", "/auth/register", "/auth/forgot-password", "/auth/reset-password", "/auth/verify-email"];
 export declare const PROTECTED_ROUTES: readonly [string, string, string, string, string, string, string];

package/dist/next/routing/route-map.js

@@ -10,6 +10,13 @@ export const DEFAULT_ROUTE_MAP = {
         AUCTION_DETAIL: (id) => `/auctions/${id}`,
         PRE_ORDERS: "/pre-orders",
         PRE_ORDER_DETAIL: (id) => `/pre-orders/${id}`,
+        // SB1-J — bundles + prize draws (additive, pages not yet built)
+        BUNDLES: "/bundles",
+        BUNDLE_DETAIL: (slug) => `/bundles/${slug}`,
+        PRIZE_DRAWS: "/prize-draws",
+        PRIZE_DRAW_DETAIL: (slug) => `/prize-draws/${slug}`,
+        SELLER_GUIDE_BUNDLES: "/seller-guide/bundles",
+        SELLER_GUIDE_PRIZE_DRAWS: "/seller-guide/prize-draws",
         SELLERS: "/sellers",
         SELLER_DETAIL: (id) => `/sellers/${id}`,
         STORES: "/stores",
@@ -76,12 +83,14 @@ export const DEFAULT_ROUTE_MAP = {
         SETTINGS: "/user/settings",
         ORDERS: "/user/orders",
         WISHLIST: "/wishlist",
+        HISTORY: "/user/history",
         ADDRESSES: "/user/addresses",
         ADDRESSES_ADD: "/user/addresses/add",
         ADDRESSES_EDIT: (id) => `/user/addresses/edit/${id}`,
         ORDER_DETAIL: (id) => `/user/orders/view/${id}`,
         ORDER_CANCEL: (id) => `/user/orders/${id}/cancel`,
         ORDER_TRACK: (id) => `/user/orders/${id}/track`,
+        ORDER_INVOICE: (id) => `/user/orders/${id}/invoice`,
         NOTIFICATIONS: "/user/notifications",
         MESSAGES: "/user/messages",
         BECOME_SELLER: "/user/become-seller",
@@ -91,6 +100,7 @@ export const DEFAULT_ROUTE_MAP = {
         OFFERS: "/user/offers",
         REVIEWS: "/user/reviews",
         BIDS: "/user/bids",
+        RETURNS: "/user/returns",
     },
     STORE: {
         DASHBOARD: "/store",
@@ -124,6 +134,17 @@ export const DEFAULT_ROUTE_MAP = {
         SUBLISTING_CATEGORIES: "/store/sublisting-categories",
         SUBLISTING_CATEGORIES_NEW: "/store/sublisting-categories/new",
         SUBLISTING_CATEGORIES_EDIT: (id) => `/store/sublisting-categories/${id}/edit`,
+        FEATURES: "/store/features",
+        FEATURES_NEW: "/store/features/new",
+        FEATURES_EDIT: (id) => `/store/features/${id}/edit`,
+        SLUG: "/store/slug",
+        // SB1-J — bundles + prize draws
+        BUNDLES: "/store/bundles",
+        BUNDLES_NEW: "/store/bundles/new",
+        BUNDLES_EDIT: (id) => `/store/bundles/${id}/edit`,
+        PRIZE_DRAWS: "/store/prize-draws",
+        PRIZE_DRAWS_NEW: "/store/prize-draws/new",
+        PRIZE_DRAWS_EDIT: (id) => `/store/prize-draws/${id}/edit`,
     },
     ADMIN: {
         DASHBOARD: "/admin/dashboard",
@@ -132,6 +153,8 @@ export const DEFAULT_ROUTE_MAP = {
         CAROUSEL: "/admin/carousel",
         CAROUSEL_NEW: "/admin/carousel/new",
         CAROUSEL_EDIT: (id) => `/admin/carousel/${id}/edit`,
+        CAROUSELS: "/admin/carousels",
+        CAROUSEL_DETAIL: (id) => `/admin/carousels/${id}`,
         SECTIONS: "/admin/sections",
         NAVIGATION: "/admin/navigation",
         CATEGORIES: "/admin/categories",
@@ -178,11 +201,20 @@ export const DEFAULT_ROUTE_MAP = {
         NOTIFICATIONS: "/admin/notifications",
         CARTS: "/admin/carts",
         WISHLISTS: "/admin/wishlists",
+        HISTORY: "/admin/history",
         RETURN_REQUESTS: "/admin/return-requests",
         STORE_ADDRESSES: "/admin/store-addresses",
         SUBLISTING_CATEGORIES: "/admin/sublisting-categories",
         SUBLISTING_CATEGORIES_NEW: "/admin/sublisting-categories/new",
         SUBLISTING_CATEGORIES_EDIT: (id) => `/admin/sublisting-categories/${id}/edit`,
+        FEATURES: "/admin/features",
+        FEATURES_NEW: "/admin/features/new",
+        FEATURES_EDIT: (id) => `/admin/features/${id}/edit`,
+        // SB1-J — bundles + prize draws (admin moderation)
+        BUNDLES: "/admin/bundles",
+        BUNDLES_EDIT: (id) => `/admin/bundles/${id}/edit`,
+        PRIZE_DRAWS: "/admin/prize-draws",
+        PRIZE_DRAWS_EDIT: (id) => `/admin/prize-draws/${id}/edit`,
     },
     DEMO: {
         SEED: "/demo/seed",

package/dist/providers/db-firebase/filter-aliases.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Virtual filter aliases — a clause like `listingType==auction` is expanded
+ * into one or more real Sieve clauses (`isAuction==true,isPreOrder==false`)
+ * before the model reaches the underlying Sieve processor.
+ *
+ * Pure (no firebase-admin or runtime deps) so this module is safe to import
+ * from client code. The Firebase-aware Sieve adapter in `./sieve.ts` re-exports
+ * these for backwards-compat with consumers that already imported from there.
+ *
+ * The expander receives the raw operator + value the caller used (e.g. `==`,
+ * `!=`) and the value string. Return a comma-separated Sieve clause string,
+ * or empty string to drop the clause silently.
+ */
+export type SieveFilterAlias = (value: string, operator: string) => string;
+export type SieveFilterAliases = Record<string, SieveFilterAlias>;
+/**
+ * Expand virtual filter clauses into real Sieve clauses.
+ * Pure function — exported for direct use in route helpers + unit testing.
+ */
+export declare function expandFilterAliases(filters: string | undefined, aliases: SieveFilterAliases | undefined): string | undefined;

package/dist/providers/db-firebase/filter-aliases.js

@@ -0,0 +1,29 @@
+/**
+ * Expand virtual filter clauses into real Sieve clauses.
+ * Pure function — exported for direct use in route helpers + unit testing.
+ */
+export function expandFilterAliases(filters, aliases) {
+    if (!filters || !aliases)
+        return filters;
+    const aliasKeys = Object.keys(aliases);
+    if (aliasKeys.length === 0)
+        return filters;
+    return filters
+        .split(",")
+        .map((clause) => clause.trim())
+        .filter(Boolean)
+        .map((clause) => {
+        // Match field, operator (==, !=, <=, >=, <, >, @=*, @=, _=), value.
+        const m = clause.match(/^([A-Za-z_][\w.]*)\s*(==|!=|<=|>=|<|>|@=\*?|_=)\s*(.*)$/);
+        if (!m)
+            return clause;
+        const [, field, op, value] = m;
+        const alias = aliases[field];
+        if (!alias)
+            return clause;
+        const expanded = alias(value, op);
+        return expanded || "";
+    })
+        .filter(Boolean)
+        .join(",");
+}

package/dist/providers/db-firebase/index.d.ts

@@ -26,5 +26,5 @@ import type { IDbProvider } from "../../contracts";
 export declare const firebaseDbProvider: IDbProvider;
 export { buildFirebaseClientConfig, normalizeFirebaseConfigValue, } from "./client-config";
 export type { FirebaseClientConfig } from "./client-config";
-export type { SieveModel, SieveFields, SieveFieldConfig, SieveOptions, SieveResult, FirebaseSieveFieldConfig, FirebaseSieveFields, FirebaseSieveOptions, FirebaseSieveResult, } from "./sieve";
-export { applySieveToFirestore } from "./sieve";
+export type { SieveModel, SieveFields, SieveFieldConfig, SieveOptions, SieveResult, SieveFilterAlias, SieveFilterAliases, FirebaseSieveFieldConfig, FirebaseSieveFields, FirebaseSieveOptions, FirebaseSieveResult, } from "./sieve";
+export { applySieveToFirestore, expandFilterAliases } from "./sieve";

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

@@ -38,4 +38,4 @@ export const firebaseDbProvider = {
 };
 // Firebase client config builder (for consumer app bundles)
 export { buildFirebaseClientConfig, normalizeFirebaseConfigValue, } from "./client-config";
-export { applySieveToFirestore } from "./sieve";
+export { applySieveToFirestore, expandFilterAliases } from "./sieve";

package/dist/providers/db-firebase/sieve.d.ts

@@ -19,6 +19,8 @@
  */
 import type { CollectionReference, DocumentData, Query } from "firebase-admin/firestore";
 import { FirebaseRepository } from "./base";
+import { expandFilterAliases as _expandFilterAliases, type SieveFilterAlias, type SieveFilterAliases } from "./filter-aliases";
+export { _expandFilterAliases as expandFilterAliases, type SieveFilterAlias, type SieveFilterAliases, };
 export type SieveFieldConfig = {
     /** Override the Firestore document field name. Defaults to the key name. */
     path?: string;
@@ -39,6 +41,13 @@ export interface SieveOptions {
     defaultPageSize?: number;
     maxPageSize?: number;
     throwExceptions?: boolean;
+    /**
+     * Optional virtual-field expansions applied to `model.filters` before the
+     * Sieve processor sees the string. Each entry maps an alias key to a
+     * function that returns the real Sieve clauses for that key. See
+     * `expandFilterAliases` for the parser contract.
+     */
+    aliases?: SieveFilterAliases;
 }
 export interface SieveResult<T> {
     items: T[];

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

@@ -21,29 +21,46 @@ import { SieveProcessorBase } from "@mohasinac/sievejs/services";
 import { createFirebaseAdapter } from "@mohasinac/sievejs/adapters/firebase";
 import { FirebaseRepository } from "./base";
 import { deserializeTimestamps, getFirestoreCount } from "./helpers";
+import { expandFilterAliases as _expandFilterAliases, } from "./filter-aliases";
+// Re-export the pure alias helper + types so consumers that already imported
+// from `./sieve` keep working. Anyone who only needs the alias machinery
+// should prefer importing from `./filter-aliases` directly — that path has
+// zero runtime deps and is client-safe.
+export { _expandFilterAliases as expandFilterAliases, };
 const SIEVE_DEFAULTS = {
     caseSensitive: false,
     defaultPageSize: 20,
     maxPageSize: 100,
     throwExceptions: false,
 };
+/** Apply alias expansion to a model in-place-safe (returns a new model). */
+function withAliasesExpanded(model, aliases) {
+    if (!aliases)
+        return model;
+    const expanded = _expandFilterAliases(model.filters, aliases);
+    if (expanded === model.filters)
+        return model;
+    return { ...model, filters: expanded };
+}
 /**
  * Apply Sieve DSL to a CollectionReference/Query without requiring repository subclassing.
  */
 export async function applySieveToFirestore(params) {
     const { baseQuery, model, fields, options } = params;
-    const merged = { ...SIEVE_DEFAULTS, ...(options ?? {}) };
+    const { aliases, ...rest } = options ?? {};
+    const merged = { ...SIEVE_DEFAULTS, ...rest };
+    const effective = withAliasesExpanded(model, aliases);
     const processor = new SieveProcessorBase({
         adapter: createFirebaseAdapter(),
         autoLoadConfig: false,
         options: merged,
         fields,
     });
-    const filteredQ = processor.apply(model, baseQuery, {
+    const filteredQ = processor.apply(effective, baseQuery, {
         applyPagination: false,
     });
     const total = await getFirestoreCount(filteredQ);
-    const pagedQ = processor.apply(model, baseQuery);
+    const pagedQ = processor.apply(effective, baseQuery);
     const snap = await pagedQ.get();
     const items = snap.docs.map((d) => deserializeTimestamps({ id: d.id, ...d.data() }));
     const page = Math.max(1, Number(model.page ?? 1));
@@ -68,9 +85,10 @@ export class FirebaseSieveRepository extends FirebaseRepository {
      * @param options   Override defaults or supply a pre-filtered `baseQuery`.
      */
     async sieveQuery(model, fields, options) {
-        const { baseQuery, ...sieveOptions } = options ?? {};
+        const { baseQuery, aliases, ...sieveOptions } = options ?? {};
         const merged = { ...SIEVE_DEFAULTS, ...sieveOptions };
         const base = baseQuery ?? this.getCollection();
+        const effective = withAliasesExpanded(model, aliases);
         const processor = new SieveProcessorBase({
             adapter: createFirebaseAdapter(),
             autoLoadConfig: false,
@@ -78,12 +96,12 @@ export class FirebaseSieveRepository extends FirebaseRepository {
             fields,
         });
         // Count (no docs fetched)
-        const filteredQ = processor.apply(model, base, {
+        const filteredQ = processor.apply(effective, base, {
             applyPagination: false,
         });
         const total = await getFirestoreCount(filteredQ);
         // Paginated result
-        const pagedQ = processor.apply(model, base);
+        const pagedQ = processor.apply(effective, base);
         const snap = await pagedQ.get();
         const items = snap.docs.map((d) => deserializeTimestamps({ id: d.id, ...d.data() }));
         const page = Math.max(1, Number(model.page ?? 1));

package/dist/providers/firebase-client/auth.d.ts

@@ -8,5 +8,6 @@ export declare class FirebaseClientAuthProvider implements IClientAuthProvider {
     sendPasswordResetEmail(email: string): Promise<void>;
     confirmPasswordReset(code: string, newPassword: string): Promise<void>;
     reauthenticateAndChangePassword(currentPassword: string, newPassword: string): Promise<void>;
+    reauthenticateAndSendEmailUpdateVerification(currentPassword: string, newEmail: string): Promise<void>;
     reloadCurrentUser(): Promise<void>;
 }

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

@@ -1,4 +1,4 @@
-import { applyActionCode as fbApplyActionCode, confirmPasswordReset as fbConfirmPasswordReset, EmailAuthProvider, getAuth, reauthenticateWithCredential, sendPasswordResetEmail as fbSendPasswordResetEmail, signInWithEmailAndPassword as fbSignInWithEmailAndPassword, updatePassword, } from "firebase/auth";
+import { applyActionCode as fbApplyActionCode, confirmPasswordReset as fbConfirmPasswordReset, EmailAuthProvider, getAuth, reauthenticateWithCredential, sendPasswordResetEmail as fbSendPasswordResetEmail, signInWithEmailAndPassword as fbSignInWithEmailAndPassword, updatePassword, verifyBeforeUpdateEmail, } from "firebase/auth";
 /**
  * Firebase Auth client SDK implementation of IClientAuthProvider.
  */
@@ -23,6 +23,14 @@ export class FirebaseClientAuthProvider {
         await reauthenticateWithCredential(user, credential);
         await updatePassword(user, newPassword);
     }
+    async reauthenticateAndSendEmailUpdateVerification(currentPassword, newEmail) {
+        const user = getAuth().currentUser;
+        if (!user?.email)
+            throw new Error("No authenticated user.");
+        const credential = EmailAuthProvider.credential(user.email, currentPassword);
+        await reauthenticateWithCredential(user, credential);
+        await verifyBeforeUpdateEmail(user, newEmail);
+    }
     async reloadCurrentUser() {
         await getAuth().currentUser?.reload();
     }

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

@@ -307,3 +307,12 @@ export declare function shiprocketPrintLabel(token: string, shipmentIds: number[
 /** Shiprocket tokens are valid for approx. 10 days */
 export declare const SHIPROCKET_TOKEN_TTL_MS: number;
 export declare function isShiprocketTokenExpired(expiry: Date | undefined): boolean;
+/**
+ * Public tracking URL Shiprocket exposes for every AWB. All consumers that
+ * record `trackingUrl` on an order should build it via this helper so the
+ * base URL stays single-source-of-truth.
+ */
+export declare const SHIPROCKET_TRACKING_URL_BASE = "https://shiprocket.co/tracking";
+export declare function buildShiprocketTrackingUrl(awb: string): string;
+/** Status saved on an order immediately after pickup is generated. */
+export declare const SHIPROCKET_STATUS_PICKUP_SCHEDULED = "Pickup Scheduled";

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

@@ -179,3 +179,14 @@ export function isShiprocketTokenExpired(expiry) {
         return true;
     return new Date() >= new Date(expiry);
 }
+/**
+ * Public tracking URL Shiprocket exposes for every AWB. All consumers that
+ * record `trackingUrl` on an order should build it via this helper so the
+ * base URL stays single-source-of-truth.
+ */
+export const SHIPROCKET_TRACKING_URL_BASE = "https://shiprocket.co/tracking";
+export function buildShiprocketTrackingUrl(awb) {
+    return `${SHIPROCKET_TRACKING_URL_BASE}/${encodeURIComponent(awb)}`;
+}
+/** Status saved on an order immediately after pickup is generated. */
+export const SHIPROCKET_STATUS_PICKUP_SCHEDULED = "Pickup Scheduled";

package/dist/react/hooks/use-action-dispatch.d.ts

@@ -0,0 +1,25 @@
+import { type ToastVariant } from "../../ui";
+export type DispatchAction = {
+    type: "NAVIGATE";
+    href: string;
+} | {
+    type: "OPEN_PANEL";
+    panelId: string;
+    data?: Record<string, unknown>;
+} | {
+    type: "TOAST";
+    message: string;
+    variant?: ToastVariant;
+} | {
+    type: "BULK";
+    actionId: string;
+    ids: string[];
+} | {
+    type: "COPY";
+    text: string;
+    successMessage?: string;
+};
+export interface UseActionDispatchOptions {
+    onBulk?: (actionId: string, ids: string[]) => void;
+}
+export declare function useActionDispatch(options?: UseActionDispatchOptions): (action: DispatchAction) => Promise<void>;

package/dist/react/hooks/use-action-dispatch.js

@@ -0,0 +1,30 @@
+"use client";
+import { useCallback } from "react";
+import { useRouter } from "next/navigation";
+import { useToast } from "../../ui";
+import { usePanelStore } from "../../stores/panel-store";
+export function useActionDispatch(options) {
+    const router = useRouter();
+    const { showToast } = useToast();
+    const { openPanel } = usePanelStore();
+    return useCallback(async (action) => {
+        switch (action.type) {
+            case "NAVIGATE":
+                router.push(action.href);
+                break;
+            case "OPEN_PANEL":
+                openPanel(action.panelId, action.data);
+                break;
+            case "TOAST":
+                showToast(action.message, action.variant ?? "info");
+                break;
+            case "BULK":
+                options?.onBulk?.(action.actionId, action.ids);
+                break;
+            case "COPY":
+                await navigator.clipboard.writeText(action.text);
+                showToast(action.successMessage ?? "Copied!", "success");
+                break;
+        }
+    }, [router, showToast, openPanel, options]);
+}

package/dist/react/hooks/use-panel-url-sync.d.ts

@@ -0,0 +1,15 @@
+export interface PanelUrlSync {
+    openCreatePanel: () => void;
+    openEditPanel: (id: string) => void;
+    closePanel: () => void;
+    isCreateOpen: boolean;
+    isEditOpen: boolean;
+    editId: string | null;
+}
+/**
+ * Syncs create/edit panel state with URL search params.
+ * ?panel=create → isCreateOpen=true
+ * ?panel=edit&id=xxx → isEditOpen=true, editId="xxx"
+ * Closing removes both params via router.replace (no history entry).
+ */
+export declare function usePanelUrlSync(): PanelUrlSync;

package/dist/react/hooks/use-panel-url-sync.js

@@ -0,0 +1,46 @@
+"use client";
+import { useCallback } from "react";
+import { useSearchParams, useRouter, usePathname } from "next/navigation";
+/**
+ * Syncs create/edit panel state with URL search params.
+ * ?panel=create → isCreateOpen=true
+ * ?panel=edit&id=xxx → isEditOpen=true, editId="xxx"
+ * Closing removes both params via router.replace (no history entry).
+ */
+export function usePanelUrlSync() {
+    const searchParams = useSearchParams();
+    const router = useRouter();
+    const pathname = usePathname();
+    const panelParam = searchParams.get("panel");
+    const idParam = searchParams.get("id");
+    const isCreateOpen = panelParam === "create";
+    const isEditOpen = panelParam === "edit" && !!idParam;
+    const editId = isEditOpen ? idParam : null;
+    const openCreatePanel = useCallback(() => {
+        const sp = new URLSearchParams(searchParams.toString());
+        sp.set("panel", "create");
+        sp.delete("id");
+        router.push(`${pathname}?${sp.toString()}`);
+    }, [searchParams, pathname, router]);
+    const openEditPanel = useCallback((id) => {
+        const sp = new URLSearchParams(searchParams.toString());
+        sp.set("panel", "edit");
+        sp.set("id", id);
+        router.push(`${pathname}?${sp.toString()}`);
+    }, [searchParams, pathname, router]);
+    const closePanel = useCallback(() => {
+        const sp = new URLSearchParams(searchParams.toString());
+        sp.delete("panel");
+        sp.delete("id");
+        const qs = sp.toString();
+        router.replace(qs ? `${pathname}?${qs}` : pathname);
+    }, [searchParams, pathname, router]);
+    return {
+        openCreatePanel,
+        openEditPanel,
+        closePanel,
+        isCreateOpen,
+        isEditOpen,
+        editId,
+    };
+}