@mohasinac/appkit 3.4.8 → 3.5.1

package/dist/utils/id-generators.d.ts

@@ -97,6 +97,19 @@ export interface GeneratePayoutIdInput {
     customId?: string;
 }
 export declare function generatePayoutId(input: GeneratePayoutIdInput): string;
+export interface GenerateShipmentIdInput {
+    supplierName: string;
+    date?: Date;
+    customId?: string;
+}
+export declare function generateShipmentId(input: GenerateShipmentIdInput): string;
+export interface GenerateCatalogueItemIdInput {
+    ownerSlug: string;
+    title: string;
+    date?: Date;
+    customId?: string;
+}
+export declare function generateCatalogueItemId(input: GenerateCatalogueItemIdInput): string;
 export interface GenerateOfferIdInput {
     productId: string;
     buyerUid: string;
@@ -223,6 +236,11 @@ export type MediaFilenameContext = ({
     type: "carousel-image";
     title: string;
     ext?: string;
+} | {
+    type: "catalogue-image";
+    item: string;
+    index?: number;
+    ext?: string;
 } | {
     type: "invoice";
     orderId: string;
@@ -251,6 +269,15 @@ export type MediaFilenameContext = ({
 };
 export declare function generateMediaFilename(ctx: MediaFilenameContext): string;
 export declare function validateMediaFilename(filename: string): boolean;
+/**
+ * Derives the `MediaFilenameContext["type"]` a filename was generated under
+ * (e.g. "catalogue-image") by matching against the same prefix list
+ * {@link validateMediaFilename} uses — the longest matching prefix wins so
+ * "blog-content-image" isn't mis-derived as "blog-cover"'s sibling "blog-".
+ * Used at /api/media/finalize time to stamp `MediaAssetDocument.contextType`
+ * without changing the finalize request contract.
+ */
+export declare function deriveContextTypeFromFilename(filename: string): string | undefined;
 /**
  * Generates a scannable barcode identifier for a product listing.
  * Returns `LIR-XXXXXXXX` (8 uppercase hex chars) derived from a SHA-1

package/dist/utils/id-generators.js

@@ -124,6 +124,29 @@ export function generatePayoutId(input) {
     const d = String(date.getDate()).padStart(2, "0");
     return `payout-${sellerSlug}-${y}${m}${d}-${generateRandomString(6)}`;
 }
+export function generateShipmentId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const supplierSlug = slugify(input.supplierName)
+        .substring(0, 25)
+        .replace(/-+$/, "");
+    const date = input.date || new Date();
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `shipment-${supplierSlug}-${y}${m}${d}-${generateRandomString(6)}`;
+}
+export function generateCatalogueItemId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const ownerSlug = slugify(input.ownerSlug).substring(0, 25).replace(/-+$/, "");
+    const itemSlug = slugify(input.title).substring(0, 30).replace(/-+$/, "");
+    const date = input.date || new Date();
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `mycatalog-${ownerSlug}-${itemSlug}-${y}${m}${d}-${generateRandomString(6)}`;
+}
 export function generateOfferId(input) {
     if (input.customId?.trim())
         return input.customId.trim();
@@ -366,6 +389,12 @@ export function generateMediaFilename(ctx) {
             return generateUserAvatarFilename(ctx.firstName, ctx.lastName, ctx.ext);
         case "carousel-image":
             return generateCarouselImageFilename(ctx.title, ctx.ext);
+        case "catalogue-image": {
+            const item = slugify(ctx.item).substring(0, 40).replace(/-+$/, "");
+            const n = ctx.index ?? 1;
+            const ext = (ctx.ext ?? "webp").replace(/^\./, "");
+            return `catalogue-image-${item}-${n}.${ext}`;
+        }
         case "invoice":
             return generateInvoiceFilename(ctx.orderId, ctx.date);
         case "payout-doc":
@@ -419,6 +448,7 @@ const MEDIA_FILENAME_PREFIXES = [
     "category-image",
     "user-avatar",
     "carousel-image",
+    "catalogue-image",
     "invoice", "payout-doc",
     "shipping-proof", "refund-proof",
 ];
@@ -430,6 +460,21 @@ export function validateMediaFilename(filename) {
         return false;
     return MEDIA_FILENAME_REGEX.test(filename);
 }
+/**
+ * Derives the `MediaFilenameContext["type"]` a filename was generated under
+ * (e.g. "catalogue-image") by matching against the same prefix list
+ * {@link validateMediaFilename} uses — the longest matching prefix wins so
+ * "blog-content-image" isn't mis-derived as "blog-cover"'s sibling "blog-".
+ * Used at /api/media/finalize time to stamp `MediaAssetDocument.contextType`
+ * without changing the finalize request contract.
+ */
+export function deriveContextTypeFromFilename(filename) {
+    const stem = filename.replace(/\.[^.]+$/, "");
+    const matches = MEDIA_FILENAME_PREFIXES.filter((prefix) => stem.startsWith(`${prefix}-`) || stem === prefix);
+    if (matches.length === 0)
+        return undefined;
+    return matches.reduce((longest, candidate) => (candidate.length > longest.length ? candidate : longest));
+}
 /**
  * Generates a scannable barcode identifier for a product listing.
  * Returns `LIR-XXXXXXXX` (8 uppercase hex chars) derived from a SHA-1

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

@@ -5,6 +5,13 @@ export declare function formatCurrency(amount: number, currency?: string, locale
 export declare function formatNumber(num: number, locale?: string, options?: {
     decimals?: number;
 }): string;
+/**
+ * Formats an integer paise amount as a currency string, e.g. 349900 -> "₹3,499".
+ * Canonical helper for every paise-denominated amount across the codebase —
+ * see CLAUDE.md's Recurrent Root Cause Patterns for why this was previously
+ * duplicated as a local `formatPaise`/`toRupees` in 5+ admin/seller views.
+ */
+export declare function formatPaise(paise: number, currency?: string, locale?: string): string;
 export declare function formatPercentage(num: number, decimals?: number): string;
 export declare function formatFileSize(bytes: number): string;
 export declare function formatCompactNumber(num: number): string;

package/dist/utils/number.formatter.js

@@ -17,6 +17,15 @@ export function formatNumber(num, locale, options) {
         maximumFractionDigits: options?.decimals,
     }).format(num);
 }
+/**
+ * Formats an integer paise amount as a currency string, e.g. 349900 -> "₹3,499".
+ * Canonical helper for every paise-denominated amount across the codebase —
+ * see CLAUDE.md's Recurrent Root Cause Patterns for why this was previously
+ * duplicated as a local `formatPaise`/`toRupees` in 5+ admin/seller views.
+ */
+export function formatPaise(paise, currency, locale) {
+    return formatCurrency(paise / 100, currency, locale);
+}
 export function formatPercentage(num, decimals = 0) {
     return `${(num * 100).toFixed(decimals)}%`;
 }

package/dist/validation/schemas.d.ts

@@ -12,8 +12,8 @@ export declare const paginationQuerySchema: z.ZodObject<{
     search?: string | undefined;
     sortBy?: string | undefined;
 }, {
-    page?: number | undefined;
     search?: string | undefined;
+    page?: number | undefined;
     sortOrder?: "desc" | "asc" | undefined;
     limit?: number | undefined;
     sortBy?: string | undefined;
@@ -257,28 +257,28 @@ export declare const trimDataSchema: z.ZodEffects<z.ZodObject<{
     startTime: number;
     endTime: number;
     sourceUrl: string;
-    quality?: "high" | "low" | "medium" | undefined;
+    quality?: "medium" | "high" | "low" | undefined;
     outputFormat?: "mp4" | "webm" | undefined;
     outputFolder?: string | undefined;
 }, {
     startTime: number;
     endTime: number;
     sourceUrl: string;
-    quality?: "high" | "low" | "medium" | undefined;
+    quality?: "medium" | "high" | "low" | undefined;
     outputFormat?: "mp4" | "webm" | undefined;
     outputFolder?: string | undefined;
 }>, {
     startTime: number;
     endTime: number;
     sourceUrl: string;
-    quality?: "high" | "low" | "medium" | undefined;
+    quality?: "medium" | "high" | "low" | undefined;
     outputFormat?: "mp4" | "webm" | undefined;
     outputFolder?: string | undefined;
 }, {
     startTime: number;
     endTime: number;
     sourceUrl: string;
-    quality?: "high" | "low" | "medium" | undefined;
+    quality?: "medium" | "high" | "low" | undefined;
     outputFormat?: "mp4" | "webm" | undefined;
     outputFolder?: string | undefined;
 }>;

package/package.json

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