@mohasinac/appkit 2.6.3 → 2.6.4

package/dist/_internal/server/features/account/data.js

@@ -3,7 +3,7 @@
  * page + its generateMetadata share one Firestore read per request.
  */
 import { cache } from "react";
-import { userRepository, addressRepository } from "../../../../repositories";
+import { userRepository, addressesRepository } from "../../../../repositories";
 /**
  * Fetch the full account profile for the given user UID. Returns `null` when
  * the user document is missing.
@@ -21,5 +21,5 @@ export const listAddressesForUser = cache(async (uid, _opts) => {
     void _opts;
     if (!uid)
         return [];
-    return addressRepository.findByUser(uid);
+    return addressesRepository.listByOwner("user", uid);
 });

package/dist/_internal/server/features/bundles/data.d.ts

@@ -1,9 +1,29 @@
 /**
- * Bundles data layer.
+ * Bundle data layer — SB-UNI-3 2026-05-13.
  *
- * Bundles is a consumer-facing label for `groupedListings`. This file is a
- * thin re-export so consumer pages/sections can import from a feature folder
- * that matches their domain language (FeaturedBundlesSection, etc.) without
- * duplicating the underlying query layer.
+ * Bundles live as `categoryType:"bundle"` rows on the categories collection
+ * (SB-UNI-D + V). This file wraps the repo calls in `React.cache` so a page
+ * and its `generateMetadata` share one Firestore read per request.
  */
-export { getGroupedListingForDetail as getBundleForDetail, getGroupedListingWithItems as getBundleWithItems, listGroupedListings as listBundles, listFeaturedGroupedListings as listFeaturedBundles, listSitemapGroupedListings as listSitemapBundles, type GroupedListingWithItems as BundleWithItems, type ListGroupedListingsParams as ListBundlesParams, type SitemapGroupedListing as SitemapBundle, } from "../grouped/data";
+import type { CategoryDocument } from "../../../../features/categories/schemas";
+import type { ProductDocument } from "../../../../features/products/schemas/firestore";
+export interface BundleDataOptions {
+    /** Reserved for future overrides. */
+    _reserved?: never;
+}
+/**
+ * Fetch a single bundle by slug for the public detail page. Returns null
+ * when the slug is empty or no matching `categoryType:"bundle"` row exists.
+ */
+export declare const getBundleForDetail: (slug: string, _opts?: BundleDataOptions) => Promise<CategoryDocument | null>;
+/**
+ * Fetch the resolved product members of a bundle. Reads `bundleProductIds`
+ * off the bundle document and hydrates each via `productRepository.findById`.
+ * Returns an empty array when the bundle has no product mirror yet.
+ */
+export declare const listBundleMembers: (bundle: Pick<CategoryDocument, "bundleProductIds">, _opts?: BundleDataOptions) => Promise<ProductDocument[]>;
+/**
+ * List the most recent active bundles for homepage placement. Bounded to
+ * `limit` (default 8) and filtered to `isActive: true` server-side.
+ */
+export declare const listFeaturedBundles: (limit?: number, _opts?: BundleDataOptions) => Promise<CategoryDocument[]>;

package/dist/_internal/server/features/bundles/data.js

@@ -1,9 +1,44 @@
 /**
- * Bundles data layer.
+ * Bundle data layer — SB-UNI-3 2026-05-13.
  *
- * Bundles is a consumer-facing label for `groupedListings`. This file is a
- * thin re-export so consumer pages/sections can import from a feature folder
- * that matches their domain language (FeaturedBundlesSection, etc.) without
- * duplicating the underlying query layer.
+ * Bundles live as `categoryType:"bundle"` rows on the categories collection
+ * (SB-UNI-D + V). This file wraps the repo calls in `React.cache` so a page
+ * and its `generateMetadata` share one Firestore read per request.
  */
