@mohasinac/appkit 3.8.1 → 3.9.0

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

@@ -1,139 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { makeMockDb, makeSnap } from "../../../../../tests/helpers/mock-firestore";
-const { db, mockDocRef, mockCollection, mockTxn } = makeMockDb();
-vi.mock("../../../../providers/db-firebase", () => ({
-    getAdminDb: () => db,
-}));
-vi.mock("../../../../monitoring", () => ({
-    serverLogger: { info: vi.fn(), warn: vi.fn(), error: vi.fn() },
-}));
-import { UserWishlistRepository, WishlistFullError } from "../user-wishlist.repository";
-import { WISHLIST_MAX } from "../../../../constants/limits";
-const repo = new UserWishlistRepository();
-function makeItems(count) {
-    return Array.from({ length: count }, (_, i) => ({
-        productId: `product-${i}`,
-        addedAt: new Date(),
-    }));
-}
-beforeEach(() => {
-    vi.clearAllMocks();
-    // Reset collection chain so tests that override db.collection don't leak
-    db.collection.mockReturnValue(mockCollection);
-    mockCollection.doc.mockReturnValue(mockDocRef);
-    // Default: runTransaction calls through
-    db.runTransaction.mockImplementation(async (fn) => fn(mockTxn));
-    // Default: doc.get returns non-existent snap
-    mockDocRef.get.mockResolvedValue(makeSnap(null));
-    mockDocRef.set.mockResolvedValue(undefined);
-    mockTxn.get.mockResolvedValue(makeSnap(null));
-    mockTxn.set.mockResolvedValue(undefined);
-});
-describe("UserWishlistRepository.addItem", () => {
-    it("adds first item: count = 1, no error", async () => {
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "user-1", items: [], updatedAt: new Date() }));
-        const count = await repo.addItem("user-1", "product-new");
-        expect(count).toBe(1);
-        expect(mockTxn.set).toHaveBeenCalledOnce();
-    });
-    it("19 items → adds item, count = 20, no error", async () => {
-        const items = makeItems(19);
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items, updatedAt: new Date() }));
-        const count = await repo.addItem("u", "product-20");
-        expect(count).toBe(20);
-    });
-    it("20 items + new productId → throws WishlistFullError with current=20, limit=20", async () => {
-        const items = makeItems(WISHLIST_MAX);
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items, updatedAt: new Date() }));
-        await expect(repo.addItem("u", "product-new")).rejects.toBeInstanceOf(WishlistFullError);
-        const err = await repo.addItem("u", "product-new").catch((e) => e);
-        if (err instanceof WishlistFullError) {
-            expect(err.current).toBe(WISHLIST_MAX);
-            expect(err.limit).toBe(WISHLIST_MAX);
-        }
-    });
-    it("20 items + same productId (existing) → idempotent no-op, returns existing count", async () => {
-        const items = makeItems(WISHLIST_MAX);
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items, updatedAt: new Date() }));
-        const count = await repo.addItem("u", "product-0"); // already in list
-        expect(count).toBe(WISHLIST_MAX);
-        expect(mockTxn.set).not.toHaveBeenCalled();
-    });
-    it("5 items + existing productId → idempotent no-op, count remains 5", async () => {
-        const items = makeItems(5);
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items, updatedAt: new Date() }));
-        const count = await repo.addItem("u", "product-3"); // already in list
-        expect(count).toBe(5);
-        expect(mockTxn.set).not.toHaveBeenCalled();
-    });
-    it("uses db.runTransaction for every add", async () => {
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items: [], updatedAt: new Date() }));
-        await repo.addItem("u", "product-x");
-        expect(db.runTransaction).toHaveBeenCalledOnce();
-    });
-    it("stores productType in the item", async () => {
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items: [], updatedAt: new Date() }));
-        await repo.addItem("u", "product-x", { productType: "auction" });
-        const setCall = mockTxn.set.mock.calls[0][1];
-        expect(setCall.items[0].productType).toBe("auction");
-    });
-});
-describe("UserWishlistRepository.removeItem", () => {
-    it("removes existing productId, count decrements", async () => {
-        const items = [
-            { productId: "product-0", addedAt: new Date() },
-            { productId: "product-1", addedAt: new Date() },
-        ];
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items, updatedAt: new Date() }));
-        await repo.removeItem("u", "product-0");
-        const setCall = mockTxn.set.mock.calls[0][1];
-        expect(setCall.items).toHaveLength(1);
-        expect(setCall.items[0].productId).toBe("product-1");
-    });
-    it("non-existent productId → no-op, set not called", async () => {
-        const items = [{ productId: "product-0", addedAt: new Date() }];
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items, updatedAt: new Date() }));
-        await repo.removeItem("u", "product-xxx");
-        expect(mockTxn.set).not.toHaveBeenCalled();
-    });
-    it("uses db.runTransaction", async () => {
-        mockTxn.get.mockResolvedValue(makeSnap({ userId: "u", items: [], updatedAt: new Date() }));
-        await repo.removeItem("u", "product-x");
-        expect(db.runTransaction).toHaveBeenCalledOnce();
-    });
-});
-describe("UserWishlistRepository.isInWishlist", () => {
-    it("productId in items array → returns true", async () => {
-        const items = [{ productId: "product-0", addedAt: new Date() }];
-        // First get: wishlist doc; second get: product exists check in filterExistingProducts
-        mockDocRef.get
-            .mockResolvedValueOnce(makeSnap({ userId: "u", items, updatedAt: new Date() }))
-            .mockResolvedValue(makeSnap({ id: "product-0" }, "product-0"));
-        const result = await repo.isInWishlist("u", "product-0");
-        expect(result).toBe(true);
-    });
-    it("productId not in items array → returns false", async () => {
-        mockDocRef.get.mockResolvedValue(makeSnap({ userId: "u", items: [], updatedAt: new Date() }));
-        const result = await repo.isInWishlist("u", "product-xxx");
-        expect(result).toBe(false);
-    });
-});
-describe("UserWishlistRepository.countByUser", () => {
-    it("returns items.length from stored document", async () => {
-        const items = makeItems(7);
-        mockDocRef.get.mockResolvedValue(makeSnap({ userId: "u", items, updatedAt: new Date() }));
-        const count = await repo.countByUser("u");
-        expect(count).toBe(7);
-    });
-    it("returns 0 for user with no document", async () => {
-        mockDocRef.get.mockResolvedValue(makeSnap(null));
-        const count = await repo.countByUser("u");
-        expect(count).toBe(0);
-    });
-});
-describe("UserWishlistRepository.clearWishlist", () => {
-    it("sets items: [] without deleting the document", async () => {
-        await repo.clearWishlist("u");
-        expect(mockDocRef.set).toHaveBeenCalledWith(expect.objectContaining({ items: [] }));
-    });
-});

