@mohasinac/appkit 2.2.0 → 2.3.1

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

@@ -1,11 +1,29 @@
-import "server-only";
+/**
+ * FirebaseRepository<T>
+ *
+ * Generic abstract base class implementing `IRepository<T>` from
+ * `@mohasinac/contracts` against Firebase Firestore (Admin SDK).
+ *
+ * Usage:
+ * ```ts
+ * import { FirebaseRepository } from "@mohasinac/db-firebase";
+ * import type { Product } from "@/types";
+ *
+ * export class ProductRepository extends FirebaseRepository<Product> {
+ *   constructor() { super("products"); }
+ * }
+ * ```
+ *
+ * `findAll(query?)` maps the provider-agnostic `SieveQuery` from
+ * `@mohasinac/contracts` to Firestore native queries (no in-memory fan-out).
+ */
 import { getAdminDb } from "./admin";
-import { prepareForFirestore, deserializeTimestamps } from "./helpers";
+import { prepareForFirestore, deserializeTimestamps, getFirestoreCount, } from "./helpers";
 export class FirebaseRepository {
     constructor(collectionName) {
         this.collection = collectionName;
     }
-    // ── Internals ──────────────────────────────────────────────────────────────
+    // -- Internals --------------------------------------------------------------
     get db() {
         return getAdminDb();
     }
@@ -19,7 +37,7 @@ export class FirebaseRepository {
             ...(snap.data() ?? {}),
         });
     }
