@mohasinac/appkit 2.5.1 → 2.6.1

package/dist/jobs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `@mohasinac/appkit/jobs` — Firebase Functions binders + job handlers.
+ *
+ * Carved out of `server-entry.ts` 2026-05-12 because the import chain reaches
+ * `firebase-functions/v2/{https,scheduler,firestore}`, which is only
+ * available in the Firebase Functions runtime — not in Vercel Next.js
+ * lambdas. Re-exporting these from the main server surface forced every
+ * consumer (including the letitrip Next app) to install `firebase-functions`
+ * as a dep just to get past `next build`.
+ *
+ * Now: only the `appkit/functions/` package imports this subpath. The
+ * letitrip Next app never reaches `firebase-functions` because it's not in
+ * any of the chains rooted at `@mohasinac/appkit` or
+ * `@mohasinac/appkit/server`.
+ *
+ * Usage (functions/src/index.ts):
+ *   import {
+ *     bindToFirebase,
+ *     couponExpiryHandler,
+ *     listingProcessorHandler,
+ *   } from "@mohasinac/appkit/jobs";
+ */
+export { couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onBidPlacedHandler, onReviewWriteHandler, promotionsHandler, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, payoutBatchHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, storeAnalyticsHandler, listingProcessorHandler, supportedListingCollections, bindSchedule, bindDocumentWritten, bindDocumentCreated, bindDocumentUpdated, bindCallable, bindHttps, bindToFirebase, } from "./_internal/server/jobs/index.js";
+export type { PromotionsCallableResult, AdminAnalyticsResult, StoreAnalyticsInput, StoreAnalyticsResult, ListingRequestBody, ListingResponseBody, JobContext, JobLogger, JobHandlers, ScheduleHandler, FirestoreTriggerHandler, FirestoreTriggerEvent, CallableHandler, BindHttpsOptions, } from "./_internal/server/jobs/index.js";

package/dist/jobs.js

@@ -0,0 +1,27 @@
+/**
+ * `@mohasinac/appkit/jobs` — Firebase Functions binders + job handlers.
+ *
+ * Carved out of `server-entry.ts` 2026-05-12 because the import chain reaches
+ * `firebase-functions/v2/{https,scheduler,firestore}`, which is only
+ * available in the Firebase Functions runtime — not in Vercel Next.js
+ * lambdas. Re-exporting these from the main server surface forced every
+ * consumer (including the letitrip Next app) to install `firebase-functions`
+ * as a dep just to get past `next build`.
+ *
+ * Now: only the `appkit/functions/` package imports this subpath. The
+ * letitrip Next app never reaches `firebase-functions` because it's not in
+ * any of the chains rooted at `@mohasinac/appkit` or
+ * `@mohasinac/appkit/server`.
+ *
+ * Usage (functions/src/index.ts):
+ *   import {
+ *     bindToFirebase,
+ *     couponExpiryHandler,
+ *     listingProcessorHandler,
+ *   } from "@mohasinac/appkit/jobs";
+ */
+export { 
+// S4–S5: Job handlers (pure, framework-agnostic)
+couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onBidPlacedHandler, onReviewWriteHandler, promotionsHandler, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, payoutBatchHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, storeAnalyticsHandler, listingProcessorHandler, supportedListingCollections, 
+// Firebase binder adapter
+bindSchedule, bindDocumentWritten, bindDocumentCreated, bindDocumentUpdated, bindCallable, bindHttps, bindToFirebase, } from "./_internal/server/jobs/index.js";

package/dist/next/api/routeHandler.js

