@mohasinac/appkit 2.3.0 → 2.3.2

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

@@ -0,0 +1,243 @@
+/**
+ * SEO-Friendly ID Generators
+ *
+ * Every generator accepts an optional `customId` override. When supplied and
+ * non-empty it is returned as-is, letting callers bring their own IDs without
+ * duplicating generator logic.
+ */
+export interface GenerateCategoryIdInput {
+    name: string;
+    parentName?: string;
+    rootName?: string;
+    customId?: string;
+}
+export declare function generateCategoryId(input: GenerateCategoryIdInput): string;
+export interface GenerateUserIdInput {
+    firstName: string;
+    lastName: string;
+    email: string;
+    customId?: string;
+}
+export declare function generateUserId(input: GenerateUserIdInput): string;
+export interface GenerateProductIdInput {
+    name: string;
+    category: string;
+    condition: "new" | "used" | "refurbished";
+    sellerName: string;
+    count?: number;
+    customId?: string;
+}
+export declare function generateProductId(input: GenerateProductIdInput): string;
+export interface GenerateAuctionIdInput {
+    name: string;
+    category: string;
+    condition: "new" | "used" | "refurbished";
+    sellerName: string;
+    count?: number;
+    customId?: string;
+}
+export declare function generateAuctionId(input: GenerateAuctionIdInput): string;
+export interface GeneratePreOrderIdInput {
+    name: string;
+    category: string;
+    condition: "new" | "used" | "refurbished";
+    sellerName: string;
+    count?: number;
+    customId?: string;
+}
+export declare function generatePreOrderId(input: GeneratePreOrderIdInput): string;
+export interface GenerateReviewIdInput {
+    productName: string;
+    userFirstName: string;
+    date?: Date;
+    customId?: string;
+}
+export declare function generateReviewId(input: GenerateReviewIdInput): string;
+export interface GenerateOrderIdInput {
+    productCount: number;
+    date?: Date;
+    customId?: string;
+}
+export declare function generateOrderId(input: GenerateOrderIdInput): string;
+export interface GenerateFAQIdInput {
+    category: string;
+    question: string;
+    customId?: string;
+}
+export declare function generateFAQId(input: GenerateFAQIdInput): string;
+export declare function generateCouponId(code: string, customId?: string): string;
+export interface GenerateCarouselIdInput {
+    title: string;
+    customId?: string;
+}
+export declare function generateCarouselId(input: GenerateCarouselIdInput): string;
+export interface GenerateHomepageSectionIdInput {
+    type: string;
+    customId?: string;
+}
+export declare function generateHomepageSectionId(input: GenerateHomepageSectionIdInput): string;
+export interface GenerateBidIdInput {
+    productName: string;
+    userFirstName: string;
+    date?: Date;
+    random?: string;
+    customId?: string;
+}
+export declare function generateBidId(input: GenerateBidIdInput): string;
+export interface GenerateBlogPostIdInput {
+    title: string;
+    category: string;
+    status?: "draft" | "published" | "archived";
+    customId?: string;
+}
+export declare function generateBlogPostId(input: GenerateBlogPostIdInput): string;
+export interface GeneratePayoutIdInput {
+    sellerName: string;
+    date?: Date;
+    customId?: string;
+}
+export declare function generatePayoutId(input: GeneratePayoutIdInput): string;
+export interface GenerateOfferIdInput {
+    productId: string;
+    buyerUid: string;
+    date?: Date;
+    customId?: string;
+}
+export declare function generateOfferId(input: GenerateOfferIdInput): string;
+export declare function idExists(getExistingId: () => Promise<unknown>): Promise<boolean>;
+export declare function generateUniqueId(generateId: (count: number) => string, checkExists: (id: string) => Promise<boolean>, maxAttempts?: number): Promise<string>;
+export declare function generateBarcodeFromId(id: string): string;
+export declare function generateQRCodeData(id: string, baseUrl: string): string;
+export interface GenerateProductImageFilenameInput {
+    name: string;
+    category: string;
+    store: string;
+    index?: number;
+    ext?: string;
+}
+export declare function generateProductImageFilename(input: GenerateProductImageFilenameInput): string;
+export interface GenerateProductVideoFilenameInput {
+    name: string;
+    category: string;
+    store: string;
+    index?: number;
+    ext?: string;
+}
+export declare function generateProductVideoFilename(input: GenerateProductVideoFilenameInput): string;
+export interface GenerateAuctionImageFilenameInput {
+    name: string;
+    category: string;
+    store: string;
+    index?: number;
+    ext?: string;
+}
+export declare function generateAuctionImageFilename(input: GenerateAuctionImageFilenameInput): string;
+export interface GeneratePreOrderImageFilenameInput {
+    name: string;
+    category: string;
+    store: string;
+    index?: number;
+    ext?: string;
+}
+export declare function generatePreOrderImageFilename(input: GeneratePreOrderImageFilenameInput): string;
+export interface GenerateReviewImageFilenameInput {
+    productId: string;
+    index?: number;
+    ext?: string;
+}
+export declare function generateReviewImageFilename(input: GenerateReviewImageFilenameInput): string;
+export interface GenerateReviewVideoFilenameInput {
+    productId: string;
+    ext?: string;
+}
+export declare function generateReviewVideoFilename(input: GenerateReviewVideoFilenameInput): string;
+export declare function generateStoreLogoFilename(storeName: string, ext?: string): string;
+export declare function generateStoreBannerFilename(storeName: string, ext?: string): string;
+export interface GenerateBlogImageFilenameInput {
+    title: string;
+    category: string;
+    index?: number;
+    ext?: string;
+}
+export declare function generateBlogImageFilename(input: GenerateBlogImageFilenameInput): string;
+export interface GenerateEventImageFilenameInput {
+    title: string;
+    index?: number;
+    ext?: string;
+}
+export declare function generateEventImageFilename(input: GenerateEventImageFilenameInput): string;
+export interface GenerateRichTextImageFilenameInput {
+    entity: string;
+    name: string;
+    index?: number;
+    ext?: string;
+}
+export declare function generateRichTextImageFilename(input: GenerateRichTextImageFilenameInput): string;
+export declare function generateCategoryImageFilename(categoryName: string, ext?: string): string;
+export declare function generateUserAvatarFilename(firstName: string, lastName: string, ext?: string): string;
+export declare function generateCarouselImageFilename(title: string, ext?: string): string;
+export declare function generateCroppedImageFilename(originalFilenameOrPath: string, ext?: string): string;
+export declare function generateTrimmedVideoFilename(originalFilenameOrPath: string, ext?: string): string;
+export declare function generateInvoiceFilename(orderId: string, date?: Date): string;
+export declare function generatePayoutDocFilename(sellerName: string, date?: Date): string;
+export type MediaFilenameContext = ({
+    type: "product-image";
+} & GenerateProductImageFilenameInput) | ({
+    type: "product-video";
+} & GenerateProductVideoFilenameInput) | ({
+    type: "review-image";
+} & GenerateReviewImageFilenameInput) | ({
+    type: "review-video";
+} & GenerateReviewVideoFilenameInput) | ({
+    type: "auction-image";
+} & GenerateAuctionImageFilenameInput) | ({
+    type: "preorder-image";
+} & GeneratePreOrderImageFilenameInput) | {
+    type: "store-logo";
+    store: string;
+    ext?: string;
+} | {
+    type: "store-banner";
+    store: string;
+    ext?: string;
+} | ({
+    type: "blog-image";
+} & GenerateBlogImageFilenameInput) | ({
+    type: "blog-cover";
+} & GenerateBlogImageFilenameInput) | ({
+    type: "blog-content-image";
+} & GenerateBlogImageFilenameInput) | ({
+    type: "blog-additional-image";
+} & GenerateBlogImageFilenameInput) | ({
+    type: "event-image";
+} & GenerateEventImageFilenameInput) | ({
+    type: "event-cover";
+} & GenerateEventImageFilenameInput) | ({
+    type: "event-winner-image";
+} & GenerateEventImageFilenameInput) | ({
+    type: "event-additional-image";
+} & GenerateEventImageFilenameInput) | ({
+    type: "rich-text-image";
+} & GenerateRichTextImageFilenameInput) | {
+    type: "category-image";
+    name: string;
+    ext?: string;
+} | {
+    type: "user-avatar";
+    firstName: string;
+    lastName: string;
+    ext?: string;
+} | {
+    type: "carousel-image";
+    title: string;
+    ext?: string;
+} | {
+    type: "invoice";
+    orderId: string;
+    date?: Date;
+} | {
+    type: "payout-doc";
+    sellerName: string;
+    date?: Date;
+};
+export declare function generateMediaFilename(ctx: MediaFilenameContext): string;