-    // ── IReadRepository ────────────────────────────────────────────────────────
+    // -- IReadRepository --------------------------------------------------------
     async findById(id) {
         const snap = await this.getCollection().doc(id).get();
         if (!snap.exists)
@@ -30,7 +48,7 @@ export class FirebaseRepository {
         const page = Math.max(1, query?.page ?? 1);
         const perPage = Math.max(1, Math.min(query?.perPage ?? 20, 500));
         let q = this.getCollection();
-        // ── Sort ──────────────────────────────────────────────────────────────────
+        // -- Sort ------------------------------------------------------------------
         // SieveQuery.sort supports a leading "-" prefix for descending order
         // (e.g. "-createdAt" means ORDER BY createdAt DESC).
         if (query?.sort) {
@@ -44,14 +62,24 @@ export class FirebaseRepository {
                     : "asc";
             q = q.orderBy(sortField, sortDir);
         }
-        // ── Basic Sieve filter parsing ────────────────────────────────────────────
-        // Supports: ==, !=, <, <=, >, >=, @= (array-contains)
+        // -- Basic Sieve filter parsing --------------------------------------------
+        // Supports: ==, !=, <, <=, >, >=, @= (array-contains), @=* (prefix/starts-with)
         if (query?.filters) {
             const clauses = query.filters
                 .split(",")
                 .map((s) => s.trim())
                 .filter(Boolean);
             for (const clause of clauses) {
+                // Try @=* (string prefix) before the generic @= match
+                const prefixMatch = clause.match(/^([^<>=!@]+)\s*@=\*\s*(.+)$/);
+                if (prefixMatch) {
+                    const field = prefixMatch[1].trim();
+                    const prefix = prefixMatch[2].trim();
+                    q = q
+                        .where(field, ">=", prefix)
+                        .where(field, "<=", prefix + "");
+                    continue;
+                }
                 const match = clause.match(/^([^<>=!@]+)\s*(==|!=|<=|>=|<|>|@=)\s*(.+)$/);
                 if (!match)
                     continue;
@@ -62,10 +90,9 @@ export class FirebaseRepository {
                 q = q.where(field, op, value);
             }
         }
-        // ── Count ─────────────────────────────────────────────────────────────────
-        const countSnap = await q.count().get();
-        const total = countSnap.data().count;
-        // ── Paginate ──────────────────────────────────────────────────────────────
+        // -- Count -----------------------------------------------------------------
+        const total = await getFirestoreCount(q);
+        // -- Paginate --------------------------------------------------------------
         const offset = (page - 1) * perPage;
         const pagedSnap = await q.offset(offset).limit(perPage).get();
         const data = pagedSnap.docs.map((d) => this.mapDoc(d));
@@ -78,7 +105,7 @@ export class FirebaseRepository {
             .get();
         return snap.docs.map((d) => this.mapDoc(d));
     }
-    // ── IWriteRepository ───────────────────────────────────────────────────────
+    // -- IWriteRepository -------------------------------------------------------
     async create(data) {
         const now = new Date();
         const payload = prepareForFirestore({
@@ -131,7 +158,7 @@ export class FirebaseRepository {
         }
         await batch.commit();
     }
-    // ── Extended helpers (not in IRepository contract) ────────────────────────
+    // -- Extended helpers (not in IRepository contract) ------------------------
     /** Find by ID or throw `Error` with a descriptive message. */
     async findByIdOrFail(id) {
         const doc = await this.findById(id);
@@ -151,11 +178,10 @@ export class FirebaseRepository {
     }
     /** Count all documents in the collection. */
     async count() {
-        const snap = await this.getCollection().count().get();
-        return snap.data().count;
+        return getFirestoreCount(this.getCollection());
     }
 }
-// ─── Internal helpers ─────────────────────────────────────────────────────────
+// --- Internal helpers ---------------------------------------------------------
 const TOKEN_TO_OP = {
     "==": "==",
     "!=": "!=",

package/dist/providers/db-firebase/base.repository.d.ts

@@ -1,11 +1,10 @@
-import "server-only";
 import type { CollectionReference, DocumentData, DocumentReference, DocumentSnapshot, Firestore, Query, Transaction, WriteBatch } from "firebase-admin/firestore";
 import { type FirebaseSieveFields, type FirebaseSieveOptions, type FirebaseSieveResult, type SieveModel } from "./sieve";
 export declare abstract class BaseRepository<T extends DocumentData> {
     protected collection: string;
     constructor(collectionName: string);
     protected get db(): Firestore;
-    protected getCollection(): CollectionReference<DocumentData, DocumentData>;
+    protected getCollection(): CollectionReference<DocumentData>;
     protected mapDoc<D = T>(snap: DocumentSnapshot): D;
     findById(id: string): Promise<T | null>;
     findByIdOrFail(id: string): Promise<T>;

package/dist/providers/db-firebase/base.repository.js

@@ -1,4 +1,3 @@
-import "server-only";
 import { DatabaseError, NotFoundError } from "../../errors";
 import { serverLogger } from "../../monitoring";
 import { applySieveToFirestore, } from "./sieve";

package/dist/providers/db-firebase/field-ops.d.ts

@@ -1,4 +1,3 @@
-import "server-only";
 import type { IFieldOps } from "../../contracts/field-ops";
 /**
  * Firebase Admin SDK implementation of IFieldOps.

package/dist/providers/db-firebase/field-ops.js

@@ -1,4 +1,3 @@
-import "server-only";
 import { FieldValue } from "firebase-admin/firestore";
 /**
  * Firebase Admin SDK implementation of IFieldOps.

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

@@ -1,3 +1,4 @@
+import type { CollectionReference, DocumentData, Query } from "firebase-admin/firestore";
 /**
  * Firestore serialisation helpers.
  *
@@ -21,3 +22,4 @@ export declare function prepareForFirestore<T extends Record<string, unknown>>(d
  * to Client Components.  `Date` objects are serialised as ISO strings.
  */
 export declare function deserializeTimestamps<T>(obj: T): T;
+export declare function getFirestoreCount(query: Query<DocumentData> | CollectionReference<DocumentData>): Promise<number>;

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

@@ -4,7 +4,7 @@
  * These utilities are the single adapter boundary between raw Firestore
  * documents and application-level objects.
  */
-// ─── Undefined removal ────────────────────────────────────────────────────────
+// --- Undefined removal --------------------------------------------------------
 /**
  * Recursively remove `undefined` values from an object.
  * Firestore rejects writes that contain `undefined` fields.
@@ -38,7 +38,7 @@ export function removeUndefined(obj) {
 export function prepareForFirestore(data) {
     return removeUndefined(data);
 }
-// ─── Timestamp deserialisation ────────────────────────────────────────────────
+// --- Timestamp deserialisation ------------------------------------------------
 /**
  * Recursively convert Firestore `Timestamp` instances to plain `Date` objects.
  *
@@ -65,3 +65,12 @@ export function deserializeTimestamps(obj) {
     }
     return obj;
 }
+export async function getFirestoreCount(query) {
+    const countQuery = query;
+    if (typeof countQuery.count === "function") {
+        const snapshot = await countQuery.count().get();
+        return snapshot.data().count;
+    }
+    const snapshot = await query.get();
+    return snapshot.size;
+}

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

@@ -1,4 +1,3 @@
-import "server-only";
 /**
  * @mohasinac/db-firebase
  *
@@ -15,7 +14,7 @@ import "server-only";
  * ```
  */
 export { getAdminApp, getAdminAuth, getAdminDb, getAdminStorage, getAdminRealtimeDb, _resetAdminSingletons, } from "./admin";
-export { removeUndefined, prepareForFirestore, deserializeTimestamps, } from "./helpers";
+export { removeUndefined, prepareForFirestore, deserializeTimestamps, getFirestoreCount, } from "./helpers";
 export { firebaseFieldOps } from "./field-ops";
 export type { DocumentSnapshot } from "firebase-admin/firestore";
 export { FirebaseRepository } from "./base";

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

@@ -1,4 +1,3 @@
-import "server-only";
 // Auto-register Firebase field operations on import
 import { registerFieldOps } from "../../contracts/field-ops";
 import { firebaseFieldOps } from "./field-ops";
@@ -21,7 +20,7 @@ registerFieldOps(firebaseFieldOps);
 // Admin SDK singletons
 export { getAdminApp, getAdminAuth, getAdminDb, getAdminStorage, getAdminRealtimeDb, _resetAdminSingletons, } from "./admin";
 // Serialisation helpers
-export { removeUndefined, prepareForFirestore, deserializeTimestamps, } from "./helpers";
+export { removeUndefined, prepareForFirestore, deserializeTimestamps, getFirestoreCount, } from "./helpers";
 // Firebase field ops implementation
 export { firebaseFieldOps } from "./field-ops";
 // Repository base classes

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

@@ -1,4 +1,3 @@
-import "server-only";
 /**
  * FirebaseRealtimeRepository<T>
  *
@@ -22,7 +21,7 @@ export declare abstract class FirebaseRealtimeRepository<T extends DocumentData>
     protected readonly path: string;
     constructor(rtdbPath: string);
     protected get rtdb(): import("firebase-admin/database").Database;
-    protected nodeRef(id?: string): import("@firebase/database-types").Reference;
+    protected nodeRef(id?: string): import("firebase-admin/database").Reference;
     findById(id: string): Promise<T | null>;
     findAll(query?: SieveQuery): Promise<PagedResult<T>>;
     findWhere(field: keyof T, _op: WhereOp, value: unknown): Promise<T[]>;

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

@@ -1,4 +1,20 @@
-import "server-only";
+/**
+ * FirebaseRealtimeRepository<T>
+ *
+ * Abstract base implementing `IRealtimeRepository<T>` from `@mohasinac/contracts`
+ * against Firebase Realtime Database (Admin SDK).
+ *
+ * Realtime DB does not support Firestore-style queries; `findAll()` loads the
+ * entire collection node.  Use this only for small, high-churn datasets (e.g.
+ * presence, chat, live-bid prices).
+ *
+ * Usage:
+ * ```ts
+ * class PresenceRepository extends FirebaseRealtimeRepository<PresenceEntry> {
+ *   constructor() { super("presence"); }
+ * }
+ * ```
+ */
 import { getAdminRealtimeDb } from "./admin";
 export class FirebaseRealtimeRepository {
     constructor(rtdbPath) {
@@ -10,7 +26,7 @@ export class FirebaseRealtimeRepository {
     nodeRef(id) {
         return id ? this.rtdb.ref(`${this.path}/${id}`) : this.rtdb.ref(this.path);
     }
-    // ── IReadRepository ────────────────────────────────────────────────────────
+    // -- IReadRepository --------------------------------------------------------
     async findById(id) {
         const snap = await this.nodeRef(id).get();
         if (!snap.exists())
@@ -66,7 +82,7 @@ export class FirebaseRealtimeRepository {
         const raw = snap.val();
         return Object.entries(raw).map(([id, val]) => ({ id, ...val }));
     }
-    // ── IWriteRepository ───────────────────────────────────────────────────────
+    // -- IWriteRepository -------------------------------------------------------
     async create(data) {
         const now = Date.now();
         const payload = { ...data, createdAt: now, updatedAt: now };
@@ -88,7 +104,7 @@ export class FirebaseRealtimeRepository {
     async batchDelete(ids) {
         await Promise.all(ids.map((id) => this.delete(id)));
     }
-    // ── IRealtimeRepository ───────────────────────────────────────────────────
+    // -- IRealtimeRepository ---------------------------------------------------
     /**
      * Subscribe to a single RTDB node.
      * Returns an unsubscribe function.

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

@@ -1,4 +1,3 @@
-import "server-only";
 /**
  * FirebaseSieveRepository<T>
  *

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

@@ -1,8 +1,26 @@
-import "server-only";
+/**
+ * FirebaseSieveRepository<T>
+ *
+ * Extends `FirebaseRepository<T>` with a full Sieve DSL query (filters, sorts,
+ * page, pageSize) pushed entirely to Firestore — no in-memory iteration.
+ *
+ * Uses `@mohasinac/sievejs` for parsing the Sieve filter / sort grammar.
+ *
+ * Usage in subclasses:
+ * ```ts
+ * async list(model: SieveModel, baseQuery?: CollectionReference | Query) {
+ *   return this.sieveQuery<ProductDocument>(model, {
+ *     title:     { canFilter: true, canSort: true },
+ *     price:     { canFilter: true, canSort: true },
+ *     createdAt: { canFilter: true, canSort: true },
+ *   }, { baseQuery });
+ * }
+ * ```
+ */
 import { SieveProcessorBase } from "@mohasinac/sievejs/services";
 import { createFirebaseAdapter } from "@mohasinac/sievejs/adapters/firebase";
 import { FirebaseRepository } from "./base";
-import { deserializeTimestamps } from "./helpers";
+import { deserializeTimestamps, getFirestoreCount } from "./helpers";
 const SIEVE_DEFAULTS = {
     caseSensitive: false,
     defaultPageSize: 20,
@@ -24,7 +42,7 @@ export async function applySieveToFirestore(params) {
     const filteredQ = processor.apply(model, baseQuery, {
         applyPagination: false,
     });
-    const total = (await filteredQ.count().get()).data().count;
+    const total = await getFirestoreCount(filteredQ);
     const pagedQ = processor.apply(model, baseQuery);
     const snap = await pagedQ.get();
     const items = snap.docs.map((d) => deserializeTimestamps({ id: d.id, ...d.data() }));
@@ -40,7 +58,7 @@ export async function applySieveToFirestore(params) {
         hasMore: page < totalPages,
     };
 }
-// ─── Class ────────────────────────────────────────────────────────────────────
+// --- Class --------------------------------------------------------------------
 export class FirebaseSieveRepository extends FirebaseRepository {
     /**
      * Run a Sieve DSL query against Firestore at the DB layer.
@@ -63,7 +81,7 @@ export class FirebaseSieveRepository extends FirebaseRepository {
         const filteredQ = processor.apply(model, base, {
             applyPagination: false,
         });
-        const total = (await filteredQ.count().get()).data().count;
+        const total = await getFirestoreCount(filteredQ);
         // Paginated result
         const pagedQ = processor.apply(model, base);
         const snap = await pagedQ.get();

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

@@ -1,4 +1,3 @@
-"use client";
 import { applyActionCode as fbApplyActionCode, confirmPasswordReset as fbConfirmPasswordReset, EmailAuthProvider, getAuth, reauthenticateWithCredential, sendPasswordResetEmail as fbSendPasswordResetEmail, signInWithEmailAndPassword as fbSignInWithEmailAndPassword, updatePassword, } from "firebase/auth";
 /**
  * Firebase Auth client SDK implementation of IClientAuthProvider.

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

@@ -1,4 +1,3 @@
-"use client";
 /**
  * Firebase Client SDK provider implementations.
  *

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

@@ -1,4 +1,3 @@
-"use client";
 import { getApps, initializeApp } from "firebase/app";
 import { getDatabase, ref, onValue, off, } from "firebase/database";
 import { getAuth, signInWithCustomToken, signOut } from "firebase/auth";

package/dist/providers/payment-razorpay/index.d.ts

@@ -1,4 +1,23 @@
-import "server-only";
+/**
+ * @mohasinac/payment-razorpay — Razorpay IPaymentProvider implementation
+ *
+ * Implements the @mohasinac/contracts IPaymentProvider interface.
+ * Accepts credentials via constructor — no Firestore or DB dependency.
+ *
+ * @example
+ * ```ts
+ * import { RazorpayProvider } from "@mohasinac/payment-razorpay";
+ * import { registerProviders } from "../../contracts";
+ *
+ * registerProviders({
+ *   payment: new RazorpayProvider({
+ *     keyId: process.env.RAZORPAY_KEY_ID!,
+ *     keySecret: process.env.RAZORPAY_KEY_SECRET!,
+ *     webhookSecret: process.env.RAZORPAY_WEBHOOK_SECRET,
+ *   }),
+ * });
+ * ```
+ */
 import type { IPaymentProvider, PaymentOrder, PaymentCapture, Refund } from "../../contracts";
 export interface RazorpayConfig {
     keyId: string;

package/dist/providers/payment-razorpay/index.js

@@ -1,4 +1,3 @@
-import "server-only";
 /**
  * @mohasinac/payment-razorpay — Razorpay IPaymentProvider implementation
  *
@@ -22,7 +21,7 @@ import "server-only";
 import Razorpay from "razorpay";
 import { createHmac, timingSafeEqual } from "crypto";
 import { getDefaultCurrency } from "../../core/baseline-resolver";
-// ─── IPaymentProvider implementation ──────────────────────────────────────────
+// --- IPaymentProvider implementation ------------------------------------------
 export class RazorpayProvider {
     constructor(config) {
         this.razorpay = new Razorpay({
@@ -99,7 +98,7 @@ export class RazorpayProvider {
         };
     }
 }
-// ─── Utility exports ──────────────────────────────────────────────────────────
+// --- Utility exports ----------------------------------------------------------
 /** Convert rupees (float) → paise (integer) for Razorpay amount field */
 export function rupeesToPaise(rupees) {
     return Math.round(rupees * 100);
@@ -122,7 +121,7 @@ export function verifyPaymentSignature(params, keySecret) {
         return false;
     return timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(params.razorpay_signature, "hex"));
 }
-// ─── Standalone API helpers (auto-credential resolution via resolveKeys) ──────
+// --- Standalone API helpers (auto-credential resolution via resolveKeys) ------
 // These resolve credentials from Firestore → env fallback so callers don't
 // need to instantiate RazorpayProvider or pass credentials explicitly.
 import { resolveKeys } from "../../core/integration-keys";

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

@@ -205,6 +205,24 @@ export interface ShiprocketCourierServiceabilityResponse {
     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;
@@ -267,6 +285,25 @@ export declare function shiprocketCheckServiceability(token: string, paramsOrPic
     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;

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

@@ -20,7 +20,7 @@
  * ```
  */
 const BASE_URL = "https://apiv2.shiprocket.in/v1/external";
-// ─── Internal fetch helper ────────────────────────────────────────────────────
+// --- Internal fetch helper ----------------------------------------------------
 async function shiprocketFetch(endpoint, options = {}) {
     const { token, headers = {}, ...rest } = options;
     const reqHeaders = {
@@ -48,9 +48,9 @@ async function shiprocketFetch(endpoint, options = {}) {
     }
     return json;
 }
-// ─── Re-export Provider Class ─────────────────────────────────────────────────
+// --- Re-export Provider Class -------------------------------------------------
 export { ShiprocketProvider } from "./shiprocket-provider";
-// ─── API Functions (prefer ShiprocketProvider class for new code) ─────────────
+// --- API Functions (prefer ShiprocketProvider class for new code) -------------
 /**
  * @deprecated Use `ShiprocketProvider.authenticate()` instead.
  * @internal
@@ -139,6 +139,39 @@ export async function shiprocketCheckServiceability(token, paramsOrPickup, deliv
         sp.set("cod", String(params.cod));
     return shiprocketFetch(`/courier/serviceability/?${sp.toString()}`, { token });
 }
+/**
+ * Cancel one or more Shiprocket orders by their order IDs.
+ * @deprecated Use `ShiprocketProvider.cancelShipment()` instead.
+ * @internal
+ */
+export async function shiprocketCancelOrder(token, orderIds) {
+    return shiprocketFetch("/orders/cancel", {
+        method: "POST",
+        token,
+        body: JSON.stringify({ ids: orderIds }),
+    });
+}
+/**
+ * Fetch full order details (including nested shipment IDs) for a Shiprocket order.
+ * @deprecated Use `ShiprocketProvider.generateLabel()` instead (calls this internally).
+ * @internal
+ */
+export async function shiprocketGetOrderDetail(token, orderId) {
+    return shiprocketFetch(`/orders/show/${orderId}`, { token });
+}
+/**
+ * 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 async function shiprocketPrintLabel(token, shipmentIds) {
+    return shiprocketFetch("/orders/print/label", {
+        method: "POST",
+        token,
+        body: JSON.stringify({ shipment_id: shipmentIds }),
+    });
+}
 /** Shiprocket tokens are valid for approx. 10 days */
 export const SHIPROCKET_TOKEN_TTL_MS = 9 * 24 * 60 * 60 * 1000;
 export function isShiprocketTokenExpired(expiry) {

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

@@ -1,4 +1,3 @@
-import "server-only";
 import type { IShippingProvider, CreateShipmentInput, Shipment, TrackingInfo, ServiceabilityResult } from "../../contracts/shipping";
 import { type ShiprocketAuthRequest, type ShiprocketAddPickupRequest, type ShiprocketVerifyPickupOTPRequest, type ShiprocketPickupLocation } from "./index";
 export interface ShiprocketProviderConfig {
@@ -29,9 +28,9 @@ export declare class ShiprocketProvider implements IShippingProvider {
     private ensureToken;
     createShipment(data: CreateShipmentInput): Promise<Shipment>;
     trackShipment(trackingId: string): Promise<TrackingInfo>;
-    cancelShipment(_shipmentId: string): Promise<void>;
+    cancelShipment(shipmentId: string): Promise<void>;
     checkServiceability(pincode: string, weight: number): Promise<ServiceabilityResult>;
-    generateLabel(_shipmentId: string): Promise<ArrayBuffer>;
+    generateLabel(shipmentId: string): Promise<ArrayBuffer>;
     /** Authenticate and obtain a fresh token. */
     authenticate(credentials?: ShiprocketAuthRequest): Promise<{
         token: string;

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

@@ -1,6 +1,5 @@
-import "server-only";
-import { shiprocketAuthenticate, shiprocketCreateOrder, shiprocketGenerateAWB, shiprocketGeneratePickup, shiprocketTrackByAWB, shiprocketCheckServiceability, shiprocketGetPickupLocations, shiprocketAddPickupLocation, shiprocketVerifyPickupOTP, isShiprocketTokenExpired, SHIPROCKET_TOKEN_TTL_MS, } from "./index";
-// ─── Shiprocket Provider Class ─────────────────────────────────────────────────
+import { shiprocketAuthenticate, shiprocketCreateOrder, shiprocketGenerateAWB, shiprocketGeneratePickup, shiprocketTrackByAWB, shiprocketCheckServiceability, shiprocketGetPickupLocations, shiprocketAddPickupLocation, shiprocketVerifyPickupOTP, shiprocketCancelOrder, shiprocketGetOrderDetail, shiprocketPrintLabel, isShiprocketTokenExpired, SHIPROCKET_TOKEN_TTL_MS, } from "./index";
+// --- Shiprocket Provider Class -------------------------------------------------
 /**
  * `IShippingProvider` implementation backed by the Shiprocket REST API.
  *
@@ -18,7 +17,7 @@ export class ShiprocketProvider {
         this.token = config.token;
         this.tokenExpiry = config.tokenExpiry;
     }
-    // ─── Token Management ──────────────────────────────────────────────────────
+    // --- Token Management ------------------------------------------------------
     async ensureToken() {
         if (this.token && !isShiprocketTokenExpired(this.tokenExpiry)) {
             return this.token;
@@ -32,7 +31,7 @@ export class ShiprocketProvider {
         await this.config.onTokenRefresh?.(this.token, this.tokenExpiry);
         return this.token;
     }
-    // ─── IShippingProvider ─────────────────────────────────────────────────────
+    // --- IShippingProvider -----------------------------------------------------
     async createShipment(data) {
         const token = await this.ensureToken();
         const orderReq = {
@@ -98,9 +97,10 @@ export class ShiprocketProvider {
             events,
         };
     }
-    async cancelShipment(_shipmentId) {
-        // Shiprocket cancel API not implemented in HTTP client yet
-        throw new Error("cancelShipment not implemented for Shiprocket provider");
+    async cancelShipment(shipmentId) {
+        const token = await this.ensureToken();
+        // shipmentId is Shipment.id = String(orderRes.order_id)
+        await shiprocketCancelOrder(token, [parseInt(shipmentId, 10)]);
     }
     async checkServiceability(pincode, weight) {
         const token = await this.ensureToken();
@@ -116,11 +116,27 @@ export class ShiprocketProvider {
         }));
         return { isServiceable: couriers.length > 0, couriers };
     }
-    async generateLabel(_shipmentId) {
-        // Shiprocket label API not implemented in HTTP client yet
-        throw new Error("generateLabel not implemented for Shiprocket provider");
+    async generateLabel(shipmentId) {
+        const token = await this.ensureToken();
+        // shipmentId is Shipment.id = String(orderRes.order_id); label API needs the
+        // Shiprocket shipment_id (different numeric field), so look it up first.
+        const orderId = parseInt(shipmentId, 10);
+        const detail = await shiprocketGetOrderDetail(token, orderId);
+        const srShipmentId = detail.data?.shipments?.[0]?.id;
+        if (!srShipmentId) {
+            throw new Error(`No shipment found for Shiprocket order ${orderId}`);
+        }
+        const labelRes = await shiprocketPrintLabel(token, [srShipmentId]);
+        if (!labelRes.label_url) {
+            throw new Error("Shiprocket did not return a label URL");
+        }
+        const pdfRes = await fetch(labelRes.label_url);
+        if (!pdfRes.ok) {
+            throw new Error(`Failed to download label PDF: ${pdfRes.status}`);
+        }
+        return pdfRes.arrayBuffer();
     }
-    // ─── Shiprocket-Specific Methods ──────────────────────────────────────────
+    // --- Shiprocket-Specific Methods ------------------------------------------
     /** Authenticate and obtain a fresh token. */
     async authenticate(credentials) {
         const creds = credentials ?? {

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

@@ -1,4 +1,3 @@
-"use client";
 /**
  * Firebase Client Storage Helpers
  *
@@ -120,7 +119,7 @@ export function createStorageHelpers(storage) {
         deleteFolder,
     };
 }
-// ─── File validation helpers (pure, no storage instance needed) ───────────────
+// --- File validation helpers (pure, no storage instance needed) ---------------
 export function validateFileSize(file, maxSizeMB = 10) {
     return file.size <= maxSizeMB * 1024 * 1024;
 }