@mohasinac/appkit 3.6.3 → 3.6.4

package/dist/react/hooks/realtime-event-constants.d.ts

@@ -0,0 +1,50 @@
+import type { JsonValue } from "../../schemas/types";
+/**
+ * Plain constants + types shared between client hooks (useRealtimeEvent) and
+ * server-side RTDB writers (e.g. src/app/api/auth/event/init/route.ts).
+ *
+ * Deliberately NOT in a "use client" file. useRealtimeEvent.ts is "use
+ * client" (it uses React hooks), and Next.js's server bundler replaces every
+ * export of a "use client" module with an opaque client-reference when a
+ * server module imports it directly — including plain, non-React constants
+ * like RTDBPayloadStatus. A server route importing RTDBPayloadStatus.PENDING
+ * from the old location got `undefined` at runtime, which Firebase RTDB's
+ * `.set()` rejects outright ("value argument contains undefined in property
+ * ...status"), silently breaking every RTDB-backed realtime event (Google
+ * OAuth popup flow, payment event bridge, chat) in production. Confirmed via
+ * live Vercel logs 2026-08-17.
+ */
+export declare const RealtimeEventType: {
+    readonly AUTH: "auth";
+    readonly PAYMENT: "payment";
+    readonly CHAT: "chat";
+    readonly BID: "bid";
+    readonly BULK: "bulk";
+};
+export type RealtimeEventType = (typeof RealtimeEventType)[keyof typeof RealtimeEventType];
+export declare const RealtimeEventStatus: {
+    readonly IDLE: "idle";
+    readonly SUBSCRIBING: "subscribing";
+    readonly PENDING: "pending";
+    readonly SUCCESS: "success";
+    readonly FAILED: "failed";
+    readonly TIMEOUT: "timeout";
+};
+export type RealtimeEventStatus = (typeof RealtimeEventStatus)[keyof typeof RealtimeEventStatus];
+export declare const RTDBPayloadStatus: {
+    readonly PENDING: "pending";
+    readonly SUCCESS: "success";
+    readonly FAILED: "failed";
+    readonly ERROR: "error";
+};
+export interface RTDBEventPayload {
+    status: (typeof RTDBPayloadStatus)[keyof typeof RTDBPayloadStatus];
+    error?: string;
+    [key: string]: JsonValue | undefined;
+}
+export interface RealtimeEventMessages {
+    tokenFailure?: string;
+    connectionLost?: string;
+    timedOut?: string;
+    failure?: string;
+}

package/dist/react/hooks/realtime-event-constants.js

@@ -0,0 +1,36 @@
+/**
+ * Plain constants + types shared between client hooks (useRealtimeEvent) and
+ * server-side RTDB writers (e.g. src/app/api/auth/event/init/route.ts).
+ *
+ * Deliberately NOT in a "use client" file. useRealtimeEvent.ts is "use
+ * client" (it uses React hooks), and Next.js's server bundler replaces every
+ * export of a "use client" module with an opaque client-reference when a
+ * server module imports it directly — including plain, non-React constants
+ * like RTDBPayloadStatus. A server route importing RTDBPayloadStatus.PENDING
+ * from the old location got `undefined` at runtime, which Firebase RTDB's
+ * `.set()` rejects outright ("value argument contains undefined in property
+ * ...status"), silently breaking every RTDB-backed realtime event (Google
+ * OAuth popup flow, payment event bridge, chat) in production. Confirmed via
+ * live Vercel logs 2026-08-17.
+ */
+export const RealtimeEventType = {
+    AUTH: "auth",
+    PAYMENT: "payment",
+    CHAT: "chat",
+    BID: "bid",
+    BULK: "bulk",
+};
+export const RealtimeEventStatus = {
+    IDLE: "idle",
+    SUBSCRIBING: "subscribing",
+    PENDING: "pending",
+    SUCCESS: "success",
+    FAILED: "failed",
+    TIMEOUT: "timeout",
+};
+export const RTDBPayloadStatus = {
+    PENDING: "pending",
+    SUCCESS: "success",
+    FAILED: "failed",
+    ERROR: "error",
+};

package/dist/react/hooks/useRealtimeEvent.d.ts

@@ -1,39 +1,6 @@
-import type { JsonValue } from "../../schemas/types";
 import { type IClientRealtimeProvider } from "../../contracts/client-realtime";
