@mohasinac/appkit 2.1.1 → 2.2.0

package/dist/core/site-config.js

@@ -0,0 +1,74 @@
+import { ROUTES } from "../next/routing/route-map";
+export const SITE_CONFIG = {
+    brand: {
+        name: "App",
+        shortName: "APP",
+        logoUrl: "/logo.png",
+        logoAlt: "Application Logo",
+        tagline: "Built with AppKit",
+    },
+    nav: {
+        home: ROUTES.HOME,
+        products: ROUTES.PUBLIC.PRODUCTS,
+        auctions: ROUTES.PUBLIC.AUCTIONS,
+        preOrders: ROUTES.PUBLIC.PRE_ORDERS,
+        sellers: ROUTES.PUBLIC.SELLERS,
+        stores: ROUTES.PUBLIC.STORES,
+        events: ROUTES.PUBLIC.EVENTS,
+        blog: ROUTES.PUBLIC.BLOG,
+        categories: ROUTES.PUBLIC.CATEGORIES,
+        promotions: ROUTES.PUBLIC.PROMOTIONS,
+        reviews: ROUTES.PUBLIC.REVIEWS,
+        about: ROUTES.PUBLIC.ABOUT,
+        contact: ROUTES.PUBLIC.CONTACT,
+    },
+    social: {
+        facebook: "https://facebook.com",
+        twitter: "https://twitter.com",
+        instagram: "https://instagram.com",
+        linkedin: "https://linkedin.com",
+    },
+    account: {
+        profile: ROUTES.USER.PROFILE,
+        settings: ROUTES.USER.SETTINGS,
+        orders: ROUTES.USER.ORDERS,
+        wishlist: ROUTES.USER.WISHLIST,
+        addresses: ROUTES.USER.ADDRESSES,
+        cart: ROUTES.USER.CART,
+        login: ROUTES.AUTH.LOGIN,
+        register: ROUTES.AUTH.REGISTER,
+        forgotPassword: ROUTES.AUTH.FORGOT_PASSWORD,
+        verifyEmail: ROUTES.AUTH.VERIFY_EMAIL,
+    },
+    contact: {
+        email: "hello@example.com",
+        phone: "+1 000 000 0000",
+        address: "Remote",
+    },
+    seo: {
+        title: "App - Powered by AppKit",
+        description: "A configurable SSR application foundation.",
+        keywords: "ssr, appkit, webapp",
+    },
+};
+export const FEATURE_FLAGS = {
+    CHAT_ENABLED: false,
+};
+export function createSiteConfig(overrides) {
+    return {
+        ...SITE_CONFIG,
+        ...overrides,
+        brand: { ...SITE_CONFIG.brand, ...overrides.brand },
+        nav: { ...SITE_CONFIG.nav, ...overrides.nav },
+        social: { ...SITE_CONFIG.social, ...overrides.social },
+        account: { ...SITE_CONFIG.account, ...overrides.account },
+        contact: { ...SITE_CONFIG.contact, ...overrides.contact },
+        seo: { ...SITE_CONFIG.seo, ...overrides.seo },
+    };
+}
+export async function resolveSiteConfig(resolver) {
+    if (!resolver)
+        return SITE_CONFIG;
+    const dynamicConfig = await resolver();
+    return createSiteConfig(dynamicConfig);
+}

package/dist/core/unit-of-work.d.ts