-export { getGroupedListingForDetail as getBundleForDetail, getGroupedListingWithItems as getBundleWithItems, listGroupedListings as listBundles, listFeaturedGroupedListings as listFeaturedBundles, listSitemapGroupedListings as listSitemapBundles, } from "../grouped/data";
+import { cache } from "react";
+import { categoriesRepository } from "../../../../repositories";
+import { productRepository } from "../../../../repositories";
+/**
+ * Fetch a single bundle by slug for the public detail page. Returns null
+ * when the slug is empty or no matching `categoryType:"bundle"` row exists.
+ */
+export const getBundleForDetail = cache(async (slug, _opts) => {
+    void _opts;
+    if (!slug)
+        return null;
+    return categoriesRepository.findBySlugAndType(slug, "bundle");
+});
+/**
+ * Fetch the resolved product members of a bundle. Reads `bundleProductIds`
+ * off the bundle document and hydrates each via `productRepository.findById`.
+ * Returns an empty array when the bundle has no product mirror yet.
+ */
+export const listBundleMembers = cache(async (bundle, _opts) => {
+    void _opts;
+    const ids = bundle.bundleProductIds ?? [];
+    if (ids.length === 0)
+        return [];
+    const results = await Promise.all(ids.map((id) => productRepository.findById(id).catch(() => null)));
+    return results.filter((p) => p !== null);
+});
+/**
+ * List the most recent active bundles for homepage placement. Bounded to
+ * `limit` (default 8) and filtered to `isActive: true` server-side.
+ */
+export const listFeaturedBundles = cache(async (limit = 8, _opts) => {
+    void _opts;
+    const all = await categoriesRepository
+        .listByType("bundle", { activeOnly: true, limit })
+        .catch(() => []);
+    return all;
+});

package/dist/_internal/server/features/bundles/index.d.ts

@@ -1,2 +1,3 @@
-export * from "./data";
-export { BUNDLES_PAGE_SIZE, BUNDLES_FEATURED_LIMIT, BUNDLES_SITEMAP_LIMIT, } from "../../../shared/features/bundles/config";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, type BundleDataOptions, } from "./data";
+export { buildBundleMetadata, type BundleMetadataOptions } from "./metadata";
+export { renderBundleOg, renderBundleOgImage, type BundleOgData, } from "./og";

package/dist/_internal/server/features/bundles/index.js

@@ -1,2 +1,4 @@
-export * from "./data";
-export { BUNDLES_PAGE_SIZE, BUNDLES_FEATURED_LIMIT, BUNDLES_SITEMAP_LIMIT, } from "../../../shared/features/bundles/config";
+export { getBundleForDetail, listBundleMembers, listFeaturedBundles, } from "./data";
+export { buildBundleMetadata } from "./metadata";
+// S-SBUNI-4 2026-05-13 — bundle OG renderer.
+export { renderBundleOg, renderBundleOgImage, } from "./og";

package/dist/_internal/server/features/bundles/metadata.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Bundle metadata helper — SB-UNI-3 2026-05-13.
+ *
+ * Maps a CategoryDocument with categoryType:"bundle" to a Next.js Metadata
+ * object. Consumers (page.tsx generateMetadata) pass the doc + override
+ * opts; the helper does NOT fetch anything (the page already did). Site
+ * branding flows through opts.siteName / opts.siteUrl so this file stays
+ * appkit-internal and consumer-configurable.
+ */
+import type { Metadata } from "next";
+import type { CategoryDocument } from "../../../../features/categories/schemas";
+export interface BundleMetadataOptions {
+    /** Brand label appended to titles (e.g. consumer's site name). */
+    siteName?: string;
+    /** Override the base public site URL when building absolute links. */
+    siteUrl?: string;
+    /** Override the OG image — defaults to bundle.display.coverImage. */
+    ogImageUrl?: string;
+}
+export declare function buildBundleMetadata(bundle: CategoryDocument | null, opts?: BundleMetadataOptions): Metadata;

package/dist/_internal/server/features/bundles/metadata.js

