@mohasinac/appkit 4.1.0 → 4.1.3

package/dist/_internal/client/features/maintenance/index.d.ts

@@ -5,3 +5,5 @@ export type { ServerErrorDetailViewProps } from "./views/ServerErrorDetailView";
 export { MaintenanceDashboardView } from "./views/MaintenanceDashboardView";
 export type { MaintenanceDashboardViewProps } from "./views/MaintenanceDashboardView";
 export { AnalysisRunnerView } from "./views/AnalysisRunnerView";
+export { CloudLogsListView } from "./views/CloudLogsListView";
+export type { CloudLogsListViewProps } from "./views/CloudLogsListView";

package/dist/_internal/client/features/maintenance/index.js

@@ -2,3 +2,4 @@ export { ServerErrorsListView } from "./views/ServerErrorsListView";
 export { ServerErrorDetailView } from "./views/ServerErrorDetailView";
 export { MaintenanceDashboardView } from "./views/MaintenanceDashboardView";
 export { AnalysisRunnerView } from "./views/AnalysisRunnerView";
+export { CloudLogsListView } from "./views/CloudLogsListView";

package/dist/_internal/client/features/maintenance/views/CloudLogsListView.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+import type { CloudLogEntry } from "../../../../server/features/maintenance/cloud-logs-data";
+export interface CloudLogsListViewProps {
+    title: string;
+    subtitle?: string;
+    initialEntries: CloudLogEntry[];
+    initialNextPageToken: string | null;
+}
+export declare function CloudLogsListView({ title, subtitle, initialEntries, initialNextPageToken, }: CloudLogsListViewProps): React.JSX.Element;

package/dist/_internal/client/features/maintenance/views/CloudLogsListView.js

@@ -0,0 +1,55 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Button, Div, Heading, Span, Table, Tbody, Td, Text, Th, Thead, Tr } from "@mohasinac/appkit";
+import { ADMIN_ENDPOINTS } from "../../../../../constants/api-endpoints";
+import { normalizeError } from "../../../../../errors/normalize";
+const BORDER_STYLE = "1px solid var(--appkit-color-border)";
+const COLUMNS = [
+    { key: "timestampFmt", label: "When", width: "180px" },
+    { key: "severity", label: "Severity", width: "100px" },
+    { key: "resource", label: "Resource" },
+    { key: "messagePreview", label: "Payload excerpt" },
+];
+function fmt(timestamp) {
+    const d = new Date(timestamp);
+    return Number.isNaN(d.getTime()) ? timestamp : d.toISOString().replace("T", " ").slice(0, 19);
+}
+export function CloudLogsListView({ title, subtitle, initialEntries, initialNextPageToken, }) {
+    const [entries, setEntries] = React.useState(initialEntries);
+    const [nextPageToken, setNextPageToken] = React.useState(initialNextPageToken);
+    const [loadingMore, setLoadingMore] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    async function loadMore() {
+        if (!nextPageToken || loadingMore)
+            return;
+        setLoadingMore(true);
+        setError(null);
+        try {
+            const url = new URL(ADMIN_ENDPOINTS.MAINTENANCE_CLOUD_LOGS, window.location.origin);
+            url.searchParams.set("pageToken", nextPageToken);
+            const res = await fetch(url.toString());
+            const body = (await res.json());
+            if (!res.ok || !body.ok) {
+                setError(("error" in body && body.error) || `HTTP ${res.status}`);
+                return;
+            }
+            setEntries((prev) => [...prev, ...body.data.entries]);
+            setNextPageToken(body.data.nextPageToken);
+        }
+        catch (err) {
+            void normalizeError(err);
+            setError(err instanceof Error ? err.message : String(err));
+        }
+        finally {
+            setLoadingMore(false);
+        }
+    }
+    return (_jsxs(Div, { style: { padding: "1.5rem", maxWidth: "1400px", margin: "0 auto" }, children: [_jsx(Heading, { level: 1, style: { fontSize: "1.5rem", fontWeight: 600 }, children: title }), subtitle ? (_jsx(Text, { as: "p", style: { color: "var(--appkit-color-text-muted)", marginBottom: "1rem" }, children: subtitle })) : null, _jsxs(Span, { style: { fontSize: "0.85rem", color: "var(--appkit-color-text-muted)" }, children: [entries.length, " entries loaded"] }), error ? (_jsx(Text, { as: "p", style: { color: "var(--appkit-color-error)", marginTop: "0.5rem" }, children: error })) : null, _jsx(Div, { style: { overflowX: "auto", border: BORDER_STYLE, borderRadius: 6, marginTop: "0.75rem" }, children: _jsxs(Table, { style: { width: "100%", borderCollapse: "collapse", fontSize: "0.85rem" }, children: [_jsx(Thead, { style: { background: "var(--appkit-color-bg)" }, children: _jsx(Tr, { children: COLUMNS.map((c) => (_jsx(Th, { style: {
+                                        textAlign: "left",
+                                        padding: "0.5rem 0.75rem",
+                                        borderBottom: BORDER_STYLE,
+                                        width: c.width,
+                                        whiteSpace: "nowrap",
+                                    }, children: c.label }, c.key))) }) }), _jsx(Tbody, { children: entries.length === 0 ? (_jsx(Tr, { children: _jsx(Td, { colSpan: COLUMNS.length, style: { padding: "2rem", textAlign: "center", color: "var(--appkit-color-text-muted)" }, children: "No log entries in the selected window." }) })) : (entries.map((e) => (_jsxs(Tr, { style: { borderBottom: "1px solid var(--appkit-color-border-subtle)" }, children: [_jsx(Td, { style: { padding: "0.5rem 0.75rem", verticalAlign: "top", whiteSpace: "nowrap" }, children: fmt(e.timestamp) }), _jsx(Td, { style: { padding: "0.5rem 0.75rem", verticalAlign: "top" }, children: e.severity }), _jsx(Td, { style: { padding: "0.5rem 0.75rem", verticalAlign: "top" }, children: e.resourceType }), _jsx(Td, { style: { padding: "0.5rem 0.75rem", verticalAlign: "top", fontFamily: "monospace" }, children: e.message })] }, e.id)))) })] }) }), _jsx(Div, { style: { marginTop: "1rem", textAlign: "center" }, children: nextPageToken ? (_jsx(Button, { type: "button", onClick: loadMore, isLoading: loadingMore, children: "Load more" })) : entries.length > 0 ? (_jsx(Text, { style: { color: "var(--appkit-color-text-muted)", fontSize: "0.85rem" }, children: "No more entries." })) : null })] }));
+}

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