@@ -0,0 +1,32 @@
+import "server-only";
+import type { Transaction, WriteBatch } from "firebase-admin/firestore";
+export declare class UnitOfWork {
+    private get db();
+    get users(): import("../repositories").UserRepository;
+    get addresses(): import("../repositories").AddressRepository;
+    get tokens(): {
+        email: import("../repositories").EmailVerificationTokenRepository;
+        password: import("../repositories").PasswordResetTokenRepository;
+        getExpiredEmailVerificationRefs(now: Date): Promise<FirebaseFirestore.DocumentReference[]>;
+        getExpiredPasswordResetRefs(now: Date): Promise<FirebaseFirestore.DocumentReference[]>;
+    };
+    get products(): import("../repositories").ProductRepository;
+    get orders(): import("../repositories").OrderRepository;
+    get reviews(): import("../repositories").ReviewRepository;
+    get sessions(): import("../repositories").SessionRepository;
+    get bids(): import("../features/auctions/repository/bid.repository").BidRepository;
+    get carts(): import("../repositories").CartRepository;
+    get siteSettings(): import("../features/admin/repository/site-settings.repository").SiteSettingsRepository;
+    get carousel(): import("../features/homepage/repository/carousel.repository").CarouselRepository;
+    get homepageSections(): import("../features/homepage/repository/homepage-sections.repository").HomepageSectionsRepository;
+    get categories(): import("../repositories").CategoriesRepository;
+    get coupons(): import("../features/promotions/repository/coupons.repository").CouponsRepository;
+    get faqs(): import("../repositories").FirebaseFAQsRepository;
+    get wishlists(): import("../server").UserWishlistRepository;
+    get blogs(): import("../repositories").BlogRepository;
+    get payouts(): import("../features/payments/repository/payout.repository").PayoutRepository;
+    get notifications(): import("../features/admin/repository/notification.repository").NotificationRepository;
+    runTransaction<TResult>(fn: (tx: Transaction) => Promise<TResult>): Promise<TResult>;
+    runBatch(fn: (batch: WriteBatch) => void | Promise<void>): Promise<void>;
+}
+export declare const unitOfWork: UnitOfWork;

package/dist/core/unit-of-work.js