@@ -128,10 +128,12 @@ export function createRouteHandler(options) {
             return response;
         }
         catch (err) {
-            // Structured errors thrown with .status
-            const status = typeof err?.status === "number"
-                ? err.status
-                : 500;
+            const e = err;
+            const status = typeof e?.statusCode === "number"
+                ? e.statusCode
+                : typeof e?.status === "number"
+                    ? e.status
+                    : 500;
             const message = err instanceof Error ? err.message : "Internal server error";
             // 401/403 are expected for protected routes and should not be error-noisy.
             if (status >= 500) {

package/dist/server-entry.d.ts

@@ -36,8 +36,6 @@ export { createCheckoutOrderAction, attachPaymentAction, formatShippingAddress,
 export { createPaymentIntentAction, verifyPaymentSignatureAction, resolvePaymentFee, PAYMENTS_DEFAULT_RAZORPAY_FEE_PERCENT, PAYMENTS_RECEIPT_PREFIX, type CreatePaymentIntentInput, type CreatePaymentIntentResult, type VerifyPaymentSignatureInput, type ResolvedPaymentFee, } from "./_internal/server/features/payments/index";
 export { getSublistingCategoryForDetail } from "./_internal/server/features/sublisting-categories/index";
 export { getStoreForDetail, listStoreProductsInitial, listStoreAuctionsInitial, listStorePreOrdersInitial, listSitemapStores, STORES_PAGE_SIZE, STORES_PRODUCTS_PAGE_SIZE, STORES_SITEMAP_LIMIT, STORES_FEATURED_LIMIT, } from "./_internal/server/features/stores/index";
-export { couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onBidPlacedHandler, onReviewWriteHandler, promotionsHandler, type PromotionsCallableResult, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, payoutBatchHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, type AdminAnalyticsResult, storeAnalyticsHandler, type StoreAnalyticsInput, type StoreAnalyticsResult, listingProcessorHandler, supportedListingCollections, type ListingRequestBody, type ListingResponseBody, bindSchedule, bindDocumentWritten, bindDocumentCreated, bindDocumentUpdated, bindCallable, bindHttps, bindToFirebase, } from "./_internal/server/jobs/index";
-export type { JobContext, JobLogger, JobHandlers, ScheduleHandler, FirestoreTriggerHandler, FirestoreTriggerEvent, CallableHandler, } from "./_internal/server/jobs/index";
 export { AppShell, DashboardScaffold } from "./_internal/client/scaffolds/index";
 export type { AppShellProps, AppShellRenderContext, DashboardScaffoldProps, DashboardScaffoldRenderContext, } from "./_internal/client/scaffolds/index";
 export { toClient, clientInitial } from "./_internal/shared/serialization/index";

package/dist/server-entry.js

@@ -62,8 +62,11 @@ export { createPaymentIntentAction, verifyPaymentSignatureAction, resolvePayment
 export { getSublistingCategoryForDetail } from "./_internal/server/features/sublisting-categories/index";
 // S3: stores data layer
 export { getStoreForDetail, listStoreProductsInitial, listStoreAuctionsInitial, listStorePreOrdersInitial, listSitemapStores, STORES_PAGE_SIZE, STORES_PRODUCTS_PAGE_SIZE, STORES_SITEMAP_LIMIT, STORES_FEATURED_LIMIT, } from "./_internal/server/features/stores/index";
-// S4–S5: Job handlers + runtime (dormant until consumer's functions/ wires them via bindToFirebase)
-export { couponExpiryHandler, offerExpiryHandler, cartPruneHandler, notificationPruneHandler, dailyDataCleanupHandler, cleanupRtdbEventsHandler, auctionSettlementHandler, autoPayoutEligibilityHandler, countersReconcileHandler, onOrderCreateHandler, onOrderStatusChangeHandler, onBidPlacedHandler, onReviewWriteHandler, promotionsHandler, mediaTmpCleanupHandler, pendingOrderTimeoutHandler, productStatsSyncHandler, positionsReconcileHandler, payoutBatchHandler, weeklyPayoutEligibilityHandler, onCategoryWriteHandler, onProductWriteHandler, onStoreWriteHandler, adminAnalyticsHandler, storeAnalyticsHandler, listingProcessorHandler, supportedListingCollections, bindSchedule, bindDocumentWritten, bindDocumentCreated, bindDocumentUpdated, bindCallable, bindHttps, bindToFirebase, } from "./_internal/server/jobs/index";
+// S4–S5: Job handlers + Firebase binders moved to the `@mohasinac/appkit/jobs`
+// subpath (2.6.0, 2026-05-12). The chain reaches `firebase-functions/v2/*`
+// which is only available in the Firebase Functions runtime, not in Vercel
+// Next.js lambdas. Consumers that need them (i.e. `functions/src/index.ts`)
+// import directly from `@mohasinac/appkit/jobs`.
 // S6: client scaffolds (server-side type-aware import; runtime is "use client")
 export { AppShell, DashboardScaffold } from "./_internal/client/scaffolds/index";
 // CC-3: hydration helpers

package/dist/ui/components/Button.js

@@ -1,7 +1,19 @@
+"use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import React from "react";
+import React, { useCallback } from "react";
 import { twMerge } from "tailwind-merge";
 import { Loader2 } from "lucide-react";
+function spawnRipple(host, clientX, clientY) {
+    const rect = host.getBoundingClientRect();
+    const size = Math.max(rect.width, rect.height);
+    const ripple = document.createElement("span");
+    ripple.className = "appkit-button__ripple";
+    ripple.style.width = ripple.style.height = `${size}px`;
+    ripple.style.left = `${clientX - rect.left - size / 2}px`;
+    ripple.style.top = `${clientY - rect.top - size / 2}px`;
+    host.appendChild(ripple);
+    ripple.addEventListener("animationend", () => ripple.remove(), { once: true });
+}
 /**
  * Button — versatile button with multiple variants, sizes, and loading state.
  *
@@ -27,6 +39,13 @@ const UI_BUTTON = {
 };
 export function Button({ variant = "primary", size = "md", className = "", isLoading = false, disabled, children, asChild = false, ...props }) {
     const classes = twMerge(UI_BUTTON.base, UI_BUTTON.variants[variant], UI_BUTTON.sizes[size], className);
+    const userOnClick = props.onClick;
+    const handleClick = useCallback((event) => {
+        if (!disabled && !isLoading) {
+            spawnRipple(event.currentTarget, event.clientX, event.clientY);
+        }
+        userOnClick?.(event);
+    }, [disabled, isLoading, userOnClick]);
     if (asChild && React.isValidElement(children)) {
         const child = children;
         return React.cloneElement(child, {
@@ -35,5 +54,5 @@ export function Button({ variant = "primary", size = "md", className = "", isLoa
             ...(disabled ? { "aria-disabled": true } : {}),
         });
     }
-    return (_jsxs("button", { className: classes, disabled: disabled || isLoading, "aria-busy": isLoading || undefined, ...props, children: [isLoading && (_jsx(Loader2, { className: "appkit-button__spinner", "aria-hidden": "true" })), isLoading ? (_jsx("span", { className: "appkit-button__content appkit-button__content--loading", children: children })) : (_jsx("span", { className: "appkit-button__content", children: children }))] }));
+    return (_jsxs("button", { className: classes, disabled: disabled || isLoading, "aria-busy": isLoading || undefined, ...props, onClick: handleClick, children: [isLoading && (_jsx(Loader2, { className: "appkit-button__spinner", "aria-hidden": "true" })), isLoading ? (_jsx("span", { className: "appkit-button__content appkit-button__content--loading", children: children })) : (_jsx("span", { className: "appkit-button__content", children: children }))] }));
 }

package/dist/ui/components/Button.style.css

@@ -11,6 +11,40 @@
   transition: all 0.2s ease;
   cursor: pointer;
   user-select: none;
+  position: relative;
+  overflow: hidden;
+  isolation: isolate;
+}
+
+.appkit-button__ripple {
+  position: absolute;
+  border-radius: 9999px;
+  background: currentColor;
+  opacity: 0.28;
+  pointer-events: none;
+  transform: scale(0);
+  animation: appkit-button-ripple 520ms cubic-bezier(0.22, 0.61, 0.36, 1) forwards;
+  z-index: 0;
+}
+
+.appkit-button__content,
+.appkit-button__spinner {
+  position: relative;
+  z-index: 1;
+}
+
+@keyframes appkit-button-ripple {
+  to {
+    transform: scale(2.4);
+    opacity: 0;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .appkit-button__ripple {
+    animation-duration: 1ms;
+    opacity: 0;
+  }
 }
 
 .appkit-button:focus-visible {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "2.5.1",
+  "version": "2.6.1",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -39,6 +39,10 @@
       "types": "./dist/server.d.ts",
       "import": "./dist/server.js"
     },
+    "./jobs": {
+      "types": "./dist/jobs.d.ts",
+      "import": "./dist/jobs.js"
+    },
     "./providers": {
       "types": "./dist/providers.d.ts",
       "import": "./dist/providers.js"