@mohasinac/appkit 4.41.0 → 4.41.1

package/dist/features/tester/seed-data/stores-tester-seed-data.d.ts

@@ -1,2 +0,0 @@
-import type { StoreDocument } from "../../stores/schemas";
-export declare const storesTesterSeedData: Partial<StoreDocument>[];

package/dist/features/tester/seed-data/stores-tester-seed-data.js

@@ -1,79 +0,0 @@
-/*
- * WHY: Shared tester sandbox — one auto-approved test store testers browse/buy from and
- *      use as a reference when creating their own listings. Auto-expires after 7 days
- *      (testerSandboxCleanup) and is invisible to non-testers (application-layer filter).
- * WHAT: Exports 2 StoreDocument partials tagged isTestData:true — the shared sandbox
- *       (owned by admin) and the automated runner's OWN store.
- *
- * 🛑 TWO STORES, TWO OWNERS, AND THE SPLIT IS LOAD-BEARING.
- *
- * `store-tester-sandbox` stays owned by `user-admin-letitrip`. Several authored cases
- * name that owner explicitly — buying__bidding.ts:211 says "Sign in as admin@letitrip.in,
- * the owner of store-tester-sandbox", and :228 warns that signing in as anyone else
- * "gives a 403 that reads like a permissions bug and is not one". Repointing it would
- * turn those cases into false failures.
- *
- * `store-claude-tester` exists because `user-claude-tester` owned NO store while its user
- * document carried `storeId: "store-tester-qa-seller"` — a store whose `ownerId` is
- * `user-tester-qa`. The app resolves sellers by `ownerId`, so every /api/store/* call for
- * the runner returned 403 "No store found for this account" while the full Store Panel
- * rendered over it. That one-way pointer blocked 36 checklist cases (measured, run
- * 1789300124915). Root Cause #42's denormalised-mirror shape on the user<->store axis.
- *
- * It is deliberately EMPTY of listings. The seller cases it unblocks are create/CRUD
- * flows (listing-lifecycle, coupons, bundles, classifieds), which want a clean store;
- * cases that need pre-existing stock still use the shared sandbox.
- *
- * EXPORTS:
- *   storesTesterSeedData — Array of 2 Partial<StoreDocument> for the seed runner
- *
- * @tag domain:stores,tester
- * @tag layer:seed
- * @tag pattern:none
- * @tag access:server-only
- * @tag consumers:seed/index.ts,seed-cli.mjs
- * @tag sideEffects:none
- */
-import { STORE_FIELDS } from "../../../constants/field-names";
-import { seedPhoto } from "../../../seed/_helpers/media";
-import { testDataExpiresAt } from "./tester-ttl";
-export const storesTesterSeedData = [
-    {
-        id: "store-tester-sandbox",
-        storeSlug: "store-tester-sandbox",
-        ownerId: "user-admin-letitrip",
-        storeName: "Tester Sandbox Store",
-        storeDescription: "Shared test store for the tester QA program. Products here are disposable and auto-expire — buy, bid, and review freely.",
-        storeCategory: "category-tester-sandbox",
-        storeLogoURL: seedPhoto("store-logo-tester-sandbox-20260101", 400, 400),
-        storeBannerURL: seedPhoto("store-banner-tester-sandbox-20260101", 1600, 400),
-        status: STORE_FIELDS.STATUS_VALUES.ACTIVE,
-        isPublic: true,
-        bio: "This store exists only for tester QA. Everything in it is disposable test data.",
-        returnPolicy: "N/A — test data.",
-        shippingPolicy: "N/A — test data.",
-        isTestData: true,
-        testDataExpiresAt: testDataExpiresAt(),
-        createdAt: new Date(),
-        updatedAt: new Date(),
-    },
-    {
-        id: "store-claude-tester",
-        storeSlug: "store-claude-tester",
-        ownerId: "user-claude-tester",
-        storeName: "Claude Tester Store",
-        storeDescription: "The automated checklist runner's own store. Exists so seller-side create/edit flows can be exercised against a store the runner actually owns. Disposable test data.",
-        storeCategory: "category-tester-sandbox",
-        storeLogoURL: seedPhoto("store-logo-claude-tester-20260101", 400, 400),
-        storeBannerURL: seedPhoto("store-banner-claude-tester-20260101", 1600, 400),
-        status: STORE_FIELDS.STATUS_VALUES.ACTIVE,
-        isPublic: true,
-        bio: "Automated tester's store. Everything in it is disposable test data.",
-        returnPolicy: "N/A — test data.",
-        shippingPolicy: "N/A — test data.",
-        isTestData: true,
-        testDataExpiresAt: testDataExpiresAt(),
-        createdAt: new Date(),
-        updatedAt: new Date(),
-    },
-];

