@mohasinac/appkit 2.2.0 → 2.3.1

package/dist/monitoring/server-logger.d.ts

@@ -1,4 +1,13 @@
-import "server-only";
+/**
+ * Server-Side Error Logging Utilities
+ *
+ * Shared logger for API routes, server components, and server actions.
+ * Attaches request metadata when a NextRequest is available and writes
+ * structured log files in local environments.
+ *
+ * IMPORTANT: Only import this file in server-side code. For client-side code
+ * use `client-logger.ts`.
+ */
 import { type NextRequest } from "next/server";
 export interface ServerErrorContext {
     userId?: string;

package/dist/monitoring/server-logger.js

@@ -1,4 +1,3 @@
-import "server-only";
 /**
  * Server-Side Error Logging Utilities
  *
@@ -9,12 +8,31 @@ import "server-only";
  * IMPORTANT: Only import this file in server-side code. For client-side code
  * use `client-logger.ts`.
  */
-import { appendFile, mkdir, readdir, rename, stat, unlink } from "fs/promises";
-import { existsSync } from "fs";
-import path from "path";
 import { redactPii } from "../security/pii-redact";
 import { AppError } from "../errors";
-const LOGS_DIR = path.join(process.cwd(), "logs");
+// fs/path are Node.js built-ins that must NOT be imported at the top level.
+// Doing so causes Next.js Edge bundler warnings because this file is reachable
+// from the instrumentation hook, which is compiled for both Edge and Node.
+// Using require() calls inside functions keeps the imports out of the static
+// analysis graph and prevents Edge Runtime warnings.
+/* eslint-disable @typescript-eslint/no-require-imports */
+function nodeFsPromises() {
+    return require("fs/promises");
+}
+function nodeFs() {
+    return require("fs");
+}
+function nodePath() {
+    return require("path");
+}
+// process.cwd() is a Node.js-only API. Access it through module.require so
+// Next.js Edge static analysis does not flag this file.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function nodeCwd() { return module.require("process").cwd(); }
+/* eslint-enable @typescript-eslint/no-require-imports */
+function getLogsDir() {
+    return nodePath().join(nodeCwd(), "logs");
+}
 const MAX_LOG_FILE_SIZE = 10 * 1024 * 1024;
 const MAX_LOG_FILES = 10;
 const isFileLoggingEnabled = !process.env.VERCEL;
@@ -47,13 +65,14 @@ function normalizeLogData(data) {
     return data;
 }
 async function ensureLogsDir() {
-    if (!existsSync(LOGS_DIR)) {
-        await mkdir(LOGS_DIR, { recursive: true });
+    const logsDir = getLogsDir();
+    if (!nodeFs().existsSync(logsDir)) {
+        await nodeFsPromises().mkdir(logsDir, { recursive: true });
     }
 }
 function getLogFilePath(level) {
     const date = new Date().toISOString().split("T")[0];
-    return path.join(LOGS_DIR, `${level}-${date}.log`);
+    return nodePath().join(getLogsDir(), `${level}-${date}.log`);
 }
 function formatLogEntry(entry) {
     const sanitized = entry.data ? redactPii(entry.data) : undefined;
@@ -64,12 +83,13 @@ function formatLogEntry(entry) {
 }
 async function cleanOldLogFiles(logsDir) {
     try {
+        const { readdir, stat, unlink } = nodeFsPromises();
         const files = await readdir(logsDir);
         const logFiles = files
             .filter((file) => file.endsWith(".log"))
             .map((file) => ({
             name: file,
-            path: path.join(logsDir, file),
+            path: nodePath().join(logsDir, file),
         }));
         if (logFiles.length <= MAX_LOG_FILES)
             return;
@@ -87,15 +107,16 @@ async function cleanOldLogFiles(logsDir) {
 }
 async function rotateLogFileIfNeeded(filePath) {
     try {
-        if (!existsSync(filePath))
+        if (!nodeFs().existsSync(filePath))
             return;
+        const { stat, rename } = nodeFsPromises();
         const fileStats = await stat(filePath);
         if (fileStats.size < MAX_LOG_FILE_SIZE)
             return;
         const timestamp = Date.now();
-        const dir = path.dirname(filePath);
-        const filename = path.basename(filePath, ".log");
-        const rotatedPath = path.join(dir, `${filename}.${timestamp}.log`);
+        const dir = nodePath().dirname(filePath);
+        const filename = nodePath().basename(filePath, ".log");
+        const rotatedPath = nodePath().join(dir, `${filename}.${timestamp}.log`);
         await rename(filePath, rotatedPath);
         await cleanOldLogFiles(dir);
     }
@@ -108,7 +129,7 @@ async function writeLog(entry) {
         await ensureLogsDir();
         const filePath = getLogFilePath(entry.level);
         await rotateLogFileIfNeeded(filePath);
-        await appendFile(filePath, formatLogEntry(entry));
+        await nodeFsPromises().appendFile(filePath, formatLogEntry(entry));
     }
     catch (error) {
         console.error("Failed to write log:", error);

package/dist/next/ErrorBoundary.d.ts

@@ -14,6 +14,6 @@ export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBo
     static getDerivedStateFromError(error: Error): ErrorBoundaryState;
     componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
     private reset;
-    render(): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+    render(): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
 }
 export {};

package/dist/next/ErrorBoundary.js

@@ -3,8 +3,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Component } from "react";
 import { Button } from "../ui/components/Button";
 import { Heading, Text } from "../ui/components/Typography";
+import { THEME_CONSTANTS } from "../tokens";
 function DefaultFallback({ error, onReset, }) {
-    return (_jsxs("div", { className: "flex min-h-[40vh] flex-col items-center justify-center gap-4 rounded-xl border border-zinc-200 bg-white p-6 text-center dark:border-slate-700 dark:bg-slate-900", children: [_jsx(Heading, { level: 2, children: "Something went wrong" }), _jsx(Text, { variant: "secondary", children: "An unexpected error occurred. Please try again." }), process.env.NODE_ENV === "development" && error ? (_jsx("pre", { className: "max-w-full overflow-auto rounded-md bg-zinc-100 p-3 text-left text-xs dark:bg-slate-800", children: error.message })) : null, _jsx(Button, { type: "button", onClick: onReset, children: "Try again" })] }));
+    return (_jsxs("div", { className: `flex min-h-[40vh] flex-col items-center justify-center ${THEME_CONSTANTS.spacing.gap.md} rounded-xl border border-zinc-200 bg-white p-6 text-center dark:border-slate-700 dark:bg-slate-900`, "data-section": "errorboundary-div-445", children: [_jsx(Heading, { level: 2, children: "Something went wrong" }), _jsx(Text, { variant: "secondary", children: "An unexpected error occurred. Please try again." }), process.env.NODE_ENV === "development" && error ? (_jsx("pre", { className: "max-w-full overflow-auto rounded-md bg-zinc-100 p-3 text-left text-xs dark:bg-slate-800", children: error.message })) : null, _jsx(Button, { type: "button", onClick: onReset, children: "Try again" })] }));
 }
 export class ErrorBoundary extends Component {
     constructor(props) {

package/dist/next/api/apiHandler.d.ts

@@ -20,6 +20,15 @@ export interface ApiHandlerOptions<TInput, TParams extends Record<string, string
     roles?: TRole[];
     rateLimit?: TRateLimitConfig;
     schema?: SafeParseSchema<TInput>;
+    /**
+     * Response cache policy for unauthenticated GET handlers.
+     * Use `false` to disable default public cache headers.
+     */
+    cache?: false | {
+        maxAge?: number;
+        sMaxAge?: number;
+        staleWhileRevalidate?: number;
+    };
     handler: (ctx: {
         request: Request;
         user?: TUser;

package/dist/next/api/apiHandler.js

@@ -1,3 +1,9 @@
+function buildPublicCacheControl(policy) {
+    const maxAge = policy?.maxAge ?? 30;
+    const sMaxAge = policy?.sMaxAge ?? 300;
+    const staleWhileRevalidate = policy?.staleWhileRevalidate ?? 600;
+    return `public, max-age=${maxAge}, s-maxage=${sMaxAge}, stale-while-revalidate=${staleWhileRevalidate}`;
+}
 export function createApiHandlerFactory(deps) {
     return function createApiHandler(options) {
         return async (request, context) => {
@@ -65,6 +71,20 @@ export function createApiHandlerFactory(deps) {
                         response.headers.set(key, value);
                     }
                 }
+                const hasCredentialHeaders = !!request.headers.get("authorization") || !!request.headers.get("cookie");
+                const hasRoleGuards = !!options.roles && options.roles.length > 0;
+                const canApplyDefaultPublicCache = request.method === "GET" &&
+                    !options.auth &&
+                    !hasRoleGuards &&
+                    options.cache !== false &&
+                    !hasCredentialHeaders &&
+                    response.status >= 200 &&
+                    response.status < 300 &&
+                    !response.headers.has("Cache-Control");
+                if (canApplyDefaultPublicCache) {
+                    const policy = typeof options.cache === "object" ? options.cache : undefined;
+                    response.headers.set("Cache-Control", buildPublicCacheControl(policy));
+                }
                 deps.logTiming({
                     method: request.method,
                     path: new URL(request.url).pathname,

package/dist/next/api/routeHandler.d.ts

@@ -43,6 +43,15 @@ interface RouteHandlerOptions<TInput = unknown, TParams = Record<string, string>
     roles?: string[];
     /** Zod schema to validate + parse the JSON request body. */
     schema?: ParseableSchema<TInput>;
+    /**
+     * Response cache policy for unauthenticated GET routes.
+     * Use `false` to disable default public cache headers.
+     */
+    cache?: false | {
+        maxAge?: number;
+        sMaxAge?: number;
+        staleWhileRevalidate?: number;
+    };
     /** Route handler. `user` is present when `auth: true`. */
     handler: (ctx: {
         request: Request;

package/dist/next/api/routeHandler.js

@@ -17,6 +17,12 @@
  */
 import { NextResponse } from "next/server.js";
 import { getProviders } from "../../contracts";
+function buildPublicCacheControl(policy) {
+    const maxAge = policy?.maxAge ?? 30;
+    const sMaxAge = policy?.sMaxAge ?? 300;
+    const staleWhileRevalidate = policy?.staleWhileRevalidate ?? 600;
+    return `public, max-age=${maxAge}, s-maxage=${sMaxAge}, stale-while-revalidate=${staleWhileRevalidate}`;
+}
 /** Read the `__session` HTTP-only cookie from request headers. */
 function readSessionCookie(request) {
     const cookieHeader = request.headers.get("cookie") ?? "";
@@ -60,7 +66,7 @@ async function verifySession(request) {
 export function createRouteHandler(options) {
     return async (request, context) => {
         try {
-            // ── Auth ──────────────────────────────────────────────────────────────
+            // -- Auth --------------------------------------------------------------
             let user;
             const needsAuth = options.auth || (options.roles && options.roles.length > 0);
             if (needsAuth) {
@@ -71,7 +77,7 @@ export function createRouteHandler(options) {
                     return NextResponse.json({ success: false, error: "Insufficient permissions" }, { status: 403 });
                 }
             }
-            // ── Body validation ───────────────────────────────────────────────────
+            // -- Body validation ---------------------------------------------------
             let body;
             if (options.schema) {
                 let raw;
@@ -91,14 +97,27 @@ export function createRouteHandler(options) {
                 }
                 body = result.data;
             }
-            // ── Params ────────────────────────────────────────────────────────────
+            // -- Params ------------------------------------------------------------
             const params = context?.params ? await context.params : undefined;
-            return await options.handler({
+            const response = await options.handler({
                 request,
                 user,
                 body,
                 params: params,
             });
+            const hasCredentialHeaders = !!request.headers.get("authorization") || !!request.headers.get("cookie");
+            const canApplyDefaultPublicCache = request.method === "GET" &&
+                !needsAuth &&
+                options.cache !== false &&
+                !hasCredentialHeaders &&
+                response.status >= 200 &&
+                response.status < 300 &&
+                !response.headers.has("Cache-Control");
+            if (canApplyDefaultPublicCache) {
+                const policy = typeof options.cache === "object" ? options.cache : undefined;
+                response.headers.set("Cache-Control", buildPublicCacheControl(policy));
+            }
+            return response;
         }
         catch (err) {
             // Structured errors thrown with .status
@@ -106,7 +125,13 @@ export function createRouteHandler(options) {
                 ? err.status
                 : 500;
             const message = err instanceof Error ? err.message : "Internal server error";
-            console.error(`[createRouteHandler] ${request.method} failed`, err);
+            // 401/403 are expected for protected routes and should not be error-noisy.
+            if (status >= 500) {
+                console.error(`[createRouteHandler] ${request.method} failed`, err);
+            }
+            else if (status >= 400 && status !== 401 && status !== 403) {
+                console.warn(`[createRouteHandler] ${request.method} failed (${status})`, err);
+            }
             return NextResponse.json({ success: false, error: message }, { status });
         }
     };

package/dist/next/routing/route-map.d.ts

@@ -31,6 +31,8 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly STORE_REVIEWS: (storeSlug: string) => string;
         readonly STORE_ABOUT: (storeSlug: string) => string;
         readonly CATEGORIES: "/categories";
+        readonly CATEGORY_DETAIL: (slug: string) => string;
+        readonly REVIEWS: "/reviews";
         readonly SEARCH: "/search";
         readonly PROMOTIONS: "/promotions";
         readonly ABOUT: "/about";
@@ -56,7 +58,6 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly EVENTS: "/events";
         readonly EVENT_DETAIL: (id: string) => string;
         readonly EVENT_PARTICIPATE: (id: string) => string;
-        readonly REVIEWS: "/reviews";
     };
     readonly ERRORS: {
         readonly UNAUTHORIZED: "/unauthorized";
@@ -129,6 +130,7 @@ export declare const DEFAULT_ROUTE_MAP: {
         readonly STORES: "/admin/stores";
         readonly FEATURE_FLAGS: "/admin/feature-flags";
         readonly COPILOT: "/admin/copilot";
+        readonly ADS: "/admin/ads";
     };
     readonly DEMO: {
         readonly SEED: "/demo/seed";
@@ -160,6 +162,8 @@ export declare const ROUTES: {
         readonly STORE_REVIEWS: (storeSlug: string) => string;
         readonly STORE_ABOUT: (storeSlug: string) => string;
         readonly CATEGORIES: "/categories";
+        readonly CATEGORY_DETAIL: (slug: string) => string;
+        readonly REVIEWS: "/reviews";
         readonly SEARCH: "/search";
         readonly PROMOTIONS: "/promotions";
         readonly ABOUT: "/about";
@@ -185,7 +189,6 @@ export declare const ROUTES: {
         readonly EVENTS: "/events";
         readonly EVENT_DETAIL: (id: string) => string;
         readonly EVENT_PARTICIPATE: (id: string) => string;
-        readonly REVIEWS: "/reviews";
     };
     readonly ERRORS: {
         readonly UNAUTHORIZED: "/unauthorized";
@@ -258,6 +261,7 @@ export declare const ROUTES: {
         readonly STORES: "/admin/stores";
         readonly FEATURE_FLAGS: "/admin/feature-flags";
         readonly COPILOT: "/admin/copilot";
+        readonly ADS: "/admin/ads";
     };
     readonly DEMO: {
         readonly SEED: "/demo/seed";

package/dist/next/routing/route-map.js

@@ -19,6 +19,8 @@ export const DEFAULT_ROUTE_MAP = {
         STORE_REVIEWS: (storeSlug) => `/stores/${storeSlug}/reviews`,
         STORE_ABOUT: (storeSlug) => `/stores/${storeSlug}/about`,
         CATEGORIES: "/categories",
+        CATEGORY_DETAIL: (slug) => `/categories/${slug}`,
+        REVIEWS: "/reviews",
         SEARCH: "/search",
         PROMOTIONS: "/promotions",
         ABOUT: "/about",
@@ -44,7 +46,6 @@ export const DEFAULT_ROUTE_MAP = {
         EVENTS: "/events",
         EVENT_DETAIL: (id) => `/events/${id}`,
         EVENT_PARTICIPATE: (id) => `/events/${id}/participate`,
-        REVIEWS: "/reviews",
     },
     ERRORS: {
         UNAUTHORIZED: "/unauthorized",
@@ -117,6 +118,7 @@ export const DEFAULT_ROUTE_MAP = {
         STORES: "/admin/stores",
         FEATURE_FLAGS: "/admin/feature-flags",
         COPILOT: "/admin/copilot",
+        ADS: "/admin/ads",
     },
     DEMO: {
         SEED: "/demo/seed",

package/dist/providers/auth-firebase/helpers.js

@@ -16,7 +16,7 @@ const EXPECTED_AUTH_CODES = new Set([
     "auth/user-disabled",
     "auth/user-not-found",
 ]);
-// ─── Token helpers ────────────────────────────────────────────────────────────
+// --- Token helpers ------------------------------------------------------------
 /** Verify a Firebase ID token. Returns null for expected auth failures. */
 export async function verifyIdToken(token) {
     try {
@@ -121,7 +121,7 @@ export async function requireRole(cookies, role, resolveRole) {
     }
     return { ...user, role: userRole };
 }
-// ─── Server-action / RSC helpers (no-arg, reads Next.js cookie store) ─────────
+// --- Server-action / RSC helpers (no-arg, reads Next.js cookie store) ---------
 /**
  * Require authentication in a Server Action or RSC context.
  * Reads `__session` / `idToken` cookies via `next/headers` `cookies()`.
@@ -141,7 +141,7 @@ export async function requireRoleUser(role, resolveRole) {
     const cookieStore = await cookies();
     return requireRole(cookieStore, role, resolveRole);
 }
-// ─── Request-level helpers ────────────────────────────────────────────────────
+// --- Request-level helpers ----------------------------------------------------
 /**
  * Resolve the `__session` cookie from a `Request` or `NextRequest`.
  * Handles both Next.js request objects and standard Web API `Request`.

package/dist/providers/db-firebase/admin-app-lite.d.ts

@@ -1,4 +1,3 @@
-import "server-only";
 import { type App } from "firebase-admin/app";
 declare global {
     var __mohasinac_firebase_admin_app_lite__: App | null | undefined;

package/dist/providers/db-firebase/admin-app-lite.js

@@ -1,7 +1,12 @@
-import "server-only";
 import { initializeApp, getApps, cert } from "firebase-admin/app";
-import * as path from "path";
-import * as fs from "fs";
+/* eslint-disable @typescript-eslint/no-require-imports */
+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.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function nodeCwd() { return module.require("process").cwd(); }
+/* eslint-enable @typescript-eslint/no-require-imports */
 function parsePrivateKey(raw) {
     return raw
         .replace(/^["']|["']$/g, "")
@@ -18,10 +23,10 @@ export function getAdminAppLite() {
         globalThis.__mohasinac_firebase_admin_app_lite__ = existing;
         return existing;
     }
-    const keyPath = path.join(process.cwd(), "firebase-admin-key.json");
+    const keyPath = nodePath().join(nodeCwd(), "firebase-admin-key.json");
     let app;
-    if (fs.existsSync(keyPath)) {
-        const sa = JSON.parse(fs.readFileSync(keyPath, "utf8"));
+    if (nodeFs().existsSync(keyPath)) {
+        const sa = JSON.parse(nodeFs().readFileSync(keyPath, "utf8"));
         const dbUrl = process.env.NEXT_PUBLIC_FIREBASE_DATABASE_URL ??
             `https://${sa.project_id}-default-rtdb.firebaseio.com`;
         app = initializeApp({ credential: cert(keyPath), databaseURL: dbUrl });

package/dist/providers/db-firebase/admin-storage-lite.d.ts

@@ -1,4 +1,3 @@
-import "server-only";
 import { type Storage } from "firebase-admin/storage";
 declare global {
     var __mohasinac_firebase_admin_storage_lite__: Storage | null | undefined;

package/dist/providers/db-firebase/admin-storage-lite.js

@@ -1,4 +1,3 @@
-import "server-only";
 import { getStorage as getFirebaseStorage, } from "firebase-admin/storage";
 import { getAdminAppLite } from "./admin-app-lite";
 export function getAdminStorageLite() {

package/dist/providers/db-firebase/admin.d.ts

@@ -7,7 +7,6 @@
  *
  * All getters are lazy — the SDK is not touched until first use.
  */
-import "server-only";
 import type { App } from "firebase-admin/app";
 import type { Auth } from "firebase-admin/auth";
 import type { Firestore } from "firebase-admin/firestore";

package/dist/providers/db-firebase/admin.js

@@ -1,15 +1,10 @@
-/**
- * Firebase Admin SDK singletons.
- *
- * Supports two init methods (checked in order):
- *   1. `firebase-admin-key.json` in process.cwd() — development
- *   2. FIREBASE_ADMIN_PROJECT_ID / CLIENT_EMAIL / PRIVATE_KEY env vars — production
- *
- * All getters are lazy — the SDK is not touched until first use.
- */
-import "server-only";
-import * as path from "path";
-import * as fs from "fs";
+/* eslint-disable @typescript-eslint/no-require-imports */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+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.
+function nodeCwd() { return module.require("process").cwd(); }
 // Lazy loaders — prevents webpack from bundling firebase-admin into browser chunks.
 // (module as any).require() is used because webpack's static analysis does NOT trace
 // module.require() calls, unlike calls to the literal `require` or aliased `require`.
@@ -31,7 +26,7 @@ function loadDatabase() {
     return module.require("firebase-admin/database");
 }
 /* eslint-enable @typescript-eslint/no-require-imports */
-// ─── Private key normalisation ────────────────────────────────────────────────
+// --- Private key normalisation ------------------------------------------------
 //
 // Vercel (and other platforms) can store the private key in several formats:
 //   1. Literal \n sequences  (common — copied from JSON value)
@@ -55,7 +50,7 @@ function get(key) {
 function set(key, value) {
     globalThis[key] = value;
 }
-// ─── App ──────────────────────────────────────────────────────────────────────
+// --- App ----------------------------------------------------------------------
 export function getAdminApp() {
     const cached = get("__mohasinac_firebase_admin_app__");
     if (cached)
@@ -66,11 +61,11 @@ export function getAdminApp() {
         set("__mohasinac_firebase_admin_app__", existing);
         return existing;
     }
-    const keyPath = path.join(process.cwd(), "firebase-admin-key.json");
+    const keyPath = nodePath().join(nodeCwd(), "firebase-admin-key.json");
     let app;
     try {
-        if (fs.existsSync(keyPath)) {
-            const sa = JSON.parse(fs.readFileSync(keyPath, "utf8"));
+        if (nodeFs().existsSync(keyPath)) {
+            const sa = JSON.parse(nodeFs().readFileSync(keyPath, "utf8"));
             const dbUrl = process.env.NEXT_PUBLIC_FIREBASE_DATABASE_URL ??
                 `https://${sa.project_id}-default-rtdb.firebaseio.com`;
             app = initializeApp({ credential: cert(keyPath), databaseURL: dbUrl });
@@ -105,7 +100,7 @@ export function getAdminApp() {
     set("__mohasinac_firebase_admin_app__", app);
     return app;
 }
-// ─── Auth ─────────────────────────────────────────────────────────────────────
+// --- Auth ---------------------------------------------------------------------
 export function getAdminAuth() {
     const cached = get("__mohasinac_firebase_admin_auth__");
     if (cached)
@@ -115,7 +110,7 @@ export function getAdminAuth() {
     set("__mohasinac_firebase_admin_auth__", auth);
     return auth;
 }
-// ─── Firestore ────────────────────────────────────────────────────────────────
+// --- Firestore ----------------------------------------------------------------
 export function getAdminDb() {
     const cached = get("__mohasinac_firebase_admin_db__");
     if (cached)
@@ -133,7 +128,7 @@ export function getAdminDb() {
     set("__mohasinac_firebase_admin_db__", db);
     return db;
 }
-// ─── Cloud Storage ────────────────────────────────────────────────────────────
+// --- Cloud Storage ------------------------------------------------------------
 export function getAdminStorage() {
     const cached = get("__mohasinac_firebase_admin_storage__");
     if (cached)
@@ -143,7 +138,7 @@ export function getAdminStorage() {
     set("__mohasinac_firebase_admin_storage__", storage);
     return storage;
 }
-// ─── Realtime DB ──────────────────────────────────────────────────────────────
+// --- Realtime DB --------------------------------------------------------------
 export function getAdminRealtimeDb() {
     const cached = get("__mohasinac_firebase_admin_rtdb__");
     if (cached)

package/dist/providers/db-firebase/base.d.ts

@@ -1,4 +1,3 @@
-import "server-only";
 /**
  * FirebaseRepository<T>
  *