@@ -1,5 +1,5 @@
 export { getAuctionForDetail, getProductFeaturesForAuction } from "./data";
 export { assertAuctionActive, assertBidAmount, assertNotAuctionOwner, computeMinBid, shouldAutoExtend } from "./service";
 export { placeBidAction } from "./actions";
-export { AUCTIONS_PAGE_SIZE, AUCTIONS_ACTIVE_LIMIT, AUCTION_DEFAULT_EXTENSION_MINUTES, AUCTION_MIN_BID_INCREMENT_PAISE, AUCTION_SNIPING_WINDOW_SECONDS, } from "../../../shared/features/auctions/config";
+export { AUCTIONS_PAGE_SIZE, AUCTIONS_ACTIVE_LIMIT, AUCTION_DEFAULT_EXTENSION_MINUTES, AUCTION_MIN_BID_INCREMENT, AUCTION_SNIPING_WINDOW_SECONDS, } from "../../../shared/features/auctions/config";
 export { renderAuctionOgImage, renderAuctionOg, type AuctionOgData } from "./og";

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

@@ -1,5 +1,5 @@
 export { getAuctionForDetail, getProductFeaturesForAuction } from "./data";
 export { assertAuctionActive, assertBidAmount, assertNotAuctionOwner, computeMinBid, shouldAutoExtend } from "./service";
 export { placeBidAction } from "./actions";
-export { AUCTIONS_PAGE_SIZE, AUCTIONS_ACTIVE_LIMIT, AUCTION_DEFAULT_EXTENSION_MINUTES, AUCTION_MIN_BID_INCREMENT_PAISE, AUCTION_SNIPING_WINDOW_SECONDS, } from "../../../shared/features/auctions/config";
+export { AUCTIONS_PAGE_SIZE, AUCTIONS_ACTIVE_LIMIT, AUCTION_DEFAULT_EXTENSION_MINUTES, AUCTION_MIN_BID_INCREMENT, AUCTION_SNIPING_WINDOW_SECONDS, } from "../../../shared/features/auctions/config";
 export { renderAuctionOgImage, renderAuctionOg } from "./og";

package/dist/_internal/server/features/auctions/service.js

@@ -1,7 +1,7 @@
 import { productRepository } from "../../../../repositories";
 import { isAuctionListing } from "../../../../features/products/utils/listing-type";
 import { AuctionNotFoundError, AuctionEndedError, BidTooLowError, BidOnOwnAuctionError, } from "../../../shared/features/auctions/errors";
