@mohasinac/appkit 2.1.3 → 2.3.0

package/src/core/newsletter.repository.ts

@@ -1,193 +0,0 @@
-import { getProviders } from "../contracts/registry";
-import type { IRepository, PagedResult } from "../contracts/repository";
-import {
-  decryptPiiFields,
-  encryptPiiFields,
-  hmacBlindIndex,
-} from "../security/pii-encrypt";
-
-export const NEWSLETTER_SUBSCRIBER_FIELDS = {
-  EMAIL: "email",
-  EMAIL_INDEX: "emailIndex",
-  STATUS: "status",
-  SOURCE: "source",
-  STATUS_VALUES: {
-    ACTIVE: "active",
-    UNSUBSCRIBED: "unsubscribed",
-  },
-  SOURCE_VALUES: {
-    FOOTER: "footer",
-    HOMEPAGE: "homepage",
-    CHECKOUT: "checkout",
-    POPUP: "popup",
-  },
-} as const;
-
-export interface NewsletterSubscriberDocument {
-  id: string;
-  email: string;
-  emailIndex?: string;
-  status: (typeof NEWSLETTER_SUBSCRIBER_FIELDS.STATUS_VALUES)[keyof typeof NEWSLETTER_SUBSCRIBER_FIELDS.STATUS_VALUES];
-  source?: (typeof NEWSLETTER_SUBSCRIBER_FIELDS.SOURCE_VALUES)[keyof typeof NEWSLETTER_SUBSCRIBER_FIELDS.SOURCE_VALUES];
-  ipAddress?: string;
-  subscribedAt?: Date;
-  unsubscribedAt?: Date | null;
-  resubscribedAt?: Date;
-  adminNote?: string;
-  createdAt: Date;
-  updatedAt?: Date;
-}
-
-export type NewsletterSubscriberCreateInput = Pick<
-  NewsletterSubscriberDocument,
-  "email" | "source" | "ipAddress"
->;
-
-export type NewsletterSubscriberUpdateInput = Partial<
-  Pick<NewsletterSubscriberDocument, "status" | "source" | "adminNote">
->;
-
-export interface NewsletterListModel {
-  filters?: string;
-  sorts?: string;
-  page?: string;
-  pageSize?: string;
-}
-
-const NEWSLETTER_PII_FIELDS = ["email", "ipAddress"];
-
-function resolveRepository(): IRepository<NewsletterSubscriberDocument> {
-  const provider = getProviders().db;
-  if (!provider) {
-    throw new Error(
-      "DB provider is not registered. Configure providers before using NewsletterRepository.",
-    );
-  }
-  return provider.getRepository<NewsletterSubscriberDocument>(
-    "newsletterSubscribers",
-  );
-}
-
-function decryptNewsletterDoc(
-  doc: NewsletterSubscriberDocument,
-): NewsletterSubscriberDocument {
-  return decryptPiiFields(
-    doc as unknown as Record<string, unknown>,
-    NEWSLETTER_PII_FIELDS,
-  ) as unknown as NewsletterSubscriberDocument;
-}
-
-export class NewsletterRepository {
-  private _repo: IRepository<NewsletterSubscriberDocument> | null;
-
-  constructor(repo: IRepository<NewsletterSubscriberDocument> | null = null) {
-    this._repo = repo;
-  }
-
-  private get repo(): IRepository<NewsletterSubscriberDocument> {
-    if (!this._repo) {
-      this._repo = resolveRepository();
-    }
-    return this._repo;
-  }
-
-  async list(
-    model: NewsletterListModel,
-  ): Promise<PagedResult<NewsletterSubscriberDocument>> {
-    const page = Number(model.page || "1");
-    const perPage = Number(model.pageSize || "50");
-
-    const result = await this.repo.findAll({
-      filters: model.filters,
-      sort: model.sorts || "-createdAt",
-      page: Number.isFinite(page) ? page : 1,
-      perPage: Number.isFinite(perPage) ? perPage : 50,
-    });
-
-    return {
-      ...result,
-      data: result.data.map(decryptNewsletterDoc),
-    };
-  }
-
-  async findById(id: string): Promise<NewsletterSubscriberDocument | null> {
-    const doc = await this.repo.findById(id);
-    return doc ? decryptNewsletterDoc(doc) : null;
-  }
-
-  async findByEmail(
-    email: string,
-  ): Promise<NewsletterSubscriberDocument | null> {
-    const normalized = email.toLowerCase();
-
-    const byIndex = await this.repo.findWhere(
-      "emailIndex",
-      "==",
-      hmacBlindIndex(normalized),
-    );
-    if (byIndex[0]) return decryptNewsletterDoc(byIndex[0]);
-
-    const byPlain = await this.repo.findWhere("email", "==", normalized);
-    if (byPlain[0]) return decryptNewsletterDoc(byPlain[0]);
-
-    return null;
-  }
-
-  async subscribe(
-    input: NewsletterSubscriberCreateInput,
-  ): Promise<NewsletterSubscriberDocument> {
-    const now = new Date();
-    const plaintext: Omit<
-      NewsletterSubscriberDocument,
-      "id" | "createdAt" | "updatedAt"
-    > = {
-      email: input.email.toLowerCase(),
-      status: NEWSLETTER_SUBSCRIBER_FIELDS.STATUS_VALUES.ACTIVE,
-      source: input.source,
-      ipAddress: input.ipAddress,
-      subscribedAt: now,
-      unsubscribedAt: null,
-      resubscribedAt: undefined,
-      adminNote: undefined,
-      emailIndex: hmacBlindIndex(input.email.toLowerCase()),
-    };
-
-    const encrypted = encryptPiiFields(
-      plaintext as Record<string, unknown>,
-      NEWSLETTER_PII_FIELDS,
-    ) as Omit<NewsletterSubscriberDocument, "id" | "createdAt" | "updatedAt">;
-
-    const created = await this.repo.create(encrypted);
-    return decryptNewsletterDoc(created);
-  }
-
-  async unsubscribe(id: string): Promise<void> {
-    await this.repo.update(id, {
-      status: NEWSLETTER_SUBSCRIBER_FIELDS.STATUS_VALUES.UNSUBSCRIBED,
-      unsubscribedAt: new Date(),
-    });
-  }
-
-  async resubscribe(id: string): Promise<NewsletterSubscriberDocument> {
-    const updated = await this.repo.update(id, {
-      status: NEWSLETTER_SUBSCRIBER_FIELDS.STATUS_VALUES.ACTIVE,
-      resubscribedAt: new Date(),
-      unsubscribedAt: null,
-    });
-    return decryptNewsletterDoc(updated);
-  }
-
-  async updateSubscriber(
-    id: string,
-    input: NewsletterSubscriberUpdateInput,
-  ): Promise<NewsletterSubscriberDocument> {
-    const updated = await this.repo.update(id, input);
-    return decryptNewsletterDoc(updated);
-  }
-
-  async deleteById(id: string): Promise<void> {
-    await this.repo.delete(id);
-  }
-}
-
-export const newsletterRepository = new NewsletterRepository();