@@ -0,0 +1,46 @@
+/**
+ * Bundle metadata helper — SB-UNI-3 2026-05-13.
+ *
+ * Maps a CategoryDocument with categoryType:"bundle" to a Next.js Metadata
+ * object. Consumers (page.tsx generateMetadata) pass the doc + override
+ * opts; the helper does NOT fetch anything (the page already did). Site
+ * branding flows through opts.siteName / opts.siteUrl so this file stays
+ * appkit-internal and consumer-configurable.
+ */
+const FALLBACK_DESCRIPTION = "Curated multi-product bundle — one price, one checkout, one shipment.";
+export function buildBundleMetadata(bundle, opts) {
+    const siteName = opts?.siteName?.trim() || "";
+    const suffix = siteName ? ` — ${siteName}` : "";
+    if (!bundle) {
+        return {
+            title: `Bundle not found${suffix}`,
+            description: "This bundle is unavailable or has been removed.",
+            robots: { index: false },
+        };
+    }
+    const title = `${bundle.name}${suffix}`;
+    const description = bundle.description?.trim()
+        ? bundle.description.trim()
+        : FALLBACK_DESCRIPTION;
+    const cover = opts?.ogImageUrl ?? bundle.display?.coverImage;
+    const siteUrl = opts?.siteUrl?.replace(/\/+$/, "");
+    const canonical = siteUrl ? `${siteUrl}/bundles/${bundle.slug}` : undefined;
+    return {
+        title,
+        description,
+        alternates: canonical ? { canonical } : undefined,
+        openGraph: {
+            title,
+            description,
+            url: canonical,
+            type: "website",
+            images: cover ? [{ url: cover }] : undefined,
+        },
+        twitter: {
+            card: cover ? "summary_large_image" : "summary",
+            title,
+            description,
+            images: cover ? [cover] : undefined,
+        },
+    };
+}

package/dist/_internal/server/features/bundles/og.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Bundle OG image renderer — S-SBUNI-4 2026-05-13.
+ *
+ * Two layers (mirror of categories/og.tsx):
+ *  - `renderBundleOg(doc, opts)` — high-level: maps a bundle CategoryDocument
+ *    (categoryType:"bundle") into the OG data shape.
+ *  - `renderBundleOgImage(data, siteName)` — pure JSX primitive, no next/og
+ *    dependency; consumer wraps with `new ImageResponse(...)`.
+ *
+ * Bundle-specific accents over the category layout:
+ *  - Header pill says "Bundle" instead of "Category"
+ *  - Price + item-count chip-row replaces the category itemCount pill
+ *  - Stock-status badge surfaces when bundleStockStatus !== "in_stock"
+ */
+import type { ReactElement } from "react";
+export interface BundleOgData {
+    name: string;
+    description?: string | null;
+    coverImageUrl?: string | null;
+    priceLabel?: string | null;
+    itemCount?: number | null;
+    stockStatus?: "in_stock" | "partial" | "out_of_stock" | null;
+}
+interface BundleDocLike {
+    name?: string | null;
+    description?: string | null;
+    display?: {
+        coverImage?: string | null;
+    } | null;
+    bundlePriceInPaise?: number | null;
+    bundleProductIds?: string[] | null;
+    bundleStockStatus?: "in_stock" | "partial" | "out_of_stock" | null;
+}
+export declare function renderBundleOg(doc: BundleDocLike | null | undefined, opts: {
+    siteName: string;
+}): ReactElement;
+export declare function renderBundleOgImage(data: BundleOgData, siteName: string): ReactElement;
+export {};

package/dist/_internal/server/features/bundles/og.js