package/dist/features/wishlist/components/WishlistToggleButton.d.ts

@@ -1,12 +0,0 @@
-import type { MouseEvent } from "react";
-interface WishlistToggleButtonProps {
-    inWishlist: boolean;
-    isLoading?: boolean;
-    onToggle: (e: MouseEvent) => void | Promise<void>;
-    addLabel: string;
-    removeLabel: string;
-    className?: string;
-    size?: "sm" | "md" | "lg";
-}
-export declare function WishlistToggleButton({ inWishlist, isLoading, onToggle, addLabel, removeLabel, className, size, }: WishlistToggleButtonProps): import("react").JSX.Element;
-export {};

package/dist/features/wishlist/components/WishlistToggleButton.js

@@ -1,36 +0,0 @@
-"use client";
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from "react";
-import { Button, LoginRequiredModal } from "../../../ui";
-import { isAuthError } from "../../../utils/auth-error";
-import { normalizeError } from "../../../errors/normalize";
-const sizeClasses = {
-    sm: "w-7 h-7",
-    md: "w-9 h-9",
-    lg: "w-11 h-11",
-};
-export function WishlistToggleButton({ inWishlist, isLoading = false, onToggle, addLabel, removeLabel, className = "", size = "md", }) {
-    const label = inWishlist ? removeLabel : addLabel;
-    const [showLoginModal, setShowLoginModal] = useState(false);
-    async function handleClick(e) {
-        try {
-            await onToggle(e);
-        }
-        catch (err) {
-            void normalizeError(err);
-            if (isAuthError(err)) {
-                setShowLoginModal(true);
-            }
-        }
-    }
-    return (_jsxs(_Fragment, { children: [_jsx(LoginRequiredModal, { isOpen: showLoginModal, onClose: () => setShowLoginModal(false), message: "You need to be signed in to save items to your wishlist. Please log in or create an account." }), _jsx(Button, { type: "button", onClick: handleClick, disabled: isLoading, "aria-label": label, title: label, rounded: "full", className: `
- flex items-[center] justify-[center]
- transition-all duration-150
- ${inWishlist
-                    ? "bg-error-surface text-error hover:bg-error-surface"
-                    : "bg-[rgba(255,255,255,0.8)] text-[var(--appkit-color-text-faint)] hover:text-error"}
- ${sizeClasses[size]}
- ${isLoading ? "opacity-50 cursor-not-allowed" : "cursor-pointer"}
- ${className}
- `, children: _jsx("svg", { className: "w-4/6 h-4/6", viewBox: "0 0 24 24", fill: inWishlist ? "currentColor" : "none", stroke: "currentColor", strokeWidth: 2, children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z" }) }) })] }));
-}

package/dist/monitoring/analytics.d.ts

@@ -1,80 +0,0 @@
-import type { JsonValue } from "@mohasinac/appkit";
-export declare const ANALYTICS_EVENTS: {
-    readonly PAGE_VIEW: "page_view";
-    readonly LOGIN: "login";
-    readonly SIGN_UP: "sign_up";
-    readonly LOGOUT: "logout";
-    readonly VIEW_ITEM: "view_item";
-    readonly ADD_TO_CART: "add_to_cart";
-    readonly PURCHASE: "purchase";
-    readonly PLACE_BID: "place_bid";
-    readonly WIN_AUCTION: "win_auction";
-    readonly SEARCH: "search";
-    readonly VIEW_FAQ: "view_faq";
-};
-export type AnalyticsEvent = (typeof ANALYTICS_EVENTS)[keyof typeof ANALYTICS_EVENTS];
-export declare function initializeAnalytics(params: {
-    app: JsonValue;
-    enabled?: boolean;
-    currency?: string;
-}): Promise<void>;
-export declare const trackEvent: (eventName: string, eventParams?: Record<string, JsonValue>) => void;
-export declare const setAnalyticsUserId: (userId: string | null) => void;
-export declare const setAnalyticsUserProperties: (properties: Record<string, string | number | boolean>) => void;
-export declare const trackPageView: (page_path: string, page_title: string) => void;
-export declare const trackAuth: {
-    login: (method: "email" | "google" | "apple") => void;
-    register: (method: "email" | "google" | "apple") => void;
-    logout: () => void;
-};
-export declare const trackEcommerce: {
-    viewProduct: (product: {
-        id: string;
-        name: string;
-        category: string;
-        price: number;
-        currency?: string;
-    }) => void;
-    addToCart: (product: {
-        id: string;
-        name: string;
-        category: string;
-        price: number;
-        quantity: number;
-        currency?: string;
-    }) => void;
-    purchase: (order: {
-        id: string;
-        total: number;
-        tax?: number;
-        shipping?: number;
-        currency?: string;
-        items: Array<{
-            id: string;
-            name: string;
-            category: string;
-            price: number;
-            quantity: number;
-        }>;
-    }) => void;
-    placeBid: (product: {
-        id: string;
-        name: string;
-        bidAmount: number;
-    }) => void;
-    winAuction: (product: {
-        id: string;
-        name: string;
-        finalBid: number;
-    }) => void;
-};
-export declare const trackContent: {
-    search: (searchTerm: string, resultsCount: number) => void;
-    viewFaq: (faqId: string, question: string) => void;
-};
-export declare const trackForm: {
-    submit: (formName: string) => void;
-};
-export declare const trackAdmin: {
-    action: (action: string, target: string) => void;
-};

package/dist/monitoring/analytics.js

@@ -1,176 +0,0 @@
-import { normalizeError } from "../errors/normalize";
-import { getAnalytics, isSupported, logEvent, setUserId, setUserProperties, } from "firebase/analytics";
-import { logger } from "../core/Logger";
-let analytics = null;
-let analyticsEnabled = false;
-let ecommerceCurrency = "USD";
-export const ANALYTICS_EVENTS = {
-    PAGE_VIEW: "page_view",
-    LOGIN: "login",
-    SIGN_UP: "sign_up",
-    LOGOUT: "logout",
-    VIEW_ITEM: "view_item",
-    ADD_TO_CART: "add_to_cart",
-    PURCHASE: "purchase",
-    PLACE_BID: "place_bid",
-    WIN_AUCTION: "win_auction",
-    SEARCH: "search",
-    VIEW_FAQ: "view_faq",
-};
-export async function initializeAnalytics(params) {
-    analyticsEnabled = params.enabled ?? true;
-    if (params.currency) {
-        ecommerceCurrency = params.currency;
-    }
-    if (!analyticsEnabled)
-        return;
-    try {
-        const supported = await isSupported();
-        if (!supported)
-            return;
-        analytics = getAnalytics(params.app);
-    }
-    catch (error) {
-        void normalizeError(error);
-        analytics = null;
-        logger.warn("Firebase Analytics disabled", { error });
-    }
-}
-export const trackEvent = (eventName, eventParams) => {
-    if (!analytics || !analyticsEnabled)
-        return;
-    try {
-        logEvent(analytics, eventName, eventParams);
-    }
-    catch (error) {
-        void normalizeError(error);
-        logger.error(`Failed to log event ${eventName}`, { error });
-    }
-};
-export const setAnalyticsUserId = (userId) => {
-    if (!analytics || !analyticsEnabled)
-        return;
-    try {
-        setUserId(analytics, userId);
-    }
-    catch (error) {
-        void normalizeError(error);
-        logger.error("Failed to set user ID", { error });
-    }
-};
-export const setAnalyticsUserProperties = (properties) => {
-    if (!analytics || !analyticsEnabled)
-        return;
-    try {
-        setUserProperties(analytics, properties);
-    }
-    catch (error) {
-        void normalizeError(error);
-        logger.error("Failed to set user properties", { error });
-    }
-};
-export const trackPageView = (page_path, page_title) => {
-    trackEvent(ANALYTICS_EVENTS.PAGE_VIEW, {
-        page_path,
-        page_title,
-    });
-};
-export const trackAuth = {
-    login: (method) => {
-        trackEvent(ANALYTICS_EVENTS.LOGIN, { method });
-    },
-    register: (method) => {
-        trackEvent(ANALYTICS_EVENTS.SIGN_UP, { method });
-    },
-    logout: () => {
-        trackEvent(ANALYTICS_EVENTS.LOGOUT);
-    },
-};
-export const trackEcommerce = {
-    viewProduct: (product) => {
-        const currency = product.currency ?? ecommerceCurrency;
-        trackEvent(ANALYTICS_EVENTS.VIEW_ITEM, {
-            currency,
-            value: product.price,
-            items: [
-                {
-                    item_id: product.id,
-                    item_name: product.name,
-                    item_category: product.category,
-                    price: product.price,
-                },
-            ],
-        });
-    },
-    addToCart: (product) => {
-        const currency = product.currency ?? ecommerceCurrency;
-        trackEvent(ANALYTICS_EVENTS.ADD_TO_CART, {
-            currency,
-            value: product.price * product.quantity,
-            items: [
-                {
-                    item_id: product.id,
-                    item_name: product.name,
-                    item_category: product.category,
-                    price: product.price,
-                    quantity: product.quantity,
-                },
-            ],
-        });
-    },
-    purchase: (order) => {
-        const currency = order.currency ?? ecommerceCurrency;
-        trackEvent(ANALYTICS_EVENTS.PURCHASE, {
-            transaction_id: order.id,
-            currency,
-            value: order.total,
-            tax: order.tax || 0,
-            shipping: order.shipping || 0,
-            items: order.items.map((item) => ({
-                item_id: item.id,
-                item_name: item.name,
-                item_category: item.category,
-                price: item.price,
-                quantity: item.quantity,
-            })),
-        });
-    },
-    placeBid: (product) => {
-        trackEvent(ANALYTICS_EVENTS.PLACE_BID, {
-            product_id: product.id,
-            product_name: product.name,
-            bid_amount: product.bidAmount,
-        });
-    },
-    winAuction: (product) => {
-        trackEvent(ANALYTICS_EVENTS.WIN_AUCTION, {
-            product_id: product.id,
-            product_name: product.name,
-            final_bid: product.finalBid,
-        });
-    },
-};
-export const trackContent = {
-    search: (searchTerm, resultsCount) => {
-        trackEvent(ANALYTICS_EVENTS.SEARCH, {
-            search_term: searchTerm,
-            results_count: resultsCount,
-        });
-    },
-    viewFaq: (faqId, question) => {
-        trackEvent(ANALYTICS_EVENTS.VIEW_FAQ, {
-            faq_id: faqId,
-            question,
-        });
-    },
-};
-export const trackForm = {
-    submit: (formName) => {
-        trackEvent("form_submit", { form_name: formName });
-    },
-};
-export const trackAdmin = {
-    action: (action, target) => {
-        trackEvent("admin_action", { action, target });
-    },
-};

package/dist/next/middleware/pii-redactor.d.ts

@@ -1,32 +0,0 @@
-import type { AuthRequestContext, Middleware } from "./types";
-export interface PiiRedactionRule {
-    /** Fields to redact from the top-level object or items[] */
-    fields: string[];
-    /**
-     * If `true` (default), replace the value with a masked string like `a***@domain.com`.
-     * If `false`, remove the field entirely.
-     */
-    mask?: boolean;
-    /** Only redact if the caller does NOT have this permission string */
-    unless?: string;
-}
-/**
- * createPiiRedactorMiddleware — field-level PII redaction for non-owners.
- *
- * Removes or masks declared PII fields from the response body unless the
- * calling user holds the specified permission.
- *
- * @example
- * ```ts
- * const userListRedactor = createPiiRedactorMiddleware([
- * { fields: ["email", "phone"], mask: true, unless: "admin:users:pii" },
- * { fields: ["bankAccount"], mask: false, unless: "admin:payouts" },
- * ]);
- *
- * export const GET = createApiMiddleware({
- * permission: "admin:users",
- * middlewares: [userListRedactor],
- * })(async (input, ctx) => { ... });
- * ```
- */
-export declare function createPiiRedactorMiddleware(rules: PiiRedactionRule[]): Middleware<AuthRequestContext>;

package/dist/next/middleware/pii-redactor.js

@@ -1,84 +0,0 @@
-import { normalizeError } from "../../errors/normalize";
-import { NextResponse } from "next/server";
-function maskPii(value) {
-    if (value.includes("@")) {
-        const [local, domain] = value.split("@");
-        return `${local?.[0] ?? ""}***@${domain}`;
-    }
-    if (/^\+?\d{7,}$/.test(value)) {
-        return value.slice(0, 3) + "***" + value.slice(-2);
-    }
-    return "***";
-}
-function hasPermission(permissions, required) {
-    return permissions.has("*") || permissions.has(required);
-}
-function redactObject(obj, fields, mask) {
-    return fields.reduce((acc, field) => {
-        if (!(field in acc))
-            return acc;
-        const current = acc[field];
-        const redacted = { ...acc };
-        if (mask && typeof current === "string") {
-            redacted[field] = maskPii(current);
-        }
-        else {
-            delete redacted[field];
-        }
-        return redacted;
-    }, obj);
-}
-/**
- * createPiiRedactorMiddleware — field-level PII redaction for non-owners.
- *
- * Removes or masks declared PII fields from the response body unless the
- * calling user holds the specified permission.
- *
- * @example
- * ```ts
- * const userListRedactor = createPiiRedactorMiddleware([
- * { fields: ["email", "phone"], mask: true, unless: "admin:users:pii" },
- * { fields: ["bankAccount"], mask: false, unless: "admin:payouts" },
- * ]);
- *
- * export const GET = createApiMiddleware({
- * permission: "admin:users",
- * middlewares: [userListRedactor],
- * })(async (input, ctx) => { ... });
- * ```
- */
-export function createPiiRedactorMiddleware(rules) {
-    return async (_req, ctx, next) => {
-        const response = await next();
-        const contentType = response.headers.get("content-type") ?? "";
-        if (!contentType.includes("application/json"))
-            return response;
-        let body;
-        try {
-            body = (await response.json());
-        }
-        catch (_err) {
-            void normalizeError(_err);
-            return response;
-        }
-        for (const { fields, mask = true, unless } of rules) {
-            // Skip redaction if caller has the authorising permission
-            if (unless && hasPermission(ctx.user.permissions, unless))
-                continue;
-            // Handle both paginated { data: [] } and single-object responses
-            if (Array.isArray(body.data)) {
-                body = {
-                    ...body,
-                    data: body.data.map((item) => redactObject(item, fields, mask)),
-                };
-            }
-            else {
-                body = redactObject(body, fields, mask);
-            }
-        }
-        return NextResponse.json(body, {
-            status: response.status,
-            headers: response.headers,
-        });
-    };
-}

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

@@ -1,42 +0,0 @@
-/**
- * FirebaseRealtimeRepository<T>
- *
- * Abstract base implementing `IRealtimeRepository<T>` from `@mohasinac/contracts`
- * against Firebase Realtime Database (Admin SDK).
- *
- * Realtime DB does not support Firestore-style queries; `findAll()` loads the
- * entire collection node.  Use this only for small, high-churn datasets (e.g.
- * presence, chat, live-bid prices).
- *
- * Usage:
- * ```ts
- * class PresenceRepository extends FirebaseRealtimeRepository<PresenceEntry> {
- * constructor() { super("presence"); }
- * }
- * ```
- */
-import type { IRealtimeRepository, PagedResult, SieveQuery, WhereOp } from "../../contracts";
-import type { DocumentData } from "firebase-admin/firestore";
-export declare abstract class FirebaseRealtimeRepository<T extends DocumentData> implements IRealtimeRepository<T> {
-    protected readonly path: string;
-    constructor(rtdbPath: string);
-    protected get rtdb(): import("firebase-admin/database").Database;
-    protected nodeRef(id?: string): import("@firebase/database-types").Reference;
-    findById(id: string): Promise<T | null>;
-    findAll(query?: SieveQuery): Promise<PagedResult<T>>;
-    findWhere(field: keyof T, _op: WhereOp, value: unknown): Promise<T[]>;
-    create(data: Omit<T, "id" | "createdAt" | "updatedAt">): Promise<T>;
-    update(id: string, data: Partial<T>): Promise<T>;
-    delete(id: string): Promise<void>;
-    batchCreate(items: Array<Omit<T, "id" | "createdAt" | "updatedAt">>): Promise<T[]>;
-    batchDelete(ids: string[]): Promise<void>;
-    /**
-     * Subscribe to a single RTDB node.
-     * Returns an unsubscribe function.
-     *
-     * NOTE: The Admin SDK `onValue` callback runs in-process but is not browser-side.
-     * For browser real-time, use the client SDK directly.
-     */
-    subscribe(id: string, cb: (data: T | null) => void): () => void;
-    subscribeWhere(field: keyof T, value: unknown, cb: (items: T[]) => void): () => void;
-}

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

@@ -1,138 +0,0 @@
-/**
- * FirebaseRealtimeRepository<T>
- *
- * Abstract base implementing `IRealtimeRepository<T>` from `@mohasinac/contracts`
- * against Firebase Realtime Database (Admin SDK).
- *
- * Realtime DB does not support Firestore-style queries; `findAll()` loads the
- * entire collection node.  Use this only for small, high-churn datasets (e.g.
- * presence, chat, live-bid prices).
- *
- * Usage:
- * ```ts
- * class PresenceRepository extends FirebaseRealtimeRepository<PresenceEntry> {
- * constructor() { super("presence"); }
- * }
- * ```
- */
-import { getAdminRealtimeDb } from "./admin";
-export class FirebaseRealtimeRepository {
-    constructor(rtdbPath) {
-        this.path = rtdbPath;
-    }
-    get rtdb() {
-        return getAdminRealtimeDb();
-    }
-    nodeRef(id) {
-        return id ? this.rtdb.ref(`${this.path}/${id}`) : this.rtdb.ref(this.path);
-    }
-    // -- IReadRepository --------------------------------------------------------
-    async findById(id) {
-        const snap = await this.nodeRef(id).get();
-        if (!snap.exists())
-            return null;
-        return { id, ...snap.val() };
-    }
-    async findAll(query) {
-        const snap = await this.nodeRef().get();
-        if (!snap.exists()) {
-            return {
-                data: [],
-                total: 0,
-                page: 1,
-                perPage: query?.perPage ?? 20,
-                totalPages: 0,
-            };
-        }
-        const raw = snap.val();
-        let data = Object.entries(raw).map(([id, val]) => ({ id, ...val }));
-        // Basic server-side sort (RTDB has no native multi-field sort)
-        if (query?.sort) {
-            const key = query.sort;
-            const dir = query.order === "desc" ? -1 : 1;
-            data = data.slice().sort((a, b) => {
-                const av = a[key];
-                const bv = b[key];
-                if (av === bv)
-                    return 0;
-                return (av < bv ? -1 : 1) * dir;
-            });
-        }
-        const total = data.length;
-        const perPage = Math.max(1, query?.perPage ?? 20);
-        const page = Math.max(1, query?.page ?? 1);
-        const offset = (page - 1) * perPage;
-        const totalPages = total === 0 ? 0 : Math.max(1, Math.ceil(total / perPage));
-        return {
-            data: data.slice(offset, offset + perPage),
-            total,
-            page,
-            perPage,
-            totalPages,
-        };
-    }
-    async findWhere(field, _op, value) {
-        // RTDB Admin SDK supports orderByChild + equalTo for == only
-        const snap = await this.nodeRef()
-            .orderByChild(field)
-            .equalTo(value)
-            .get();
-        if (!snap.exists())
-            return [];
-        const raw = snap.val();
-        return Object.entries(raw).map(([id, val]) => ({ id, ...val }));
-    }
-    // -- IWriteRepository -------------------------------------------------------
-    async create(data) {
-        const now = Date.now();
-        const payload = { ...data, createdAt: now, updatedAt: now };
-        const ref = await this.nodeRef().push(payload);
-        return { id: ref.key, ...payload };
-    }
-    async update(id, data) {
-        const payload = { ...data, updatedAt: Date.now() };
-        await this.nodeRef(id).update(payload);
-        const snap = await this.nodeRef(id).get();
-        return { id, ...snap.val() };
-    }
-    async delete(id) {
-        await this.nodeRef(id).remove();
-    }
-    async batchCreate(items) {
-        return Promise.all(items.map((item) => this.create(item)));
-    }
-    async batchDelete(ids) {
-        await Promise.all(ids.map((id) => this.delete(id)));
-    }
-    // -- IRealtimeRepository ---------------------------------------------------
-    /**
-     * Subscribe to a single RTDB node.
-     * Returns an unsubscribe function.
-     *
-     * NOTE: The Admin SDK `onValue` callback runs in-process but is not browser-side.
-     * For browser real-time, use the client SDK directly.
-     */
-    subscribe(id, cb) {
-        const ref = this.nodeRef(id);
-        const handler = (snap) => {
-            cb(snap.exists() ? { id, ...snap.val() } : null);
-        };
-        ref.on("value", handler);
-        return () => ref.off("value", handler);
-    }
-    subscribeWhere(field, value, cb) {
-        const ref = this.nodeRef()
-            .orderByChild(field)
-            .equalTo(value);
-        const handler = (snap) => {
-            if (!snap.exists()) {
-                cb([]);
-                return;
-            }
-            const raw = snap.val();
-            cb(Object.entries(raw).map(([id, v]) => ({ id, ...v })));
-        };
-        ref.on("value", handler);
-        return () => ref.off("value", handler);
-    }
-}