package/dist/features/wishlist/repository/wishlist.repository.d.ts

@@ -1,13 +0,0 @@
-import type { IRepository, PagedResult, SieveQuery } from "../../../contracts";
-import type { WishlistItem } from "../types";
-export declare class WishlistRepository {
-    private readonly repo;
-    constructor(repo: IRepository<WishlistItem>);
-    findByUser(userId: string): Promise<WishlistItem[]>;
-    findAll(query?: SieveQuery): Promise<PagedResult<WishlistItem>>;
-    findById(id: string): Promise<WishlistItem | null>;
-    add(data: Omit<WishlistItem, "id">): Promise<WishlistItem>;
-    remove(id: string): Promise<void>;
-    update(id: string, data: Partial<WishlistItem>): Promise<WishlistItem>;
-    delete(id: string): Promise<void>;
-}

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

@@ -1,31 +0,0 @@
-export class WishlistRepository {
-    constructor(repo) {
-        this.repo = repo;
-    }
-    async findByUser(userId) {
-        const result = await this.repo.findAll({
-            filters: `userId==${userId}`,
-            sort: "-addedAt",
-            perPage: 200,
-        });
-        return result.data;
-    }
-    async findAll(query) {
-        return this.repo.findAll(query ?? {});
-    }
-    async findById(id) {
-        return this.repo.findById(id);
-    }
-    async add(data) {
-        return this.repo.create(data);
-    }
-    async remove(id) {
-        return this.repo.delete(id);
-    }
-    async update(id, data) {
-        return this.repo.update(id, data);
-    }
-    async delete(id) {
-        return this.repo.delete(id);
-    }
-}

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

@@ -1 +0,0 @@
-export {};

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

