@mohasinac/appkit 2.5.0 → 2.6.0

package/dist/configs/next.js

@@ -16,6 +16,12 @@
  */
 const FIREBASE_EXTERNAL_PACKAGES = [
     "firebase-admin",
+    // firebase-functions is only ever resolved inside the actual Firebase
+    // Functions runtime (appkit/functions). Next.js API routes in Vercel
+    // lambdas never call these binders, but the import chain reaches
+    // `_internal/server/jobs/runtime/adapters/firebase.js` via server-entry.
+    // Externalising avoids needing `firebase-functions` in consumer deps.
+    "firebase-functions",
     "@google-cloud/firestore",
     "@google-cloud/storage",
     "@google-cloud/common",

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "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"