-export declare const RealtimeEventType: {
-    readonly AUTH: "auth";
-    readonly PAYMENT: "payment";
-    readonly CHAT: "chat";
-    readonly BID: "bid";
-    readonly BULK: "bulk";
-};
-export type RealtimeEventType = (typeof RealtimeEventType)[keyof typeof RealtimeEventType];
-export declare const RealtimeEventStatus: {
-    readonly IDLE: "idle";
-    readonly SUBSCRIBING: "subscribing";
-    readonly PENDING: "pending";
-    readonly SUCCESS: "success";
-    readonly FAILED: "failed";
-    readonly TIMEOUT: "timeout";
-};
-export type RealtimeEventStatus = (typeof RealtimeEventStatus)[keyof typeof RealtimeEventStatus];
-export declare const RTDBPayloadStatus: {
-    readonly PENDING: "pending";
-    readonly SUCCESS: "success";
-    readonly FAILED: "failed";
-    readonly ERROR: "error";
-};
-export interface RTDBEventPayload {
-    status: (typeof RTDBPayloadStatus)[keyof typeof RTDBPayloadStatus];
-    error?: string;
-    [key: string]: JsonValue | undefined;
-}
-export interface RealtimeEventMessages {
-    tokenFailure?: string;
-    connectionLost?: string;
-    timedOut?: string;
-    failure?: string;
-}
+import { RealtimeEventType, RealtimeEventStatus, RTDBPayloadStatus, type RTDBEventPayload, type RealtimeEventMessages } from "./realtime-event-constants";
+export { RealtimeEventType, RealtimeEventStatus, RTDBPayloadStatus, type RTDBEventPayload, type RealtimeEventMessages, };
 export interface UseRealtimeEventConfig<TData = undefined> {
     type: RealtimeEventType;
     rtdbPath: string;

package/dist/react/hooks/useRealtimeEvent.js

@@ -2,27 +2,13 @@
 import { normalizeError } from "../../errors/normalize";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { getClientRealtimeProvider, } from "../../contracts/client-realtime";
-export const RealtimeEventType = {
-    AUTH: "auth",
-    PAYMENT: "payment",
-    CHAT: "chat",
-    BID: "bid",
-    BULK: "bulk",
-};
-export const RealtimeEventStatus = {
-    IDLE: "idle",
-    SUBSCRIBING: "subscribing",
-    PENDING: "pending",
-    SUCCESS: "success",
-    FAILED: "failed",
-    TIMEOUT: "timeout",
-};
-export const RTDBPayloadStatus = {
-    PENDING: "pending",
-    SUCCESS: "success",
-    FAILED: "failed",
-    ERROR: "error",
-};
+import { RealtimeEventType, RealtimeEventStatus, RTDBPayloadStatus, } from "./realtime-event-constants";
+// Re-exported for existing client import paths — the canonical definitions
+// now live in realtime-event-constants.ts (a plain, non-"use client" module)
+// so server code can import them without hitting the client-reference
+// substitution Next.js applies to "use client" module exports. See that
+// file's comment for the full story.
+export { RealtimeEventType, RealtimeEventStatus, RTDBPayloadStatus, };
 const DEFAULT_TIMEOUT_MS = 3 * 60 * 1000;
 const DEFAULT_MESSAGES = {
     tokenFailure: "Failed to initialize realtime tracking.",

package/dist/react/index.d.ts

@@ -52,5 +52,7 @@ export { useModalStack } from "./useModalStack";
 export type { ModalEntry } from "./useModalStack";
 export { ErrorBoundary } from "./ErrorBoundary";
 export type { ErrorBoundaryProps } from "./ErrorBoundary";
-export { useRealtimeEvent, RealtimeEventType, RealtimeEventStatus, RTDBPayloadStatus, } from "./hooks/useRealtimeEvent";
-export type { RTDBEventPayload, RealtimeEventMessages, RealtimeEventType as RealtimeEventTypeValue, RealtimeEventStatus as RealtimeEventStatusValue, UseRealtimeEventConfig, UseRealtimeEventReturn, } from "./hooks/useRealtimeEvent";
+export { useRealtimeEvent } from "./hooks/useRealtimeEvent";
+export type { UseRealtimeEventConfig, UseRealtimeEventReturn, } from "./hooks/useRealtimeEvent";
+export { RealtimeEventType, RealtimeEventStatus, RTDBPayloadStatus, } from "./hooks/realtime-event-constants";
+export type { RTDBEventPayload, RealtimeEventMessages, RealtimeEventType as RealtimeEventTypeValue, RealtimeEventStatus as RealtimeEventStatusValue, } from "./hooks/realtime-event-constants";

package/dist/react/index.js

@@ -53,4 +53,11 @@ export { useModalStack } from "./useModalStack";
 // Error boundary
 export { ErrorBoundary } from "./ErrorBoundary";
 // Realtime event bridge
-export { useRealtimeEvent, RealtimeEventType, RealtimeEventStatus, RTDBPayloadStatus, } from "./hooks/useRealtimeEvent";
+// RealtimeEventType/RealtimeEventStatus/RTDBPayloadStatus/RTDBEventPayload/
+// RealtimeEventMessages come from realtime-event-constants.ts (plain module,
+// no "use client") rather than useRealtimeEvent.ts directly — server code
+// importing these via the main @mohasinac/appkit barrel needs the real
+// values, not the client-reference placeholder Next.js substitutes for
+// "use client" module exports.
+export { useRealtimeEvent } from "./hooks/useRealtimeEvent";
+export { RealtimeEventType, RealtimeEventStatus, RTDBPayloadStatus, } from "./hooks/realtime-event-constants";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "3.6.3",
+  "version": "3.6.4",
   "license": "MIT",
   "publishConfig": {
     "access": "public"