@@ -1,93 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { expandFilterAliases } from "../filter-aliases";
-describe("expandFilterAliases", () => {
-    it("returns undefined when filters is undefined", () => {
-        const aliases = { scope: () => "status==active" };
-        expect(expandFilterAliases(undefined, aliases)).toBeUndefined();
-    });
-    it("returns filters unchanged when aliases is undefined", () => {
-        expect(expandFilterAliases("status==active", undefined)).toBe("status==active");
-    });
-    it("returns filters unchanged when aliases is empty object", () => {
-        expect(expandFilterAliases("status==active", {})).toBe("status==active");
-    });
-    it("expands a single alias clause", () => {
-        const aliases = {
-            scope: (value) => value === "publicAuctions" ? "status==published,listingType==auction" : "",
-        };
-        expect(expandFilterAliases("scope==publicAuctions", aliases)).toBe("status==published,listingType==auction");
-    });
-    it("passes the operator to the alias function", () => {
-        const received = [];
-        const aliases = {
-            myField: (value, op) => {
-                received.push({ value, op });
-                return "x==1";
-            },
-        };
-        expandFilterAliases("myField!=foo", aliases);
-        expect(received).toEqual([{ value: "foo", op: "!=" }]);
-    });
-    it("expands an alias and passes through unknown clauses", () => {
-        const aliases = {
-            scope: () => "status==published,listingType==auction",
-        };
-        const result = expandFilterAliases("scope==publicAuctions,storeId==store-abc", aliases);
-        expect(result).toBe("status==published,listingType==auction,storeId==store-abc");
-    });
-    it("passes through a clause whose field has no alias", () => {
-        const aliases = { scope: () => "status==active" };
-        expect(expandFilterAliases("category==brand-pokemon", aliases)).toBe("category==brand-pokemon");
-    });
-    it("drops a clause when the alias returns empty string", () => {
-        const aliases = {
-            scope: () => "",
-        };
-        expect(expandFilterAliases("scope==unknown", aliases)).toBe("");
-    });
-    it("drops an empty-expansion clause while keeping other clauses", () => {
-        const aliases = {
-            scope: (value) => (value === "known" ? "status==active" : ""),
-        };
-        const result = expandFilterAliases("scope==notknown,listingType==standard", aliases);
-        expect(result).toBe("listingType==standard");
-    });
-    it("handles multiple alias fields in one filter string", () => {
-        const aliases = {
-            scope: () => "status==active",
-            type: () => "listingType==auction",
-        };
-        const result = expandFilterAliases("scope==any,type==any", aliases);
-        expect(result).toBe("status==active,listingType==auction");
-    });
-    it("trims whitespace around clauses", () => {
-        const aliases = { scope: () => "status==active" };
-        const result = expandFilterAliases(" scope==x , name==foo ", aliases);
-        expect(result).toBe("status==active,name==foo");
-    });
-    it("passes through a clause that does not match the operator pattern", () => {
-        const aliases = { scope: () => "status==active" };
-        // A malformed clause has no operator — should pass through unchanged
-        expect(expandFilterAliases("malformed", aliases)).toBe("malformed");
-    });
-    it("handles @= operator", () => {
-        const received = [];
-        const aliases = {
-            tags: (_v, op) => { received.push(op); return "tags@=value"; },
-        };
-        expandFilterAliases("tags@=value", aliases);
-        expect(received[0]).toBe("@=");
-    });
-    it("handles @=* operator", () => {
-        const received = [];
-        const aliases = {
-            tags: (_v, op) => { received.push(op); return "tags@=*value"; },
-        };
-        expandFilterAliases("tags@=*value", aliases);
-        expect(received[0]).toBe("@=*");
-    });
-    it("returns empty string when all clauses expand to empty", () => {
-        const aliases = { scope: () => "" };
-        expect(expandFilterAliases("scope==x", aliases)).toBe("");
-    });
-});

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