package/dist/utils/id-generators.js

@@ -0,0 +1,360 @@
+/**
+ * SEO-Friendly ID Generators
+ *
+ * Every generator accepts an optional `customId` override. When supplied and
+ * non-empty it is returned as-is, letting callers bring their own IDs without
+ * duplicating generator logic.
+ */
+import { slugify } from "./string.formatter";
+function generateRandomString(length = 6) {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    const indices = new Uint8Array(length);
+    globalThis.crypto.getRandomValues(indices);
+    return Array.from(indices, (i) => chars[i % chars.length]).join("");
+}
+function getTimestamp() {
+    return Date.now().toString();
+}
+export function generateCategoryId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const nameSlug = slugify(input.name);
+    if (input.parentName)
+        return `category-${nameSlug}-${slugify(input.parentName)}`;
+    if (input.rootName)
+        return `category-${nameSlug}-${slugify(input.rootName)}`;
+    return `category-${nameSlug}`;
+}
+export function generateUserId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const firstSlug = slugify(input.firstName);
+    const lastSlug = slugify(input.lastName);
+    const emailPrefix = input.email.split("@")[0].toLowerCase().substring(0, 8);
+    const emailSlug = slugify(emailPrefix);
+    return `user-${firstSlug}-${lastSlug}-${emailSlug}`;
+}
+export function generateProductId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const count = input.count || 1;
+    return `product-${slugify(input.name)}-${slugify(input.category)}-${input.condition}-${slugify(input.sellerName)}-${count}`;
+}
+export function generateAuctionId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const count = input.count || 1;
+    return `auction-${slugify(input.name)}-${slugify(input.category)}-${input.condition}-${slugify(input.sellerName)}-${count}`;
+}
+export function generatePreOrderId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const count = input.count || 1;
+    return `preorder-${slugify(input.name)}-${slugify(input.category)}-${input.condition}-${slugify(input.sellerName)}-${count}`;
+}
+export function generateReviewId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    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 `review-${slugify(input.productName)}-${slugify(input.userFirstName)}-${y}${m}${d}`;
+}
+export function generateOrderId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    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 `order-${input.productCount}-${y}${m}${d}-${generateRandomString(6)}`;
+}
+export function generateFAQId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    return `faq-${slugify(input.category)}-${slugify(input.question).substring(0, 50)}`;
+}
+// ─── Coupon ───────────────────────────────────────────────────────────────────
+export function generateCouponId(code, customId) {
+    if (customId?.trim())
+        return customId.trim();
+    return `coupon-${code.toUpperCase().replace(/[^A-Z0-9]/g, "")}`;
+}
+export function generateCarouselId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    return `carousel-${slugify(input.title).substring(0, 30)}-${getTimestamp()}`;
+}
+export function generateHomepageSectionId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    return `section-${slugify(input.type)}-${getTimestamp()}`;
+}
+export function generateBidId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    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");
+    const random = input.random || generateRandomString(6);
+    return `bid-${slugify(input.productName).substring(0, 30)}-${slugify(input.userFirstName)}-${y}${m}${d}-${random}`;
+}
+export function generateBlogPostId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const titleSlug = slugify(input.title).substring(0, 40).replace(/-+$/, "");
+    const categorySlug = slugify(input.category);
+    const base = `blog-${titleSlug}-${categorySlug}`;
+    if (input.status && input.status !== "published")
+        return `${base}-${input.status}`;
+    return base;
+}
+export function generatePayoutId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const sellerSlug = slugify(input.sellerName)
+        .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 `payout-${sellerSlug}-${y}${m}${d}-${generateRandomString(6)}`;
+}
+export function generateOfferId(input) {
+    if (input.customId?.trim())
+        return input.customId.trim();
+    const productPrefix = slugify(input.productId)
+        .substring(0, 20)
+        .replace(/-+$/, "");
+    const buyerPrefix = slugify(input.buyerUid)
+        .substring(0, 12)
+        .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 `offer-${productPrefix}-${buyerPrefix}-${y}${m}${d}-${generateRandomString(6)}`;
+}
+// --- ID existence helpers -----------------------------------------------------
+export async function idExists(getExistingId) {
+    try {
+        const doc = await getExistingId();
+        return !!doc;
+    }
+    catch {
+        return false;
+    }
+}
+export async function generateUniqueId(generateId, checkExists, maxAttempts = 100) {
+    for (let count = 1; count <= maxAttempts; count++) {
+        const id = generateId(count);
+        if (!(await checkExists(id)))
+            return id;
+    }
+    return `${generateId(maxAttempts)}-${generateRandomString(4)}`;
+}
+// --- Barcode / QR helpers -----------------------------------------------------
+export function generateBarcodeFromId(id) {
+    const digits = id.replace(/\D/g, "");
+    if (digits.length >= 12)
+        return digits.slice(0, 12);
+    return digits.padEnd(12, "0");
+}
+export function generateQRCodeData(id, baseUrl) {
+    if (id.startsWith("product-"))
+        return `${baseUrl}/products/${id}`;
+    if (id.startsWith("auction-"))
+        return `${baseUrl}/auctions/${id}`;
+    if (id.startsWith("category-"))
+        return `${baseUrl}/categories/${id}`;
+    if (id.startsWith("store-"))
+        return `${baseUrl}/stores/${id}`;
+    if (id.startsWith("event-"))
+        return `${baseUrl}/events/${id}`;
+    return `${baseUrl}/${id}`;
+}
+// --- Media filename generators -----------------------------------------------
+//
+// Naming patterns (all lowercase, hyphen-separated):
+//   product image  → product-{name}-{category}-{store}-image-{n}.{ext}
+//   product video  → product-{name}-{category}-{store}-video-{n}.{ext}
+//   auction image  → auction-{name}-{category}-{store}-image-{n}.{ext}
+//   preorder image → preorder-{name}-{category}-{store}-image-{n}.{ext}
+//   store logo     → store-{name}-logo.{ext}
+//   store banner   → store-{name}-banner.{ext}
+//   blog image     → blog-{title}-{category}-image-{n}.{ext}
+//   event image    → event-{title}-image-{n}.{ext}
+//   category image → category-{name}-image.{ext}
+//   user avatar    → user-{firstName}-{lastName}-avatar.{ext}
+//   carousel image → carousel-{title}-image.{ext}
+//   cropped image  → {original-basename}-cropped.{ext}
+//   trimmed video  → {original-basename}-trimmed.{ext}
+//   invoice        → invoice-{orderId}-{YYYYMMDD}.pdf
+//   payout doc     → payout-doc-{sellerName}-{YYYYMMDD}.pdf
+function basenameStem(filenameOrPath) {
+    const filename = filenameOrPath.split("/").pop() ?? filenameOrPath;
+    const dotIndex = filename.lastIndexOf(".");
+    return dotIndex > 0 ? filename.slice(0, dotIndex) : filename;
+}
+export function generateProductImageFilename(input) {
+    const name = slugify(input.name).substring(0, 40).replace(/-+$/, "");
+    const category = slugify(input.category).substring(0, 20).replace(/-+$/, "");
+    const store = slugify(input.store).substring(0, 20).replace(/-+$/, "");
+    const n = input.index ?? 1;
+    const ext = (input.ext ?? "webp").replace(/^\./, "");
+    return `product-${name}-${category}-${store}-image-${n}.${ext}`;
+}
+export function generateProductVideoFilename(input) {
+    const name = slugify(input.name).substring(0, 40).replace(/-+$/, "");
+    const category = slugify(input.category).substring(0, 20).replace(/-+$/, "");
+    const store = slugify(input.store).substring(0, 20).replace(/-+$/, "");
+    const n = input.index ?? 1;
+    const ext = (input.ext ?? "mp4").replace(/^\./, "");
+    return `product-${name}-${category}-${store}-video-${n}.${ext}`;
+}
+export function generateAuctionImageFilename(input) {
+    const name = slugify(input.name).substring(0, 40).replace(/-+$/, "");
+    const category = slugify(input.category).substring(0, 20).replace(/-+$/, "");
+    const store = slugify(input.store).substring(0, 20).replace(/-+$/, "");
+    const n = input.index ?? 1;
+    const ext = (input.ext ?? "webp").replace(/^\./, "");
+    return `auction-${name}-${category}-${store}-image-${n}.${ext}`;
+}
+export function generatePreOrderImageFilename(input) {
+    const name = slugify(input.name).substring(0, 40).replace(/-+$/, "");
+    const category = slugify(input.category).substring(0, 20).replace(/-+$/, "");
+    const store = slugify(input.store).substring(0, 20).replace(/-+$/, "");
+    const n = input.index ?? 1;
+    const ext = (input.ext ?? "webp").replace(/^\./, "");
+    return `preorder-${name}-${category}-${store}-image-${n}.${ext}`;
+}
+export function generateReviewImageFilename(input) {
+    const product = slugify(input.productId).substring(0, 40).replace(/-+$/, "");
+    const n = input.index ?? 1;
+    const ext = (input.ext ?? "webp").replace(/^\./, "");
+    return `review-${product}-image-${n}.${ext}`;
+}
+export function generateReviewVideoFilename(input) {
+    const product = slugify(input.productId).substring(0, 40).replace(/-+$/, "");
+    const ext = (input.ext ?? "mp4").replace(/^\./, "");
+    return `review-${product}-video-1.${ext}`;
+}
+export function generateStoreLogoFilename(storeName, ext = "webp") {
+    const store = slugify(storeName).substring(0, 40).replace(/-+$/, "");
+    return `store-${store}-logo.${ext.replace(/^\./, "")}`;
+}
+export function generateStoreBannerFilename(storeName, ext = "webp") {
+    const store = slugify(storeName).substring(0, 40).replace(/-+$/, "");
+    return `store-${store}-banner.${ext.replace(/^\./, "")}`;
+}
+export function generateBlogImageFilename(input) {
+    const title = slugify(input.title).substring(0, 40).replace(/-+$/, "");
+    const category = slugify(input.category).substring(0, 20).replace(/-+$/, "");
+    const n = input.index ?? 1;
+    const ext = (input.ext ?? "webp").replace(/^\./, "");
+    return `blog-${title}-${category}-image-${n}.${ext}`;
+}
+export function generateEventImageFilename(input) {
+    const title = slugify(input.title).substring(0, 50).replace(/-+$/, "");
+    const n = input.index ?? 1;
+    const ext = (input.ext ?? "webp").replace(/^\./, "");
+    return `event-${title}-image-${n}.${ext}`;
+}
+export function generateRichTextImageFilename(input) {
+    const entity = slugify(input.entity).substring(0, 24).replace(/-+$/, "");
+    const name = slugify(input.name).substring(0, 40).replace(/-+$/, "");
+    const n = input.index ?? 1;
+    const ext = (input.ext ?? "webp").replace(/^\./, "");
+    return `rich-text-${entity}-${name}-image-${n}.${ext}`;
+}
+export function generateCategoryImageFilename(categoryName, ext = "webp") {
+    const name = slugify(categoryName).substring(0, 40).replace(/-+$/, "");
+    return `category-${name}-image.${ext.replace(/^\./, "")}`;
+}
+export function generateUserAvatarFilename(firstName, lastName, ext = "webp") {
+    const first = slugify(firstName).substring(0, 20).replace(/-+$/, "");
+    const last = slugify(lastName).substring(0, 20).replace(/-+$/, "");
+    return `user-${first}-${last}-avatar.${ext.replace(/^\./, "")}`;
+}
+export function generateCarouselImageFilename(title, ext = "webp") {
+    const slug = slugify(title).substring(0, 40).replace(/-+$/, "");
+    return `carousel-${slug}-image.${ext.replace(/^\./, "")}`;
+}
+export function generateCroppedImageFilename(originalFilenameOrPath, ext) {
+    const stem = basenameStem(originalFilenameOrPath);
+    const originalExt = originalFilenameOrPath.includes(".")
+        ? originalFilenameOrPath.split(".").pop()
+        : "webp";
+    return `${stem}-cropped.${(ext ?? originalExt).replace(/^\./, "")}`;
+}
+export function generateTrimmedVideoFilename(originalFilenameOrPath, ext) {
+    const stem = basenameStem(originalFilenameOrPath);
+    const originalExt = originalFilenameOrPath.includes(".")
+        ? originalFilenameOrPath.split(".").pop()
+        : "mp4";
+    return `${stem}-trimmed.${(ext ?? originalExt).replace(/^\./, "")}`;
+}
+export function generateInvoiceFilename(orderId, 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 `invoice-${orderId}-${y}${m}${d}.pdf`;
+}
+export function generatePayoutDocFilename(sellerName, date = new Date()) {
+    const seller = slugify(sellerName).substring(0, 30).replace(/-+$/, "");
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `payout-doc-${seller}-${y}${m}${d}.pdf`;
+}
+export function generateMediaFilename(ctx) {
+    switch (ctx.type) {
+        case "product-image":
+            return generateProductImageFilename(ctx);
+        case "product-video":
+            return generateProductVideoFilename(ctx);
+        case "review-image":
+            return generateReviewImageFilename(ctx);
+        case "review-video":
+            return generateReviewVideoFilename(ctx);
+        case "auction-image":
+            return generateAuctionImageFilename(ctx);
+        case "preorder-image":
+            return generatePreOrderImageFilename(ctx);
+        case "store-logo":
+            return generateStoreLogoFilename(ctx.store, ctx.ext);
+        case "store-banner":
+            return generateStoreBannerFilename(ctx.store, ctx.ext);
+        case "blog-image":
+            return generateBlogImageFilename(ctx);
+        case "blog-cover":
+            return generateBlogImageFilename(ctx);
+        case "blog-content-image":
+            return generateBlogImageFilename(ctx);
+        case "blog-additional-image":
+            return generateBlogImageFilename(ctx);
+        case "event-image":
+            return generateEventImageFilename(ctx);
+        case "event-cover":
+            return generateEventImageFilename(ctx);
+        case "event-winner-image":
+            return generateEventImageFilename(ctx);
+        case "event-additional-image":
+            return generateEventImageFilename(ctx);
+        case "rich-text-image":
+            return generateRichTextImageFilename(ctx);
+        case "category-image":
+            return generateCategoryImageFilename(ctx.name, ctx.ext);
+        case "user-avatar":
+            return generateUserAvatarFilename(ctx.firstName, ctx.lastName, ctx.ext);
+        case "carousel-image":
+            return generateCarouselImageFilename(ctx.title, ctx.ext);
+        case "invoice":
+            return generateInvoiceFilename(ctx.orderId, ctx.date);
+        case "payout-doc":
+            return generatePayoutDocFilename(ctx.sellerName, ctx.date);
+    }
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./date.formatter";
+export * from "./number.formatter";
+export * from "./string.formatter";
+export * from "./type.converter";
+export * from "./cookie.converter";
+export * from "./id-generators";
+export * from "./media-field";
+export * from "./array.helper";
+export * from "./object.helper";
+export * from "./pagination.helper";
+export * from "./sorting.helper";
+export * from "./filter.helper";
+export * from "./animation.helper";
+export * from "./color.helper";
+export * from "./business-day";
+export * from "./schema-ui";
+export { splitCartIntoOrderGroups, type OrderType, type OrderGroup, } from "../features/orders/utils/order-splitter";

package/dist/utils/index.js

@@ -0,0 +1,18 @@
+export * from "./date.formatter";
+export * from "./number.formatter";
+export * from "./string.formatter";
+export * from "./type.converter";
+export * from "./cookie.converter";
+export * from "./id-generators";
+export * from "./media-field";
+export * from "./array.helper";
+export * from "./object.helper";
+export * from "./pagination.helper";
+export * from "./sorting.helper";
+export * from "./filter.helper";
+export * from "./animation.helper";
+export * from "./color.helper";
+export * from "./business-day";
+export * from "./schema-ui";
+// Re-export order utilities for checkout flows
+export { splitCartIntoOrderGroups, } from "../features/orders/utils/order-splitter";

package/dist/utils/media-field.d.ts

@@ -0,0 +1,2 @@
+export { coerceMediaField, coerceMediaFieldArray, getMediaUrl, inferMediaTypeFromMime, mediaFieldSchema, } from "../features/media/types/index";
+export type { MediaField, MediaFieldInput, MediaFieldType, } from "../features/media/types/index";

package/dist/utils/media-field.js

@@ -0,0 +1 @@
+export { coerceMediaField, coerceMediaFieldArray, getMediaUrl, inferMediaTypeFromMime, mediaFieldSchema, } from "../features/media/types/index";

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

@@ -0,0 +1,13 @@
+/**
+ * Number Formatting Utilities
+ */
+export declare function formatCurrency(amount: number, currency?: string, locale?: string): string;
+export declare function formatNumber(num: number, locale?: string, options?: {
+    decimals?: number;
+}): string;
+export declare function formatPercentage(num: number, decimals?: number): string;
+export declare function formatFileSize(bytes: number): string;
+export declare function formatCompactNumber(num: number): string;
+export declare function formatDecimal(num: number, decimals?: number): string;
+export declare function formatOrdinal(num: number): string;
+export declare function parseFormattedNumber(str: string): number;