@@ -0,0 +1,114 @@
+import "server-only";
+// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-require-imports
+const getAdminDb = () => module.require("../providers/db-firebase").getAdminDb();
+import { DatabaseError } from "../errors";
+import { serverLogger } from "../monitoring";
+import { userRepository, tokenRepository, sessionRepository, } from "../features/auth/repository";
+import { addressRepository } from "../features/account/repository/address.repository";
+import { cartRepository } from "../features/cart/repository/cart.repository";
+import { categoriesRepository } from "../features/categories/repository/categories.repository";
+import { productRepository } from "../features/products/repository/products.repository";
+import { orderRepository } from "../features/orders/repository/orders.repository";
+import { reviewRepository } from "../features/reviews/repository/reviews.repository";
+import { bidRepository } from "../features/auctions/repository/bid.repository";
+import { siteSettingsRepository } from "../features/admin/repository/site-settings.repository";
+import { notificationRepository } from "../features/admin/repository/notification.repository";
+import { carouselRepository } from "../features/homepage/repository/carousel.repository";
+import { homepageSectionsRepository } from "../features/homepage/repository/homepage-sections.repository";
+import { couponsRepository } from "../features/promotions/repository/coupons.repository";
+import { faqsRepository } from "../features/faq/repository/faqs.repository";
+import { wishlistRepository } from "../features/wishlist/repository/user-wishlist.repository";
+import { blogRepository } from "../features/blog/repository/blog.repository";
+import { payoutRepository } from "../features/payments/repository/payout.repository";
+export class UnitOfWork {
+    get db() {
+        return getAdminDb();
+    }
+    get users() {
+        return userRepository;
+    }
+    get addresses() {
+        return addressRepository;
+    }
+    get tokens() {
+        return tokenRepository;
+    }
+    get products() {
+        return productRepository;
+    }
+    get orders() {
+        return orderRepository;
+    }
+    get reviews() {
+        return reviewRepository;
+    }
+    get sessions() {
+        return sessionRepository;
+    }
+    get bids() {
+        return bidRepository;
+    }
+    get carts() {
+        return cartRepository;
+    }
+    get siteSettings() {
+        return siteSettingsRepository;
+    }
+    get carousel() {
+        return carouselRepository;
+    }
+    get homepageSections() {
+        return homepageSectionsRepository;
+    }
+    get categories() {
+        return categoriesRepository;
+    }
+    get coupons() {
+        return couponsRepository;
+    }
+    get faqs() {
+        return faqsRepository;
+    }
+    get wishlists() {
+        return wishlistRepository;
+    }
+    get blogs() {
+        return blogRepository;
+    }
+    get payouts() {
+        return payoutRepository;
+    }
+    get notifications() {
+        return notificationRepository;
+    }
+    async runTransaction(fn) {
+        serverLogger.debug("[UnitOfWork] Starting transaction");
+        try {
+            const result = await this.db.runTransaction(fn);
+            serverLogger.debug("[UnitOfWork] Transaction committed successfully");
+            return result;
+        }
+        catch (error) {
+            serverLogger.error("[UnitOfWork] Transaction failed", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new DatabaseError("Transaction failed", error);
+        }
+    }
+    async runBatch(fn) {
+        serverLogger.debug("[UnitOfWork] Starting batch write");
+        try {
+            const batch = this.db.batch();
+            await fn(batch);
+            await batch.commit();
+            serverLogger.debug("[UnitOfWork] Batch write committed successfully");
+        }
+        catch (error) {
+            serverLogger.error("[UnitOfWork] Batch write failed", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new DatabaseError("Batch write failed", error);
+        }
+    }
+}
+export const unitOfWork = new UnitOfWork();

package/dist/errors/api-error.d.ts

@@ -0,0 +1,4 @@
+import { AppError } from "./base-error";
+export declare class ApiError extends AppError {
+    constructor(statusCode: number, message: string, data?: unknown);
+}

package/dist/errors/api-error.js

@@ -0,0 +1,6 @@
+import { AppError } from "./base-error";
+export class ApiError extends AppError {
+    constructor(statusCode, message, data) {
+        super(statusCode, message, "API_ERROR", data);
+    }
+}

package/dist/errors/authentication-error.d.ts

@@ -0,0 +1,4 @@
+import { AppError } from "./base-error";
+export declare class AuthenticationError extends AppError {
+    constructor(message: string, data?: unknown);
+}

package/dist/errors/authentication-error.js

@@ -0,0 +1,6 @@
+import { AppError } from "./base-error";
+export class AuthenticationError extends AppError {
+    constructor(message, data) {
+        super(401, message, "AUTHENTICATION_ERROR", data);
+    }
+}

package/dist/errors/authorization-error.d.ts

@@ -0,0 +1,4 @@
+import { AppError } from "./base-error";
+export declare class AuthorizationError extends AppError {
+    constructor(message: string, data?: unknown);
+}

package/dist/errors/authorization-error.js

@@ -0,0 +1,6 @@
+import { AppError } from "./base-error";
+export class AuthorizationError extends AppError {
+    constructor(message, data) {
+        super(403, message, "AUTHORIZATION_ERROR", data);
+    }
+}

package/dist/errors/base-error.d.ts

@@ -0,0 +1,14 @@
+export declare class AppError extends Error {
+    statusCode: number;
+    message: string;
+    code: string;
+    data?: unknown | undefined;
+    constructor(statusCode: number, message: string, code: string, data?: unknown | undefined);
+    toJSON(): {
+        success: false;
+        error: string;
+        code: string;
+        statusCode: number;
+        data?: unknown;
+    };
+}

package/dist/errors/base-error.js

@@ -0,0 +1,22 @@
+export class AppError extends Error {
+    constructor(statusCode, message, code, data) {
+        super(message);
+        this.statusCode = statusCode;
+        this.message = message;
+        this.code = code;
+        this.data = data;
+        this.name = this.constructor.name;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    toJSON() {
+        return {
+            success: false,
+            error: this.message,
+            code: this.code,
+            statusCode: this.statusCode,
+            ...(this.data !== undefined && { data: this.data }),
+        };
+    }
+}

package/dist/errors/database-error.d.ts

@@ -0,0 +1,4 @@
+import { AppError } from "./base-error";
+export declare class DatabaseError extends AppError {
+    constructor(message: string, data?: unknown);
+}

package/dist/errors/database-error.js

@@ -0,0 +1,6 @@
+import { AppError } from "./base-error";
+export class DatabaseError extends AppError {
+    constructor(message, data) {
+        super(500, message, "DATABASE_ERROR", data);
+    }
+}

package/dist/errors/error-codes.d.ts

@@ -0,0 +1,43 @@
+export declare const ERROR_CODES: {
+    readonly AUTH_INVALID_CREDENTIALS: "AUTH_001";
+    readonly AUTH_TOKEN_EXPIRED: "AUTH_002";
+    readonly AUTH_TOKEN_INVALID: "AUTH_003";
+    readonly AUTH_SESSION_EXPIRED: "AUTH_004";
+    readonly AUTH_EMAIL_NOT_VERIFIED: "AUTH_005";
+    readonly VALIDATION_REQUIRED_FIELD: "VAL_001";
+    readonly VALIDATION_INVALID_INPUT: "VAL_002";
+    readonly VALIDATION_INVALID_EMAIL: "VAL_003";
+    readonly VALIDATION_INVALID_PASSWORD: "VAL_004";
+    readonly VALIDATION_INVALID_PHONE: "VAL_005";
+    readonly USER_NOT_FOUND: "USER_001";
+    readonly USER_ALREADY_EXISTS: "USER_002";
+    readonly USER_NOT_AUTHENTICATED: "USER_003";
+    readonly USER_ACCOUNT_DISABLED: "USER_004";
+    readonly DB_OPERATION_FAILED: "DB_001";
+    readonly DB_NOT_FOUND: "DB_002";
+    readonly DB_DUPLICATE_ENTRY: "DB_003";
+    readonly EMAIL_SEND_FAILED: "EMAIL_001";
+    readonly EMAIL_INVALID_TEMPLATE: "EMAIL_002";
+    readonly EMAIL_RATE_LIMITED: "EMAIL_003";
+    readonly EMAIL_DELIVERY_FAILED: "EMAIL_004";
+    readonly PWD_RESET_TOKEN_EXPIRED: "PWD_001";
+    readonly PWD_RESET_TOKEN_INVALID: "PWD_002";
+    readonly PWD_TOO_WEAK: "PWD_003";
+    readonly PWD_HISTORY_REUSE: "PWD_004";
+    readonly PWD_SAME_AS_CURRENT: "PWD_005";
+    readonly AUTHZ_FORBIDDEN: "AUTHZ_001";
+    readonly AUTHZ_INSUFFICIENT_ROLE: "AUTHZ_002";
+    readonly GEN_BAD_REQUEST: "GEN_001";
+    readonly GEN_NOT_FOUND: "GEN_002";
+    readonly GEN_INTERNAL_ERROR: "GEN_003";
+    readonly GEN_SERVICE_UNAVAILABLE: "GEN_004";
+    readonly GEN_RATE_LIMITED: "GEN_005";
+    readonly GEN_UNKNOWN: "GEN_999";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+/**
+ * ERROR_MESSAGES_BY_CODE - Flat mapping from error codes to locale-neutral technical messages.
+ * For user-facing error messages with category/context, use ERROR_MESSAGES from @mohasinac/appkit/errors which exports from messages.ts.
+ * @deprecated Prefer the categorized ERROR_MESSAGES from messages.ts instead.
+ */
+export declare const ERROR_MESSAGES_BY_CODE: Record<ErrorCode, string>;

package/dist/errors/error-codes.js

@@ -0,0 +1,93 @@
+export const ERROR_CODES = {
+    // Authentication
+    AUTH_INVALID_CREDENTIALS: "AUTH_001",
+    AUTH_TOKEN_EXPIRED: "AUTH_002",
+    AUTH_TOKEN_INVALID: "AUTH_003",
+    AUTH_SESSION_EXPIRED: "AUTH_004",
+    AUTH_EMAIL_NOT_VERIFIED: "AUTH_005",
+    // Validation
+    VALIDATION_REQUIRED_FIELD: "VAL_001",
+    VALIDATION_INVALID_INPUT: "VAL_002",
+    VALIDATION_INVALID_EMAIL: "VAL_003",
+    VALIDATION_INVALID_PASSWORD: "VAL_004",
+    VALIDATION_INVALID_PHONE: "VAL_005",
+    // User
+    USER_NOT_FOUND: "USER_001",
+    USER_ALREADY_EXISTS: "USER_002",
+    USER_NOT_AUTHENTICATED: "USER_003",
+    USER_ACCOUNT_DISABLED: "USER_004",
+    // Database
+    DB_OPERATION_FAILED: "DB_001",
+    DB_NOT_FOUND: "DB_002",
+    DB_DUPLICATE_ENTRY: "DB_003",
+    // Email
+    EMAIL_SEND_FAILED: "EMAIL_001",
+    EMAIL_INVALID_TEMPLATE: "EMAIL_002",
+    EMAIL_RATE_LIMITED: "EMAIL_003",
+    EMAIL_DELIVERY_FAILED: "EMAIL_004",
+    // Password
+    PWD_RESET_TOKEN_EXPIRED: "PWD_001",
+    PWD_RESET_TOKEN_INVALID: "PWD_002",
+    PWD_TOO_WEAK: "PWD_003",
+    PWD_HISTORY_REUSE: "PWD_004",
+    PWD_SAME_AS_CURRENT: "PWD_005",
+    // Authorization
+    AUTHZ_FORBIDDEN: "AUTHZ_001",
+    AUTHZ_INSUFFICIENT_ROLE: "AUTHZ_002",
+    // General
+    GEN_BAD_REQUEST: "GEN_001",
+    GEN_NOT_FOUND: "GEN_002",
+    GEN_INTERNAL_ERROR: "GEN_003",
+    GEN_SERVICE_UNAVAILABLE: "GEN_004",
+    GEN_RATE_LIMITED: "GEN_005",
+    GEN_UNKNOWN: "GEN_999",
+};
+/**
+ * ERROR_MESSAGES_BY_CODE - Flat mapping from error codes to locale-neutral technical messages.
+ * For user-facing error messages with category/context, use ERROR_MESSAGES from @mohasinac/appkit/errors which exports from messages.ts.
+ * @deprecated Prefer the categorized ERROR_MESSAGES from messages.ts instead.
+ */
+export const ERROR_MESSAGES_BY_CODE = {
+    // Authentication
+    AUTH_001: "Invalid email or password",
+    AUTH_002: "Your session has expired. Please log in again",
+    AUTH_003: "Invalid authentication token",
+    AUTH_004: "Your session has expired. Please log in again",
+    AUTH_005: "Please verify your email address before logging in",
+    // Validation
+    VAL_001: "This field is required",
+    VAL_002: "Invalid input provided",
+    VAL_003: "Please enter a valid email address",
+    VAL_004: "Password must be at least 12 characters with uppercase, lowercase, number and special character",
+    VAL_005: "Please enter a valid phone number",
+    // User
+    USER_001: "User not found",
+    USER_002: "An account with this email already exists",
+    USER_003: "Please log in to continue",
+    USER_004: "Your account has been disabled. Please contact support",
+    // Database
+    DB_001: "A database error occurred. Please try again",
+    DB_002: "The requested resource was not found",
+    DB_003: "This record already exists",
+    // Email
+    EMAIL_001: "Failed to send email. Please try again",
+    EMAIL_002: "Invalid email template",
+    EMAIL_003: "Too many emails sent. Please wait before trying again",
+    EMAIL_004: "Email delivery failed. Please check the address and try again",
+    // Password
+    PWD_001: "Password reset link has expired. Please request a new one",
+    PWD_002: "Invalid password reset link",
+    PWD_003: "Password does not meet security requirements",
+    PWD_004: "Cannot reuse a recent password",
+    PWD_005: "New password must be different from your current password",
+    // Authorization
+    AUTHZ_001: "You do not have permission to perform this action",
+    AUTHZ_002: "Insufficient role to perform this action",
+    // General
+    GEN_001: "Bad request",
+    GEN_002: "The requested resource was not found",
+    GEN_003: "An internal server error occurred",
+    GEN_004: "Service temporarily unavailable",
+    GEN_005: "Too many requests. Please slow down",
+    GEN_999: "An unknown error occurred",
+};

package/dist/errors/error-handler.d.ts

@@ -0,0 +1,16 @@
+import { NextResponse } from "next/server.js";
+import { AppError } from "./base-error";
+/**
+ * Handle API errors with consistent response format.
+ * Use in Next.js API route catch blocks.
+ */
+export declare function handleApiError(error: unknown): NextResponse;
+/**
+ * Log an error with optional context. Wraps console.error for package portability;
+ * replace with your structured logger if needed.
+ */
+export declare function logError(error: unknown, context?: Record<string, unknown>): void;
+/**
+ * Type guard — check if a value is an AppError instance.
+ */
+export declare function isAppError(error: unknown): error is AppError;

package/dist/errors/error-handler.js

@@ -0,0 +1,57 @@
+import { NextResponse } from "next/server.js";
+import { AppError } from "./base-error";
+import { ERROR_CODES, ERROR_MESSAGES_BY_CODE } from "./error-codes";
+/**
+ * Handle API errors with consistent response format.
+ * Use in Next.js API route catch blocks.
+ */
+export function handleApiError(error) {
+    if (error instanceof AppError) {
+        if (error.statusCode >= 500) {
+            console.error("[API Error]", {
+                code: error.code,
+                message: error.message,
+                statusCode: error.statusCode,
+                data: error.data,
+            });
+        }
+        return NextResponse.json(error.toJSON(), { status: error.statusCode });
+    }
+    // Zod / schema validation errors
+    if (error && typeof error === "object" && "issues" in error) {
+        return NextResponse.json({
+            success: false,
+            error: "Validation failed",
+            code: ERROR_CODES.VALIDATION_INVALID_INPUT,
+            data: error,
+        }, { status: 400 });
+    }
+    console.error("[Unexpected API Error]", {
+        error: error instanceof Error
+            ? { name: error.name, message: error.message, stack: error.stack }
+            : error,
+    });
+    return NextResponse.json({
+        success: false,
+        error: ERROR_MESSAGES_BY_CODE[ERROR_CODES.GEN_INTERNAL_ERROR],
+        code: ERROR_CODES.GEN_INTERNAL_ERROR,
+    }, { status: 500 });
+}
+/**
+ * Log an error with optional context. Wraps console.error for package portability;
+ * replace with your structured logger if needed.
+ */
+export function logError(error, context) {
+    console.error("[Application Error]", {
+        ...(context && { context }),
+        error: error instanceof Error
+            ? { name: error.name, message: error.message, stack: error.stack }
+            : error,
+    });
+}
+/**
+ * Type guard — check if a value is an AppError instance.
+ */
+export function isAppError(error) {
+    return error instanceof AppError;
+}

package/dist/errors/index.d.ts

@@ -1,96 +1,11 @@
-import { NextResponse } from 'next/server.js';
-
-declare class AppError extends Error {
-    statusCode: number;
-    message: string;
-    code: string;
-    data?: unknown | undefined;
-    constructor(statusCode: number, message: string, code: string, data?: unknown | undefined);
-    toJSON(): {
-        success: false;
-        error: string;
-        code: string;
-        statusCode: number;
-        data?: unknown;
-    };
-}
-
-declare const ERROR_CODES: {
-    readonly AUTH_INVALID_CREDENTIALS: "AUTH_001";
-    readonly AUTH_TOKEN_EXPIRED: "AUTH_002";
-    readonly AUTH_TOKEN_INVALID: "AUTH_003";
-    readonly AUTH_SESSION_EXPIRED: "AUTH_004";
-    readonly AUTH_EMAIL_NOT_VERIFIED: "AUTH_005";
-    readonly VALIDATION_REQUIRED_FIELD: "VAL_001";
-    readonly VALIDATION_INVALID_INPUT: "VAL_002";
-    readonly VALIDATION_INVALID_EMAIL: "VAL_003";
-    readonly VALIDATION_INVALID_PASSWORD: "VAL_004";
-    readonly VALIDATION_INVALID_PHONE: "VAL_005";
-    readonly USER_NOT_FOUND: "USER_001";
-    readonly USER_ALREADY_EXISTS: "USER_002";
-    readonly USER_NOT_AUTHENTICATED: "USER_003";
-    readonly USER_ACCOUNT_DISABLED: "USER_004";
-    readonly DB_OPERATION_FAILED: "DB_001";
-    readonly DB_NOT_FOUND: "DB_002";
-    readonly DB_DUPLICATE_ENTRY: "DB_003";
-    readonly EMAIL_SEND_FAILED: "EMAIL_001";
-    readonly EMAIL_INVALID_TEMPLATE: "EMAIL_002";
-    readonly EMAIL_RATE_LIMITED: "EMAIL_003";
-    readonly EMAIL_DELIVERY_FAILED: "EMAIL_004";
-    readonly PWD_RESET_TOKEN_EXPIRED: "PWD_001";
-    readonly PWD_RESET_TOKEN_INVALID: "PWD_002";
-    readonly PWD_TOO_WEAK: "PWD_003";
-    readonly PWD_HISTORY_REUSE: "PWD_004";
-    readonly PWD_SAME_AS_CURRENT: "PWD_005";
-    readonly AUTHZ_FORBIDDEN: "AUTHZ_001";
-    readonly AUTHZ_INSUFFICIENT_ROLE: "AUTHZ_002";
-    readonly GEN_BAD_REQUEST: "GEN_001";
-    readonly GEN_NOT_FOUND: "GEN_002";
-    readonly GEN_INTERNAL_ERROR: "GEN_003";
-    readonly GEN_SERVICE_UNAVAILABLE: "GEN_004";
-    readonly GEN_RATE_LIMITED: "GEN_005";
-    readonly GEN_UNKNOWN: "GEN_999";
-};
-type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
-declare const ERROR_MESSAGES: Record<ErrorCode, string>;
-
-declare class ApiError extends AppError {
-    constructor(statusCode: number, message: string, data?: unknown);
-}
-
-declare class ValidationError extends AppError {
-    constructor(message: string, fields?: unknown);
-}
-
-declare class AuthenticationError extends AppError {
-    constructor(message: string, data?: unknown);
-}
-
-declare class AuthorizationError extends AppError {
-    constructor(message: string, data?: unknown);
-}
-
-declare class NotFoundError extends AppError {
-    constructor(message: string, data?: unknown);
-}
-
-declare class DatabaseError extends AppError {
-    constructor(message: string, data?: unknown);
-}
-
-/**
- * Handle API errors with consistent response format.
- * Use in Next.js API route catch blocks.
- */
-declare function handleApiError(error: unknown): NextResponse;
-/**
- * Log an error with optional context. Wraps console.error for package portability;
- * replace with your structured logger if needed.
- */
-declare function logError(error: unknown, context?: Record<string, unknown>): void;
-/**
- * Type guard — check if a value is an AppError instance.
- */
-declare function isAppError(error: unknown): error is AppError;
-
-export { ApiError, AppError, AuthenticationError, AuthorizationError, DatabaseError, ERROR_CODES, ERROR_MESSAGES, type ErrorCode, NotFoundError, ValidationError, handleApiError, isAppError, logError };
+export { AppError } from "./base-error";
+export { ERROR_CODES } from "./error-codes";
+export type { ErrorCode } from "./error-codes";
+export { ERROR_MESSAGES } from "./messages";
+export { ApiError } from "./api-error";
+export { ValidationError } from "./validation-error";
+export { AuthenticationError } from "./authentication-error";
+export { AuthorizationError } from "./authorization-error";
+export { NotFoundError } from "./not-found-error";
+export { DatabaseError } from "./database-error";
+export { handleApiError, logError, isAppError } from "./error-handler";

package/dist/errors/index.js

@@ -1,4 +1,15 @@
-export { ApiError, AppError, AuthenticationError, AuthorizationError, DatabaseError, ERROR_CODES, ERROR_MESSAGES, NotFoundError, ValidationError, handleApiError, isAppError, logError } from '../chunk-IE5L2QHV.js';
-import '../chunk-2NMEKWO5.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+export { AppError } from "./base-error";
+export { ERROR_CODES } from "./error-codes";
+export { ERROR_MESSAGES } from "./messages";
+// Note: appkit/src/errors has two ERROR_MESSAGE patterns:
+// - ERROR_CODES.AUTH_001 → "Invalid email or password" (code-based)
+// - ERROR_MESSAGES.AUTH.INVALID_CREDENTIALS → "..." (category-based, consumer-friendly)
+// Consumers typically use ERROR_MESSAGES for user-facing messages.
+export { ApiError } from "./api-error";
+export { ValidationError } from "./validation-error";
+export { AuthenticationError } from "./authentication-error";
+export { AuthorizationError } from "./authorization-error";
+export { NotFoundError } from "./not-found-error";
+export { DatabaseError } from "./database-error";
+// error-handler uses `next/server` — only import in server/API-route contexts
+export { handleApiError, logError, isAppError } from "./error-handler";