-import { AUCTION_MIN_BID_INCREMENT_PAISE, AUCTION_SNIPING_WINDOW_SECONDS, AUCTION_DEFAULT_EXTENSION_MINUTES, } from "../../../shared/features/auctions/config";
+import { AUCTION_MIN_BID_INCREMENT, AUCTION_SNIPING_WINDOW_SECONDS, AUCTION_DEFAULT_EXTENSION_MINUTES, } from "../../../shared/features/auctions/config";
 /** Assert an auction exists, is published, and is still active. Returns the product. */
 export async function assertAuctionActive(auctionId) {
     const product = await productRepository.findByIdOrSlug(auctionId).catch(() => null);
@@ -19,7 +19,7 @@ export async function assertAuctionActive(auctionId) {
 /** Compute the minimum valid bid given the current state. */
 export function computeMinBid(product) {
     const current = product.currentBid ?? product.startingBid ?? 0;
-    const increment = product.minBidIncrement ?? AUCTION_MIN_BID_INCREMENT_PAISE;
+    const increment = product.minBidIncrement ?? AUCTION_MIN_BID_INCREMENT;
     return current + increment;
 }
 /** Assert a bid amount is valid against the current auction state. */

package/dist/_internal/server/features/maintenance/cloud-logs-data.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Google Cloud Logging integration for the `/admin/maintenance/cloud-logs`
+ * page. Reuses the same 3-tier credential resolution as
+ * `providers/db-firebase/admin.ts` (local `firebase-admin-key.json` → Vercel
+ * `FIREBASE_ADMIN_*` env vars → Application Default Credentials), so no new
+ * env vars are required.
+ *
+ * Bounded to ONE `Logging#getEntries()` call per invocation — never
+ * `getEntriesStream()` in an unbounded loop — to respect the Vercel Hobby
+ * 10s sync-function ceiling (CLAUDE.md Rule #6). Pagination is client-driven
+ * via `nextPageToken`, not exhausted server-side.
+ *
+ * `@google-cloud/logging` is a consumer-side (root `package.json`) dependency
+ * — it is never imported at module scope here. The `Logging` client is
+ * lazily `require()`d inside a function body via `(module as any).require`,
+ * exactly like `admin.ts` lazily loads `firebase-admin/*`, so Turbopack never
+ * sees a static import of a Node-only client reachable from a client bundle
+ * (CLAUDE.md Root Cause #6 / #24). A minimal local interface describes the
+ * only surface we call — this file never imports `@google-cloud/logging`'s
+ * own types, so it type-checks even though the package is deliberately not
+ * listed as an appkit dependency (it lives in the consumer's root
+ * `package.json` only, since this integration is Next.js-route-only).
+ */
+export interface CloudLogEntry {
+    id: string;
+    timestamp: string;
+    severity: string;
+    resourceType: string;
+    resourceLabels: Record<string, string>;
+    logName: string;
+    message: string;
+}
+export interface ListCloudLogEntriesOpts {
+    /** Full Cloud Logging filter string. Defaults to a 24h `resource.type` window (see below). */
+    filter?: string;
+    /** Capped at 100. Defaults to 50. */
+    pageSize?: number;
+    /** Opaque continuation token from a previous call's `nextPageToken`. */
+    pageToken?: string;
+}
+export interface ListCloudLogEntriesResult {
+    entries: CloudLogEntry[];
+    nextPageToken: string | null;
+}
+/**
+ * Bounded, single-page Cloud Logging read. One `getEntries()` call per
+ * invocation — the caller drives further pages via `opts.pageToken`
+ * (client-side "Load more"), never a server-side exhaust loop.
+ */
+export declare const listCloudLogEntries: (opts?: ListCloudLogEntriesOpts) => Promise<ListCloudLogEntriesResult>;

package/dist/_internal/server/features/maintenance/cloud-logs-data.js

@@ -0,0 +1,152 @@
+/**
+ * Google Cloud Logging integration for the `/admin/maintenance/cloud-logs`
+ * page. Reuses the same 3-tier credential resolution as
+ * `providers/db-firebase/admin.ts` (local `firebase-admin-key.json` → Vercel
+ * `FIREBASE_ADMIN_*` env vars → Application Default Credentials), so no new
+ * env vars are required.
+ *
+ * Bounded to ONE `Logging#getEntries()` call per invocation — never
+ * `getEntriesStream()` in an unbounded loop — to respect the Vercel Hobby
+ * 10s sync-function ceiling (CLAUDE.md Rule #6). Pagination is client-driven
+ * via `nextPageToken`, not exhausted server-side.
+ *
+ * `@google-cloud/logging` is a consumer-side (root `package.json`) dependency
+ * — it is never imported at module scope here. The `Logging` client is
+ * lazily `require()`d inside a function body via `(module as any).require`,
+ * exactly like `admin.ts` lazily loads `firebase-admin/*`, so Turbopack never
+ * sees a static import of a Node-only client reachable from a client bundle
+ * (CLAUDE.md Root Cause #6 / #24). A minimal local interface describes the
+ * only surface we call — this file never imports `@google-cloud/logging`'s
+ * own types, so it type-checks even though the package is deliberately not
+ * listed as an appkit dependency (it lives in the consumer's root
+ * `package.json` only, since this integration is Next.js-route-only).
+ */
+import { cache } from "react";
+import { parsePrivateKey } from "../../../../providers/db-firebase/admin";
+function loadLogging() {
+    return module.require("@google-cloud/logging");
+}
+function nodePath() { return require("path"); }
+function nodeFs() { return require("fs"); }
+// process.cwd() is Node.js-only; access via module.require so the Edge
+// static analyser does not flag this file (mirrors admin.ts).
+function nodeCwd() { return module.require("process").cwd(); }
+// Plain module-scope singleton (not `declare global` + `globalThis`) — this
+// module is only ever reachable through one resolution path per process, so
+// a module-local cache is sufficient and avoids global-augmentation clashes
+// when the same declaration is picked up from both compiled `.d.ts` output
+// and live source under a `file:./appkit` consumer tsconfig include.
+let cachedLoggingClient = null;
+function getCached() {
+    return cachedLoggingClient;
+}
+function setCached(client) {
+    cachedLoggingClient = client;
+}
+function getLoggingClient() {
+    const cached = getCached();
+    if (cached)
+        return cached;
+    const { Logging } = loadLogging();
+    const keyPath = nodePath().join(nodeCwd(), "firebase-admin-key.json");
+    let client;
+    if (nodeFs().existsSync(keyPath)) {
+        // Local dev — the JSON key file also carries project_id, so the Logging
+        // client resolves the project automatically from `keyFilename`.
+        client = new Logging({ keyFilename: keyPath });
+    }
+    else if (process.env.FIREBASE_ADMIN_PROJECT_ID &&
+        process.env.FIREBASE_ADMIN_CLIENT_EMAIL &&
+        process.env.FIREBASE_ADMIN_PRIVATE_KEY) {
+        // Vercel — same three env vars the Firebase Admin SDK uses.
+        client = new Logging({
+            projectId: process.env.FIREBASE_ADMIN_PROJECT_ID.trim(),
+            credentials: {
+                client_email: process.env.FIREBASE_ADMIN_CLIENT_EMAIL.trim(),
+                private_key: parsePrivateKey(process.env.FIREBASE_ADMIN_PRIVATE_KEY),
+            },
+        });
+    }
+    else if (
+    // Application Default Credentials — Firebase Functions / Cloud Run / GCE.
+    process.env.FUNCTION_TARGET ||
+        process.env.K_SERVICE ||
+        process.env.FIREBASE_CONFIG ||
+        process.env.GOOGLE_APPLICATION_CREDENTIALS) {
+        const firebaseConfig = process.env.FIREBASE_CONFIG
+            ? JSON.parse(process.env.FIREBASE_CONFIG)
+            : {};
+        const projectId = firebaseConfig.projectId ?? process.env.GCLOUD_PROJECT;
+        client = new Logging(projectId ? { projectId } : {});
+    }
+    else {
+        throw new Error("@mohasinac/appkit: Cloud Logging credentials not found.\n" +
+            "Add firebase-admin-key.json to project root, or set " +
+            "FIREBASE_ADMIN_PROJECT_ID, FIREBASE_ADMIN_CLIENT_EMAIL, " +
+            "FIREBASE_ADMIN_PRIVATE_KEY environment variables.");
+    }
+    setCached(client);
+    return client;
+}
+const DEFAULT_WINDOW_HOURS = 24;
+const MAX_PAGE_SIZE = 100;
+const DEFAULT_PAGE_SIZE = 50;
+/**
+ * This project's Firebase Functions are all 2nd-gen
+ * (`firebase-functions/v2/*` — see
+ * `_internal/server/functions/bind-all.ts` + `jobs/runtime/adapters/firebase.ts`,
+ * which import exclusively from `firebase-functions/v2/{scheduler,firestore,https}`).
+ * 2nd-gen Functions run on Cloud Run under the hood, so their log entries
+ * carry `resource.type="cloud_run_revision"` — NOT the 1st-gen
+ * `"cloud_function"` resource type.
+ */
+const DEFAULT_RESOURCE_TYPE = "cloud_run_revision";
+function buildDefaultFilter() {
+    const since = new Date(Date.now() - DEFAULT_WINDOW_HOURS * 3600000).toISOString();
+    return `resource.type="${DEFAULT_RESOURCE_TYPE}" AND timestamp>="${since}"`;
+}
+function excerpt(value, max = 300) {
+    if (value === null || value === undefined || value === "")
+        return "";
+    const text = typeof value === "string" ? value : JSON.stringify(value);
+    return text.length > max ? text.slice(0, max) + "…" : text;
+}
+function toCloudLogEntry(raw, index) {
+    const metadata = raw.metadata ?? {};
+    const tsRaw = metadata.timestamp;
+    const timestamp = tsRaw instanceof Date
+        ? tsRaw.toISOString()
+        : typeof tsRaw === "string"
+            ? tsRaw
+            : new Date().toISOString();
+    const resource = metadata.resource ?? {};
+    return {
+        id: metadata.insertId ?? `${timestamp}-${index}`,
+        timestamp,
+        severity: String(metadata.severity ?? "DEFAULT"),
+        resourceType: resource.type ?? "unknown",
+        resourceLabels: resource.labels ?? {},
+        logName: metadata.logName ?? "",
+        message: excerpt(raw.data),
+    };
+}
+/**
+ * Bounded, single-page Cloud Logging read. One `getEntries()` call per
+ * invocation — the caller drives further pages via `opts.pageToken`
+ * (client-side "Load more"), never a server-side exhaust loop.
+ */
+export const listCloudLogEntries = cache(async (opts = {}) => {
+    const pageSize = Math.min(Math.max(opts.pageSize ?? DEFAULT_PAGE_SIZE, 1), MAX_PAGE_SIZE);
+    const filter = opts.filter?.trim() ? opts.filter.trim() : buildDefaultFilter();
+    const logging = getLoggingClient();
+    const [entries, , apiResponse] = await logging.getEntries({
+        filter,
+        pageSize,
+        orderBy: "timestamp desc",
+        ...(opts.pageToken ? { pageToken: opts.pageToken } : {}),
+    });
+    return {
+        entries: entries.map((e, i) => toCloudLogEntry(e, i)),
+        nextPageToken: apiResponse?.nextPageToken || null,
+    };
+});

package/dist/_internal/server/jobs/core/onOrderCreate.d.ts

@@ -1,18 +1,10 @@
 import type { JobContext } from "../runtime/types";
-interface OrderItem {
-    title?: string;
-    name?: string;
-}
-export interface NewOrder {
-    buyerDisplayName?: string;
-    buyerId?: string;
-    items?: OrderItem[];
-    totalAmount?: number;
-    storeId?: string;
-}
+import type { OrderDocument, OrderDocumentItem } from "../../../../features/orders/schemas/firestore";
+export type NewOrder = Pick<OrderDocument, "userName" | "userId" | "totalPrice" | "storeId"> & {
+    items?: Pick<OrderDocumentItem, "productTitle">[];
+};
 export interface HandleOrderCreateInput {
     orderId: string;
     order: NewOrder;
 }
 export declare function handleOrderCreate(input: HandleOrderCreateInput, ctx: JobContext): Promise<void>;
-export {};

package/dist/_internal/server/jobs/core/onOrderCreate.js

@@ -54,14 +54,14 @@ export async function handleOrderCreate(input, ctx) {
     }
     const items = order.items ?? [];
     const firstItem = items[0];
-    const firstItemName = firstItem?.title ?? firstItem?.name ?? "an item";
+    const firstItemName = firstItem?.productTitle ?? "an item";
     const additionalItemCount = Math.max(0, items.length - 1);
-    const buyerName = order.buyerDisplayName ?? "A customer";
+    const buyerName = order.userName ?? "A customer";
     const message = buildPurchaseAnnouncementMessage({
         buyerName,
         firstItemName,
         additionalItemCount,
-        totalAmount: order.totalAmount ?? 0,
+        totalAmount: order.totalPrice ?? 0,
         orderId,
     });
     const adminNumbersRaw = ctx.env("WHATSAPP_ADMIN_NOTIFY_NUMBERS") ?? "";

package/dist/_internal/server/jobs/core/onProductWrite.js

@@ -10,6 +10,14 @@ const UNAVAILABLE_PRODUCT_STATUSES = new Set([
     ProductStatusValues.ARCHIVED,
 ]);
 void UNAVAILABLE_PRODUCT_STATUSES;
+function getEffectiveCategory(doc) {
+    if (!doc)
+        return null;
+    const categorySlugs = doc.categorySlugs;
+    if (Array.isArray(categorySlugs) && categorySlugs.length > 0)
+        return categorySlugs[0];
+    return doc.category ?? null;
+}
 async function getParentIds(categoryId) {
     if (!categoryId)
         return [];
@@ -63,8 +71,12 @@ export async function handleProductWrite(input, ctx) {
     const { productId, before, after } = input;
     const beforeStatus = before?.status ?? null;
     const afterStatus = after?.status ?? null;
-    const beforeCategory = before?.category ?? null;
-    const afterCategory = after?.category ?? null;
+    // `category` is @deprecated in favor of `categorySlugs[]` — the repository's
+    // mapDoc() normalizes this on read, but a raw trigger snapshot bypasses that,
+    // so a product written via categorySlugs-only paths would otherwise silently
+    // no-op category metrics here. Prefer categorySlugs[0], fall back to legacy category.
+    const beforeCategory = getEffectiveCategory(before);
+    const afterCategory = getEffectiveCategory(after);
     const beforeStoreId = (before?.storeId || before?.sellerId) ?? null;
     const afterStoreId = (after?.storeId || after?.sellerId) ?? null;
     const isAuction = after?.listingType === PRODUCT_FIELDS.LISTING_TYPE_VALUES.AUCTION;

package/dist/_internal/shared/features/auctions/config.d.ts

@@ -2,5 +2,5 @@ export declare const AUCTIONS_PAGE_SIZE = 20;
 export declare const AUCTIONS_ACTIVE_LIMIT = 50;
 export declare const AUCTIONS_SITEMAP_LIMIT = 5000;
 export declare const AUCTION_DEFAULT_EXTENSION_MINUTES = 5;
-export declare const AUCTION_MIN_BID_INCREMENT_PAISE = 100;
+export declare const AUCTION_MIN_BID_INCREMENT = 1;
 export declare const AUCTION_SNIPING_WINDOW_SECONDS = 300;

package/dist/_internal/shared/features/auctions/config.js

@@ -2,5 +2,5 @@ export const AUCTIONS_PAGE_SIZE = 20;
 export const AUCTIONS_ACTIVE_LIMIT = 50;
 export const AUCTIONS_SITEMAP_LIMIT = 5000;
 export const AUCTION_DEFAULT_EXTENSION_MINUTES = 5;
-export const AUCTION_MIN_BID_INCREMENT_PAISE = 100; // ₹1
+export const AUCTION_MIN_BID_INCREMENT = 1; // ₹1
 export const AUCTION_SNIPING_WINDOW_SECONDS = 300; // 5 minutes — triggers auto-extend

package/dist/_internal/shared/features/auctions/schema.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 export const placeBidSchema = z.object({
     auctionId: z.string().min(1),
-    amount: z.number().int().positive("Bid amount must be a positive integer (paise)"),
+    amount: z.number().positive("Bid amount must be a positive number"),
 });
 export const cancelBidSchema = z.object({
     bidId: z.string().min(1),

package/dist/_internal/shared/features/cart/schema.js

@@ -3,7 +3,7 @@ const cartItemBaseSchema = z.object({
     productId: z.string().min(1),
     productTitle: z.string(),
     productImage: z.string().default(""),
-    price: z.number().int().min(0),
+    price: z.number().min(0),
     currency: z.string().default("INR"),
     storeId: z.string(),
     storeName: z.string().default(""),
@@ -21,7 +21,7 @@ const cartItemBaseSchema = z.object({
     ]),
     isOffer: z.boolean().optional(),
     offerId: z.string().optional(),
-    lockedPrice: z.number().int().optional(),
+    lockedPrice: z.number().optional(),
 });
 export const addToCartSchema = cartItemBaseSchema;
 export const updateCartItemSchema = z.object({

package/dist/_internal/shared/features/events/schema.js

@@ -12,7 +12,7 @@ export const eventInputSchema = z.object({
     imageUrl: z.string().url().optional(),
     location: z.string().max(300).optional(),
     isOnline: z.boolean().default(false),
-    entryFee: z.number().int().min(0).default(0),
+    entryFee: z.number().min(0).default(0),
 });
 export const eventUpdateSchema = eventInputSchema.partial().omit({ slug: true });
 export const registerForEventSchema = z.object({

package/dist/_internal/shared/features/orders/schema.js

@@ -14,7 +14,7 @@ export const createOrderSchema = z.object({
     items: z.array(z.object({
         productId: z.string().min(1),
         quantity: z.number().int().min(1),
-        price: z.number().int().min(0),
+        price: z.number().min(0),
     })).min(1, "Order must have at least one item"),
     shippingAddress: addressSchema,
     paymentMethod: z.enum(["razorpay", "cod", "upi"]),

package/dist/_internal/shared/features/products/schema.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-const priceSchema = z.number().int().min(0, "Price must be non-negative (paise)");
+const priceSchema = z.number().min(0, "Price must be non-negative");
 const conditionSchema = z.enum(["new", "like_new", "good", "fair", "poor", "used", "refurbished", "broken"]);
 export const productInputSchema = z.object({
     title: z.string().min(3, "Title must be at least 3 characters").max(200),
@@ -21,7 +21,7 @@ export const productInputSchema = z.object({
     returnPolicy: z.string().max(1000).optional(),
     shippingPaidBy: z.enum(["seller", "buyer"]).optional(),
     insurance: z.boolean().optional(),
-    insuranceCost: z.number().int().min(0).optional(),
+    insuranceCost: z.number().min(0).optional(),
     allowOffers: z.boolean().optional(),
     minOfferPercent: z.number().min(0).max(100).optional(),
     features: z.array(z.string()).max(50).optional(),
@@ -33,7 +33,7 @@ export const auctionInputSchema = productInputSchema.extend({
     startingBid: priceSchema,
     reservePrice: priceSchema.optional(),
     buyNowPrice: priceSchema.optional(),
-    minBidIncrement: z.number().int().min(1).optional(),
+    minBidIncrement: z.number().min(1).optional(),
     auctionEndDate: z.string().datetime({ offset: true }),
     autoExtendable: z.boolean().default(false),
     auctionExtensionMinutes: z.number().int().min(1).max(30).optional(),

package/dist/_internal/shared/features/promotions/schema.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { COUPON_CODE_PATTERN } from "./config";
 export const applyCouponSchema = z.object({
     code: z.string().regex(COUPON_CODE_PATTERN, "Invalid coupon code format").toUpperCase(),
-    cartTotal: z.number().int().min(0),
+    cartTotal: z.number().min(0),
     productIds: z.array(z.string()).optional(),
     categoryIds: z.array(z.string()).optional(),
     isFirstTimeUser: z.boolean().default(false),
@@ -15,8 +15,8 @@ export const createCouponSchema = z.object({
     sellerId: z.string().optional(),
     discount: z.object({
         value: z.number().min(0),
-        maxDiscount: z.number().int().min(0).optional(),
-        minPurchase: z.number().int().min(0).default(0),
+        maxDiscount: z.number().min(0).optional(),
+        minPurchase: z.number().min(0).default(0),
     }),
     usage: z.object({
         totalLimit: z.number().int().min(1).optional(),

package/dist/_internal/shared/fees/calculator.d.ts

@@ -17,25 +17,24 @@
 export interface FeeCommissionRates {
     platformFeePercent: number;
     gstPercent: number;
-    /** Rupee floor (not paise) — matches the existing `minimumTransactionFee` doc convention. */
-    minimumTransactionFee?: number;
+    /** Rupee floor (not paise) — matches the existing `minimumTransactionFee` doc convention. */ minimumTransactionFee?: number;
     gatewayFeePercent?: number;
 }
 export interface CheckoutFees {
-    /** Platform commission in paise. */
+    /** Platform commission in decimal rupees. */
     platformFee: number;
-    /** GST on the platform fee, in paise. */
+    /** GST on the platform fee, in decimal rupees. */
     gstOnFee: number;
     /** platformFee + gstOnFee, floored at minimumTransactionFee. */
     totalFee: number;
 }
 export declare function computeCheckoutFees(subtotal: number, commissions: FeeCommissionRates): CheckoutFees;
 export interface PayoutDeduction {
-    /** Platform commission in paise. */
+    /** Platform commission in decimal rupees. */
     platformFee: number;
-    /** Payment gateway cost, absorbed by the platform from the seller's share, in paise. */
+    /** Payment gateway cost, absorbed by the platform from the seller's share, in decimal rupees. */
     gatewayFee: number;
-    /** GST on the platform fee, in paise. */
+    /** GST on the platform fee, in decimal rupees. */
     gstOnFee: number;
     /** platformFee + gatewayFee + gstOnFee. */
     totalDeduction: number;

package/dist/client.d.ts

@@ -17,8 +17,8 @@ export { useApiQuery } from "./client/api/useApiQuery";
 export type { UseApiQueryOptions } from "./client/api/useApiQuery";
 export { useFeatureFlags } from "./client/api/useFeatureFlags";
 export type { FeatureFlagState } from "./client/api/useFeatureFlags";
-export { ServerErrorsListView, ServerErrorDetailView, MaintenanceDashboardView, AnalysisRunnerView, } from "./_internal/client/features/maintenance";
-export type { ServerErrorsListViewProps, ServerErrorDetailViewProps, MaintenanceDashboardViewProps, } from "./_internal/client/features/maintenance";
+export { ServerErrorsListView, ServerErrorDetailView, MaintenanceDashboardView, AnalysisRunnerView, CloudLogsListView, } from "./_internal/client/features/maintenance";
+export type { ServerErrorsListViewProps, ServerErrorDetailViewProps, MaintenanceDashboardViewProps, CloudLogsListViewProps, } from "./_internal/client/features/maintenance";
 export { registerClientAuthProvider, getClientAuthProvider, type IClientAuthProvider, } from "./contracts/client-auth";
 export { registerClientRealtimeProvider, getClientRealtimeProvider, type IClientRealtimeProvider, type RealtimeSnapshot, type Unsubscribe, } from "./contracts/client-realtime";
 export { registerClientSessionAdapter, getClientSessionAdapter, type IClientSessionAdapter, type AdapterAuthUser, type AuthUnsubscribe, } from "./contracts/client-session";
@@ -109,6 +109,7 @@ export type { UseEntityDeleteOptions, UseEntityDeleteReturn } from "./react/hook
 export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "./constants/index";
 export { SORT_DIR, sortBy } from "./constants/sort";
 export { SIEVE_OP, sieveFilter, sieveAnd, sieveMultiEq } from "./utils/sieve-builder";
+export { formatCurrency } from "./utils/number.formatter";
 export { Container, Grid, Row, Stack } from "./ui/components/Layout";
 export { Div } from "./ui/components/Div";
 export { DynamicBgDiv } from "./ui/components/DynamicBgDiv";
@@ -163,6 +164,7 @@ export type { AdminSidebarProps, AdminNavItem, AdminNavGroup } from "./features/
 export { AdminDashboardView, AdminAnalyticsView, AdminPageViewsReportView, AdminPrizeDrawsView, AdminCarouselView, AdminSublistingCategoriesView, AdminFulfillmentView, DataTable, DataListingView, useAdminListingData, toRecordArray, toStringValue, toRelativeDate } from "./features/admin/index";
 export type { AdminDashboardViewProps, AdminAnalyticsViewProps, AdminAnalyticsViewLabels, AdminPageViewsReportViewProps, AdminPrizeDrawsViewProps, AdminCarouselViewProps, AdminFulfillmentViewProps, AdminListingScaffoldRow, ListingViewConfig } from "./features/admin/index";
 export type { BulkActionItem } from "./ui/components/BulkActionBar";
+export { PERMISSION_GROUPS, PERMISSION_DOMAINS, getPermissionsForDomain, formatPermLabel } from "./features/auth/permissions/constants";
 export { ADMIN_ENDPOINTS } from "./constants/index";
 export { SELLER_ENDPOINTS } from "./constants/index";
 export { TourProvider, useTour } from "./_internal/client/features/tour/TourProvider";
@@ -334,8 +336,6 @@ export { Toggle } from "./ui/components/Toggle";
 export type { ToggleProps } from "./ui/components/Toggle";
 export { SellerStoreCategoriesView } from "./features/seller/components/SellerStoreCategoriesView";
 export type { SellerStoreCategoriesViewProps } from "./features/seller/components/SellerStoreCategoriesView";
-export { SellerTemplatesView } from "./features/seller/components/SellerTemplatesView";
-export type { SellerTemplatesViewProps } from "./features/seller/components/SellerTemplatesView";
 export { SellerPayoutMethodsView } from "./features/seller/components/SellerPayoutMethodsView";
 export type { SellerPayoutMethodsViewProps } from "./features/seller/components/SellerPayoutMethodsView";
 export { SellerShippingConfigsView } from "./features/seller/components/SellerShippingConfigsView";

package/dist/client.js

@@ -19,7 +19,7 @@ export { useApiQuery } from "./client/api/useApiQuery";
 export { useFeatureFlags } from "./client/api/useFeatureFlags";
 // [CLIENT-ONLY] Maintenance UI — listing + detail + dashboard + analysis runner.
 // Consumed by the /admin/maintenance/* page shims.
-export { ServerErrorsListView, ServerErrorDetailView, MaintenanceDashboardView, AnalysisRunnerView, } from "./_internal/client/features/maintenance";
+export { ServerErrorsListView, ServerErrorDetailView, MaintenanceDashboardView, AnalysisRunnerView, CloudLogsListView, } from "./_internal/client/features/maintenance";
 // Provider registration — pure contract modules with zero server dependencies.
 // Exported here so consumers can import registration functions from
 // @mohasinac/appkit/client without pulling in firebase-admin or other server code.
@@ -170,6 +170,7 @@ export { useEntityDelete } from "./react/hooks/useEntityDelete";
 export { ROUTES, PUBLIC_ROUTES, PROTECTED_ROUTES, AUTH_ROUTES } from "./constants/index";
 export { SORT_DIR, sortBy } from "./constants/sort";
 export { SIEVE_OP, sieveFilter, sieveAnd, sieveMultiEq } from "./utils/sieve-builder";
+export { formatCurrency } from "./utils/number.formatter";
 export { Container, Grid, Row, Stack } from "./ui/components/Layout";
 export { Div } from "./ui/components/Div";
 export { DynamicBgDiv } from "./ui/components/DynamicBgDiv";
@@ -202,6 +203,8 @@ export { ToastProvider, SkipToMain, NavigationLoader } from "./ui/index";
 export { ZodSetup } from "./validation/ZodSetup";
 export { AdminSidebar } from "./features/admin/components/AdminSidebar";
 export { AdminDashboardView, AdminAnalyticsView, AdminPageViewsReportView, AdminPrizeDrawsView, AdminCarouselView, AdminSublistingCategoriesView, AdminFulfillmentView, DataTable, DataListingView, useAdminListingData, toRecordArray, toStringValue, toRelativeDate } from "./features/admin/index";
+// S-ADMIN-7 — permission catalog data, shared by AdminEmployeeEditorView and the read-only /admin/permissions page.
+export { PERMISSION_GROUPS, PERMISSION_DOMAINS, getPermissionsForDomain, formatPermLabel } from "./features/auth/permissions/constants";
 export { ADMIN_ENDPOINTS } from "./constants/index";
 export { SELLER_ENDPOINTS } from "./constants/index";
 // P-16 — Tour system (driver.js-backed onboarding walkthrough).
@@ -327,7 +330,6 @@ export { PhysicalLocationModal } from "./features/seller/components/PhysicalLoca
 export { Toggle } from "./ui/components/Toggle";
 // [CLIENT] Wave 4 seller management views.
 export { SellerStoreCategoriesView } from "./features/seller/components/SellerStoreCategoriesView";
-export { SellerTemplatesView } from "./features/seller/components/SellerTemplatesView";
 export { SellerPayoutMethodsView } from "./features/seller/components/SellerPayoutMethodsView";
 export { SellerShippingConfigsView } from "./features/seller/components/SellerShippingConfigsView";
 export { SellerGoogleReviewsView } from "./features/seller/components/SellerGoogleReviewsView";