package/src/core/site-config.ts

@@ -1,109 +0,0 @@
-import { ROUTES } from "../next/routing/route-map";
-
-export interface RuntimeSiteConfig {
-  brand: {
-    name: string;
-    shortName: string;
-    logoUrl: string;
-    logoAlt: string;
-    tagline: string;
-  };
-  nav: Record<string, string>;
-  social: {
-    facebook: string;
-    twitter: string;
-    instagram: string;
-    linkedin: string;
-  };
-  account: Record<string, string>;
-  contact: {
-    email: string;
-    phone: string;
-    address: string;
-  };
-  seo: {
-    title: string;
-    description: string;
-    keywords: string;
-  };
-}
-
-export const SITE_CONFIG: RuntimeSiteConfig = {
-  brand: {
-    name: "App",
-    shortName: "APP",
-    logoUrl: "/logo.png",
-    logoAlt: "Application Logo",
-    tagline: "Built with AppKit",
-  },
-  nav: {
-    home: ROUTES.HOME,
-    products: ROUTES.PUBLIC.PRODUCTS as string,
-    auctions: ROUTES.PUBLIC.AUCTIONS as string,
-    preOrders: ROUTES.PUBLIC.PRE_ORDERS as string,
-    sellers: ROUTES.PUBLIC.SELLERS as string,
-    stores: ROUTES.PUBLIC.STORES as string,
-    events: ROUTES.PUBLIC.EVENTS as string,
-    blog: ROUTES.PUBLIC.BLOG as string,
-    categories: ROUTES.PUBLIC.CATEGORIES as string,
-    promotions: ROUTES.PUBLIC.PROMOTIONS as string,
-    reviews: ROUTES.PUBLIC.REVIEWS as string,
-    about: ROUTES.PUBLIC.ABOUT as string,
-    contact: ROUTES.PUBLIC.CONTACT as string,
-  },
-  social: {
-    facebook: "https://facebook.com",
-    twitter: "https://twitter.com",
-    instagram: "https://instagram.com",
-    linkedin: "https://linkedin.com",
-  },
-  account: {
-    profile: ROUTES.USER.PROFILE as string,
-    settings: ROUTES.USER.SETTINGS as string,
-    orders: ROUTES.USER.ORDERS as string,
-    wishlist: ROUTES.USER.WISHLIST as string,
-    addresses: ROUTES.USER.ADDRESSES as string,
-    cart: ROUTES.USER.CART as string,
-    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,
-} as const;
-
-export function createSiteConfig(
-  overrides: Partial<RuntimeSiteConfig>,
-): RuntimeSiteConfig {
-  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?: () => Promise<Partial<RuntimeSiteConfig>>,
-): Promise<RuntimeSiteConfig> {
-  if (!resolver) return SITE_CONFIG;
-  const dynamicConfig = await resolver();
-  return createSiteConfig(dynamicConfig);
-}

package/src/errors/api-error.ts

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

package/src/errors/authentication-error.ts

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

package/src/errors/authorization-error.ts

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

package/src/errors/base-error.ts

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

package/src/errors/database-error.ts

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

package/src/errors/error-codes.ts

@@ -1,106 +0,0 @@
-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",
-} as const;
-
-export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
-
-export const ERROR_MESSAGES: Record<ErrorCode, string> = {
-  // 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/src/errors/error-handler.ts

@@ -1,74 +0,0 @@
-import { NextResponse } from "next/server.js";
-import { AppError } from "./base-error";
-import { ERROR_CODES, ERROR_MESSAGES } from "./error-codes";
-
-/**
- * Handle API errors with consistent response format.
- * Use in Next.js API route catch blocks.
- */
-export function handleApiError(error: unknown): NextResponse {
-  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[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: unknown,
-  context?: Record<string, unknown>,
-): void {
-  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: unknown): error is AppError {
-  return error instanceof AppError;
-}

package/src/errors/index.ts

@@ -1,11 +0,0 @@
-export { AppError } from "./base-error";
-export { ERROR_CODES, ERROR_MESSAGES } from "./error-codes";
-export type { ErrorCode } from "./error-codes";
-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";

package/src/errors/not-found-error.ts

@@ -1,7 +0,0 @@
-import { AppError } from "./base-error";
-
-export class NotFoundError extends AppError {
-  constructor(message: string, data?: unknown) {
-    super(404, message, "NOT_FOUND", data);
-  }
-}

package/src/errors/validation-error.ts

@@ -1,7 +0,0 @@
-import { AppError } from "./base-error";
-
-export class ValidationError extends AppError {
-  constructor(message: string, fields?: unknown) {
-    super(400, message, "VALIDATION_ERROR", fields);
-  }
-}