@@ -0,0 +1,122 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function formatPriceInr(paise) {
+    const rupees = Math.round(paise / 100);
+    return `₹${rupees.toLocaleString("en-IN")}`;
+}
+export function renderBundleOg(doc, opts) {
+    const name = doc?.name ?? "Bundle";
+    const priceLabel = typeof doc?.bundlePriceInPaise === "number" && doc.bundlePriceInPaise > 0
+        ? formatPriceInr(doc.bundlePriceInPaise)
+        : null;
+    return renderBundleOgImage({
+        name,
+        description: doc?.description?.slice(0, 140) ??
+            `Curated multi-product bundle on ${opts.siteName}.`,
+        coverImageUrl: doc?.display?.coverImage ?? null,
+        priceLabel,
+        itemCount: doc?.bundleProductIds?.length ?? null,
+        stockStatus: doc?.bundleStockStatus ?? null,
+    }, opts.siteName);
+}
+const STOCK_BADGE = {
+    in_stock: null,
+    partial: {
+        text: "Partial stock",
+        bg: "rgba(234, 179, 8, 0.18)",
+        border: "rgba(234, 179, 8, 0.4)",
+        color: "#fef3c7",
+    },
+    out_of_stock: {
+        text: "Out of stock",
+        bg: "rgba(239, 68, 68, 0.18)",
+        border: "rgba(239, 68, 68, 0.45)",
+        color: "#fee2e2",
+    },
+};
+export function renderBundleOgImage(data, siteName) {
+    const { name, description, coverImageUrl, priceLabel, itemCount, stockStatus } = data;
+    const itemLabel = typeof itemCount === "number" && itemCount > 0
+        ? `${itemCount} item${itemCount === 1 ? "" : "s"}`
+        : null;
+    const stockBadge = stockStatus ? STOCK_BADGE[stockStatus] : null;
+    return (_jsxs("div", { style: {
+            display: "flex",
+            width: "100%",
+            height: "100%",
+            background: "#0f172a",
+            fontFamily: "sans-serif",
+            position: "relative",
+            overflow: "hidden",
+        }, children: [coverImageUrl && (_jsx("img", { src: coverImageUrl, alt: "", style: {
+                    position: "absolute",
+                    inset: 0,
+                    width: "100%",
+                    height: "100%",
+                    objectFit: "cover",
+                    opacity: 0.35,
+                } })), _jsx("div", { style: {
+                    position: "absolute",
+                    inset: 0,
+                    background: "linear-gradient(135deg, rgba(15, 23, 42, 0.85) 0%, rgba(30, 41, 59, 0.7) 100%)",
+                } }), _jsxs("div", { style: {
+                    position: "relative",
+                    display: "flex",
+                    flexDirection: "column",
+                    gap: 24,
+                    padding: "80px 72px",
+                    width: "100%",
+                    height: "100%",
+                    justifyContent: "flex-end",
+                }, children: [_jsxs("div", { style: {
+                            fontSize: 18,
+                            color: "#94a3b8",
+                            fontWeight: 600,
+                            letterSpacing: 2,
+                            textTransform: "uppercase",
+                        }, children: [siteName, " \u00B7 Bundle"] }), _jsx("div", { style: {
+                            fontSize: 76,
+                            fontWeight: 800,
+                            color: "#f8fafc",
+                            lineHeight: 1.05,
+                            letterSpacing: -1,
+                        }, children: name }), description && (_jsx("div", { style: {
+                            fontSize: 26,
+                            color: "#cbd5e1",
+                            fontWeight: 400,
+                            lineHeight: 1.35,
+                            maxWidth: 960,
+                        }, children: description })), _jsxs("div", { style: {
+                            display: "flex",
+                            flexDirection: "row",
+                            gap: 12,
+                            marginTop: 8,
+                            flexWrap: "wrap",
+                        }, children: [priceLabel && (_jsx("div", { style: {
+                                    display: "inline-flex",
+                                    padding: "10px 22px",
+                                    borderRadius: 999,
+                                    background: "rgba(56, 189, 248, 0.18)",
+                                    color: "#e0f2fe",
+                                    fontSize: 26,
+                                    fontWeight: 700,
+                                    border: "1px solid rgba(56, 189, 248, 0.4)",
+                                }, children: priceLabel })), itemLabel && (_jsx("div", { style: {
+                                    display: "inline-flex",
+                                    padding: "10px 22px",
+                                    borderRadius: 999,
+                                    background: "rgba(148, 163, 184, 0.18)",
+                                    color: "#e2e8f0",
+                                    fontSize: 22,
+                                    fontWeight: 600,
+                                    border: "1px solid rgba(148, 163, 184, 0.35)",
+                                }, children: itemLabel })), stockBadge && (_jsx("div", { style: {
+                                    display: "inline-flex",
+                                    padding: "10px 22px",
+                                    borderRadius: 999,
+                                    background: stockBadge.bg,
+                                    color: stockBadge.color,
+                                    fontSize: 22,
+                                    fontWeight: 600,
+                                    border: `1px solid ${stockBadge.border}`,
+                                }, children: stockBadge.text }))] })] })] }));
+}