@@ -1,297 +0,0 @@
-export interface ShiprocketAuthRequest {
-    email: string;
-    password: string;
-}
-export interface ShiprocketAuthResponse {
-    token: string;
-    message: string;
-    data?: {
-        id: number;
-        email: string;
-        name: string;
-        company_id: number;
-    };
-}
-export interface ShiprocketPickupLocation {
-    id: number;
-    pickup_location: string;
-    add: string;
-    add2?: string;
-    city: string;
-    state: string;
-    country: string;
-    pin_code: string;
-    phone: string;
-    email: string;
-    name: string;
-    phone_verified?: number;
-}
-export interface ShiprocketPickupLocationsResponse {
-    shipping_address: ShiprocketPickupLocation[];
-}
-export interface ShiprocketAddPickupRequest {
-    pickup_location: string;
-    name: string;
-    email: string;
-    phone: string;
-    address: string;
-    address_2?: string;
-    city: string;
-    state: string;
-    country: string;
-    pin_code: string;
-}
-export interface ShiprocketAddPickupResponse {
-    success: boolean;
-    address?: {
-        pickup_location_id: number;
-        name: string;
-        phone: string;
-        address: string;
-        city: string;
-        state: string;
-        country: string;
-        pin_code: string;
-    };
-    message?: string;
-}
-export interface ShiprocketVerifyPickupOTPRequest {
-    otp: number;
-    pickup_location_id: number;
-}
-export interface ShiprocketVerifyPickupOTPResponse {
-    success: boolean;
-    message: string;
-}
-export interface ShiprocketOrderItem {
-    name: string;
-    sku: string;
-    units: number;
-    selling_price: number;
-    discount?: number;
-    tax?: string;
-    hsn?: number;
-}
-export interface ShiprocketCreateOrderRequest {
-    order_id: string;
-    order_date: string;
-    pickup_location: string;
-    billing_customer_name: string;
-    billing_last_name?: string;
-    billing_address: string;
-    billing_address_2?: string;
-    billing_city: string;
-    billing_pincode: string;
-    billing_state: string;
-    billing_country: string;
-    billing_email: string;
-    billing_phone: string;
-    shipping_is_billing: boolean;
-    shipping_customer_name?: string;
-    shipping_last_name?: string;
-    shipping_address?: string;
-    shipping_address_2?: string;
-    shipping_city?: string;
-    shipping_pincode?: string;
-    shipping_state?: string;
-    shipping_country?: string;
-    shipping_phone?: string;
-    order_items: ShiprocketOrderItem[];
-    payment_method: "Prepaid" | "COD";
-    sub_total: number;
-    length: number;
-    breadth: number;
-    height: number;
-    weight: number;
-}
-export interface ShiprocketCreateOrderResponse {
-    order_id: number;
-    shipment_id: number;
-    status: string;
-    status_code: number;
-    onboarding_completed_now: boolean;
-    awb_code?: string;
-    courier_company_id?: number;
-    courier_name?: string;
-}
-export interface ShiprocketGenerateAWBRequest {
-    shipment_id: number;
-    courier_id?: number;
-}
-export interface ShiprocketAWBResponse {
-    awb_code: string;
-    courier_company_id: number;
-    courier_name: string;
-    shipment_id: number;
-    assigned_date_time: string;
-    expected_delivery: string;
-    tracking_url?: string;
-}
-export interface ShiprocketGeneratePickupRequest {
-    shipment_id: number[];
-    pickup_date?: string[];
-}
-export interface ShiprocketPickupResponse {
-    pickup_scheduled_date?: string;
-    pickup_token_number?: string;
-    status: number;
-    others?: string;
-}
-export interface ShiprocketTrackActivity {
-    date: string;
-    status: string;
-    activity: string;
-    location: string;
-    sr_status?: string;
-    sr_status_label?: string;
-}
-export interface ShiprocketShipmentTrack {
-    id: number;
-    awb_code: string;
-    courier_company_id: number;
-    shipment_id: number;
-    order_id: number;
-    pickup_date?: string;
-    delivered_date?: string;
-    weight: string;
-    current_status: string;
-    edd?: string;
-    shipment_track_activities: ShiprocketTrackActivity[];
-}
-export interface ShiprocketTrackingResponse {
-    tracking_data: {
-        awb_track_url: string;
-        track_url: string;
-        current_status: string;
-        current_status_id: number;
-        shipment_status: number;
-        shipment_track: ShiprocketShipmentTrack[];
-        shipment_track_activities: ShiprocketTrackActivity[];
-        error?: string;
-        cod?: boolean;
-    };
-}
-export interface ShiprocketCourierServiceabilityResponse {
-    data?: {
-        available_courier_companies: Array<{
-            id: number;
-            name: string;
-            etd: string;
-            rate: number;
-            cod_charges?: number;
-        }>;
-    };
-    status: number;
-    message?: string;
-}
-export interface ShiprocketCancelOrderResponse {
-    message: string;
-    status: number;
-}
-export interface ShiprocketOrderDetailResponse {
-    data?: {
-        shipments?: Array<{
-            id: number;
-            awb: string;
-            status: string;
-        }>;
-    };
-}
-export interface ShiprocketLabelResponse {
-    label_created: number;
-    label_url: string;
-    others?: string;
-}
-export interface ShiprocketWebhookPayload {
-    awb: string;
-    order_id: string;
-    shipment_id: string;
-    current_status: string;
-    current_status_id: number;
-    courier_agent_assigned?: boolean;
-    etd?: string;
-    pickup_generated?: boolean;
-}
-export { ShiprocketProvider } from "./shiprocket-provider";
-export type { ShiprocketProviderConfig } from "./shiprocket-provider";
-/**
- * @deprecated Use `ShiprocketProvider.authenticate()` instead.
- * @internal
- */
-export declare function shiprocketAuthenticate(credentials: ShiprocketAuthRequest): Promise<ShiprocketAuthResponse>;
-/**
- * @deprecated Use `ShiprocketProvider.getPickupLocations()` instead.
- * @internal
- */
-export declare function shiprocketGetPickupLocations(token: string): Promise<ShiprocketPickupLocationsResponse>;
-/**
- * @deprecated Use `ShiprocketProvider.addPickupLocation()` instead.
- * @internal
- */
-export declare function shiprocketAddPickupLocation(token: string, data: ShiprocketAddPickupRequest): Promise<ShiprocketAddPickupResponse>;
-/**
- * @deprecated Use `ShiprocketProvider.verifyPickupOTP()` instead.
- * @internal
- */
-export declare function shiprocketVerifyPickupOTP(token: string, data: ShiprocketVerifyPickupOTPRequest): Promise<ShiprocketVerifyPickupOTPResponse>;
-/**
- * @deprecated Use `ShiprocketProvider.createShipment()` instead.
- * @internal
- */
-export declare function shiprocketCreateOrder(token: string, order: ShiprocketCreateOrderRequest): Promise<ShiprocketCreateOrderResponse>;
-/**
- * @deprecated Use `ShiprocketProvider.createShipment()` instead (generates AWB internally).
- * @internal
- */
-export declare function shiprocketGenerateAWB(token: string, params: ShiprocketGenerateAWBRequest): Promise<ShiprocketAWBResponse>;
-/**
- * @deprecated Use `ShiprocketProvider.createShipment()` instead (schedules pickup internally).
- * @internal
- */
-export declare function shiprocketGeneratePickup(token: string, params: ShiprocketGeneratePickupRequest): Promise<ShiprocketPickupResponse>;
-/**
- * @deprecated Use `ShiprocketProvider.trackShipment()` instead.
- * @internal
- */
-export declare function shiprocketTrackByAWB(token: string, awb: string): Promise<ShiprocketTrackingResponse>;
-/**
- * @deprecated Use `ShiprocketProvider.checkServiceability()` instead.
- * @internal
- */
-export declare function shiprocketCheckServiceability(token: string, paramsOrPickup: {
-    pickup_postcode: string;
-    delivery_postcode: string;
-    weight: number;
-    cod?: 0 | 1;
-} | string, deliveryPostcode?: string, weight?: number, cod?: boolean): Promise<ShiprocketCourierServiceabilityResponse>;
-/**
- * Cancel one or more Shiprocket orders by their order IDs.
- * @deprecated Use `ShiprocketProvider.cancelShipment()` instead.
- * @internal
- */
-export declare function shiprocketCancelOrder(token: string, orderIds: number[]): Promise<ShiprocketCancelOrderResponse>;
-/**
- * Fetch full order details (including nested shipment IDs) for a Shiprocket order.
- * @deprecated Use `ShiprocketProvider.generateLabel()` instead (calls this internally).
- * @internal
- */
-export declare function shiprocketGetOrderDetail(token: string, orderId: number): Promise<ShiprocketOrderDetailResponse>;
-/**
- * Request a shipping label PDF for one or more Shiprocket shipment IDs.
- * Returns a label URL — fetch that URL separately to get the raw PDF bytes.
- * @deprecated Use `ShiprocketProvider.generateLabel()` instead.
- * @internal
- */
-export declare function shiprocketPrintLabel(token: string, shipmentIds: number[]): Promise<ShiprocketLabelResponse>;
-/** 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";