@mohasinac/appkit 2.1.3 → 2.3.0

package/src/features/events/manifest.ts

@@ -1,26 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-
-export const manifest: FeatureManifest = {
-  name: "events",
-  i18nNamespace: "events",
-  envKeys: [],
-  routes: [
-    { segment: "[locale]/events", exports: { default: "EventsListView" } },
-    {
-      segment: "[locale]/events/[id]",
-      exports: { default: "EventDetailView" },
-    },
-    {
-      segment: "[locale]/events/[id]/participate",
-      exports: { default: "EventParticipateView" },
-    },
-  ],
-  apiRoutes: [
-    { segment: "api/events", methods: ["GET"] },
-    { segment: "api/events/[id]", methods: ["GET"] },
-    { segment: "api/events/[id]/entries", methods: ["GET", "POST"] },
-    { segment: "api/admin/events", methods: ["GET", "POST"] },
-    { segment: "api/admin/events/[id]", methods: ["GET", "PATCH", "DELETE"] },
-    { segment: "api/admin/events/[id]/entries", methods: ["GET", "PATCH"] },
-  ],
-};

package/src/features/events/messages/en.json

@@ -1,28 +0,0 @@
-{
-  "eventStatus": {
-    "draft": "Draft",
-    "active": "Active",
-    "paused": "Paused",
-    "ended": "Ended"
-  },
-  "eventType": {
-    "sale": "Sale",
-    "offer": "Offer",
-    "poll": "Poll",
-    "survey": "Survey",
-    "feedback": "Feedback"
-  },
-  "card": {
-    "participate": "Participate",
-    "viewResults": "View Results",
-    "entries": "entries",
-    "daysRemaining": "{count}d remaining"
-  },
-  "leaderboard": {
-    "title": "Leaderboard",
-    "rank": "Rank",
-    "participant": "Participant",
-    "points": "Points"
-  },
-  "empty": "No events available right now."
-}

package/src/features/events/repository/events.repository.ts

@@ -1,110 +0,0 @@
-import type {
-  IRepository,
-  PagedResult,
-  SieveQuery,
-} from "../../../contracts";
-import type { EventItem, EventEntryItem } from "../types";
-
-export class EventsRepository {
-  constructor(private readonly repo: IRepository<EventItem>) {}
-
-  async findAll(query?: SieveQuery): Promise<PagedResult<EventItem>> {
-    return this.repo.findAll(query ?? {});
-  }
-
-  async findById(id: string): Promise<EventItem | null> {
-    return this.repo.findById(id);
-  }
-
-  async findActive(): Promise<EventItem[]> {
-    const result = await this.repo.findAll({
-      filters: "status==active",
-      sort: "startsAt",
-    });
-    return result.data;
-  }
-
-  async findByType(
-    type: string,
-    page = 1,
-    perPage = 20,
-  ): Promise<PagedResult<EventItem>> {
-    return this.repo.findAll({
-      filters: `type==${type},status==active`,
-      sort: "-startsAt",
-      page,
-      perPage,
-    });
-  }
-
-  async create(
-    data: Omit<EventItem, "id" | "createdAt" | "updatedAt">,
-  ): Promise<EventItem> {
-    return this.repo.create(data);
-  }
-
-  async update(id: string, data: Partial<EventItem>): Promise<EventItem> {
-    return this.repo.update(id, data);
-  }
-
-  async delete(id: string): Promise<void> {
-    return this.repo.delete(id);
-  }
-}
-
-export class EventEntriesRepository {
-  constructor(private readonly repo: IRepository<EventEntryItem>) {}
-
-  async findByEvent(
-    eventId: string,
-    page = 1,
-    perPage = 50,
-  ): Promise<PagedResult<EventEntryItem>> {
-    return this.repo.findAll({
-      filters: `eventId==${eventId}`,
-      sort: "-submittedAt",
-      page,
-      perPage,
-    });
-  }
-
-  async findPending(eventId: string): Promise<EventEntryItem[]> {
-    const result = await this.repo.findAll({
-      filters: `eventId==${eventId},reviewStatus==pending`,
-      sort: "submittedAt",
-    });
-    return result.data;
-  }
-
-  async findLeaderboard(
-    eventId: string,
-    limit = 10,
-  ): Promise<EventEntryItem[]> {
-    const result = await this.repo.findAll({
-      filters: `eventId==${eventId},reviewStatus==approved`,
-      sort: "-points",
-      perPage: limit,
-    });
-    return result.data;
-  }
-
-  async create(data: Omit<EventEntryItem, "id">): Promise<EventEntryItem> {
-    return this.repo.create(
-      data as Omit<EventEntryItem, "id" | "createdAt" | "updatedAt">,
-    );
-  }
-
-  async updateReviewStatus(
-    id: string,
-    status: "approved" | "flagged",
-    reviewedBy: string,
-    note?: string,
-  ): Promise<EventEntryItem> {
-    return this.repo.update(id, {
-      reviewStatus: status,
-      reviewedBy,
-      reviewedAt: new Date().toISOString(),
-      reviewNote: note,
-    });
-  }
-}

package/src/features/events/schemas/index.ts

@@ -1,98 +0,0 @@
-import { z } from "zod";
-import { mediaFieldSchema } from "../../media/types/index";
-
-const eventCoverImageSchema = z
-  .union([
-    mediaFieldSchema,
-    z.string().url().transform((url) => ({ url, type: "image" as const })),
-  ])
-  .nullable()
-  .optional()
-  .transform((value) => value ?? null);
-
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
-
-export const eventTypeSchema = z.enum([
-  "sale",
-  "offer",
-  "poll",
-  "survey",
-  "feedback",
-]);
-
-export const eventStatusSchema = z.enum([
-  "draft",
-  "active",
-  "paused",
-  "ended",
-]);
-
-export const saleConfigSchema = z.object({
-  discountPercent: z.number(),
-  bannerText: z.string().optional(),
-  affectedCategories: z.array(z.string()).optional(),
-});
-
-export const offerConfigSchema = z.object({
-  couponId: z.string(),
-  displayCode: z.string(),
-  bannerText: z.string().optional(),
-});
-
-export const pollConfigSchema = z.object({
-  allowMultiSelect: z.boolean(),
-  allowComment: z.boolean(),
-  options: z.array(z.object({ id: z.string(), label: z.string() })),
-  resultsVisibility: z.enum(["always", "after_vote", "after_end"]),
-});
-
-// ─── Base item schema ─────────────────────────────────────────────────────────
-
-/**
- * Base Zod schema for an event item.
- * Apps can extend this to add their own fields:
- *
- * @example
- * import { eventItemSchema } from "@mohasinac/feat-events";
- *
- * const myEventSchema = eventItemSchema.extend({
- *   brandId: z.string().optional(),
- *   rewardPoints: z.number().optional(),
- * });
- * type MyEvent = z.infer<typeof myEventSchema>;
- */
-export const eventItemSchema = z.object({
-  id: z.string(),
-  type: eventTypeSchema,
-  title: z.string(),
-  description: z.string(),
-  status: eventStatusSchema,
-  startsAt: z.string(),
-  endsAt: z.string(),
-  coverImage: eventCoverImageSchema,
-  coverImageUrl: z.string().optional(),
-  eventImages: z.array(mediaFieldSchema).max(10).optional().default([]),
-  winnerImages: z.array(mediaFieldSchema).max(5).optional().default([]),
-  additionalImages: z.array(mediaFieldSchema).max(10).optional().default([]),
-  saleConfig: saleConfigSchema.optional(),
-  offerConfig: offerConfigSchema.optional(),
-  pollConfig: pollConfigSchema.optional(),
-  stats: z.object({
-    totalEntries: z.number(),
-    approvedEntries: z.number(),
-    flaggedEntries: z.number(),
-  }),
-  createdBy: z.string(),
-  createdAt: z.string(),
-  updatedAt: z.string(),
-});
-
-/** Base Zod schema for list-query parameters. */
-export const eventListParamsSchema = z.object({
-  type: eventTypeSchema.optional(),
-  status: eventStatusSchema.optional(),
-  q: z.string().optional(),
-  page: z.coerce.number().optional(),
-  perPage: z.coerce.number().optional(),
-  sort: z.string().optional(),
-});

package/src/features/events/server.ts

@@ -1,8 +0,0 @@
-/**
- * @mohasinac/appkit/features/events/server
- *
- * Server-only entry point — exports only the API route handlers.
- */
-
-export { GET as eventsGET, GET } from "./api/route";
-export { GET as eventIdGET } from "./api/[id]/route";

package/src/features/events/types/index.ts

@@ -1,185 +0,0 @@
-import type { MediaField } from "../../media/types/index";
-
-// ─── Enums / union types ──────────────────────────────────────────────────────
-
-export type EventType = "sale" | "offer" | "poll" | "survey" | "feedback";
-export type EventStatus = "draft" | "active" | "paused" | "ended";
-export type EntryReviewStatus = "pending" | "approved" | "flagged";
-export type PollResultsVisibility = "always" | "after_vote" | "after_end";
-
-export type FormFieldType =
-  | "text"
-  | "textarea"
-  | "email"
-  | "phone"
-  | "number"
-  | "select"
-  | "multiselect"
-  | "checkbox"
-  | "radio"
-  | "date"
-  | "rating"
-  | "file";
-
-// ─── Config sub-types ─────────────────────────────────────────────────────────
-
-export interface SurveyFormField {
-  id: string;
-  type: FormFieldType;
-  label: string;
-  placeholder?: string;
-  required: boolean;
-  options?: string[];
-  validation?: {
-    minLength?: number;
-    maxLength?: number;
-    min?: number;
-    max?: number;
-    pattern?: string;
-  };
-  order: number;
-}
-
-export interface SaleConfig {
-  discountPercent: number;
-  bannerText?: string;
-  affectedCategories?: string[];
-}
-
-export interface OfferConfig {
-  couponId: string;
-  displayCode: string;
-  bannerText?: string;
-}
-
-export interface PollConfig {
-  allowMultiSelect: boolean;
-  allowComment: boolean;
-  options: { id: string; label: string }[];
-  resultsVisibility: PollResultsVisibility;
-}
-
-export interface SurveyConfig {
-  requireLogin: boolean;
-  maxEntriesPerUser: number;
-  hasLeaderboard: boolean;
-  hasPointSystem: boolean;
-  pointsLabel?: string;
-  entryReviewRequired: boolean;
-  formFields: SurveyFormField[];
-}
-
-export interface FeedbackConfig {
-  formFields: SurveyFormField[];
-  anonymous: boolean;
-}
-
-// ─── Documents ────────────────────────────────────────────────────────────────
-
-export interface EventItem {
-  id: string;
-  type: EventType;
-  title: string;
-  description: string;
-  status: EventStatus;
-  startsAt: string;
-  endsAt: string;
-  coverImage?: MediaField | null;
-  coverImageUrl?: string;
-  eventImages?: MediaField[];
-  winnerImages?: MediaField[];
-  additionalImages?: MediaField[];
-  saleConfig?: SaleConfig;
-  offerConfig?: OfferConfig;
-  pollConfig?: PollConfig;
-  surveyConfig?: SurveyConfig;
-  feedbackConfig?: FeedbackConfig;
-  stats: {
-    totalEntries: number;
-    approvedEntries: number;
-    flaggedEntries: number;
-  };
-  createdBy: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface EventEntryItem {
-  id: string;
-  eventId: string;
-  userId?: string;
-  userDisplayName?: string;
-  userEmail?: string;
-  pollVotes?: string[];
-  pollComment?: string;
-  formResponses?: Record<string, unknown>;
-  reviewStatus: EntryReviewStatus;
-  reviewedBy?: string;
-  reviewedAt?: string;
-  reviewNote?: string;
-  points?: number;
-  submittedAt: string;
-}
-
-export interface LeaderboardEntry {
-  rank: number;
-  userId: string;
-  userDisplayName: string;
-  points: number;
-}
-
-// ─── List response ────────────────────────────────────────────────────────────
-
-export interface EventListResponse {
-  items: EventItem[];
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasMore: boolean;
-}
-
-export interface EventEntryListResponse {
-  items: EventEntryItem[];
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasMore: boolean;
-}
-
-// ─── Inputs ───────────────────────────────────────────────────────────────────
-
-export interface CreateEventInput {
-  type: EventType;
-  title: string;
-  description: string;
-  startsAt: string;
-  endsAt: string;
-  coverImage?: MediaField | null;
-  coverImageUrl?: string;
-  eventImages?: MediaField[];
-  winnerImages?: MediaField[];
-  additionalImages?: MediaField[];
-  saleConfig?: SaleConfig;
-  offerConfig?: OfferConfig;
-  pollConfig?: PollConfig;
-  surveyConfig?: SurveyConfig;
-  feedbackConfig?: FeedbackConfig;
-}
-
-export interface CreateEventEntryInput {
-  eventId: string;
-  pollVotes?: string[];
-  pollComment?: string;
-  formResponses?: Record<string, unknown>;
-}
-
-export interface EventListParams {
-  status?: EventStatus;
-  type?: EventType;
-  page?: number;
-  pageSize?: number;
-  sort?: string;
-  filters?: string;
-}

package/src/features/faq/api/route.ts

@@ -1,61 +0,0 @@
-/**
- * feat-faq — Next.js App Router API handler (GET /api/faq)
- *
- * 2-line stub:
- * ```ts
- * // app/api/faq/route.ts
- * export { GET } from "@mohasinac/feat-faq";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../contracts";
-import type { FAQ, FAQListResponse } from "../types/index";
-
-function param(url: URL, key: string): string | null {
-  return url.searchParams.get(key);
-}
-
-export async function GET(request: Request): Promise<NextResponse> {
-  try {
-    const url = new URL(request.url);
-
-    const parts: string[] = ["isActive==true"];
-    const category = param(url, "category");
-    if (category) parts.push(`category==${category}`);
-    const homepage = param(url, "homepage");
-    if (homepage === "true") parts.push("showOnHomepage==true");
-    const q = param(url, "q");
-    if (q) parts.push(`question@=*${q}`);
-    const filters = parts.join(",");
-
-    const { db } = getProviders();
-    if (!db) {
-      return NextResponse.json(
-        { success: false, error: "Database provider not registered" },
-        { status: 503 },
-      );
-    }
-
-    const repo = db.getRepository<FAQ>("faqs");
-    const result = await repo.findAll({
-      filters,
-      sort: "order",
-      order: "asc",
-      perPage: 100,
-    });
-
-    const body: FAQListResponse = {
-      items: result.data,
-      total: result.total,
-    };
-
-    return NextResponse.json({ success: true, data: body });
-  } catch (error) {
-    console.error("[feat-faq] GET /api/faq failed", error);
-    return NextResponse.json(
-      { success: false, error: "Failed to fetch FAQs" },
-      { status: 500 },
-    );
-  }
-}

package/src/features/faq/columns/index.ts

@@ -1,60 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { FAQ } from "../types";
-
-/**
- * Default admin column definitions for a FAQ table.
- *
- * @example
- * const columns = buildFaqColumns<MyFaq>({
- *   extras: [{ key: "videoUrl", header: "Video", render: (f) => f.videoUrl ?? "—" }],
- * });
- */
-export const faqAdminColumns: TableColumn<FAQ>[] = [
-  { key: "question", header: "Question", sortable: true },
-  { key: "category", header: "Category", sortable: true },
-  {
-    key: "isActive",
-    header: "Active",
-    render: (f) => (f.isActive !== false ? "Yes" : "No"),
-  },
-  {
-    key: "isPinned",
-    header: "Pinned",
-    render: (f) => (f.isPinned ? "Yes" : "No"),
-  },
-  {
-    key: "showOnHomepage",
-    header: "Homepage",
-    render: (f) => (f.showOnHomepage ? "Yes" : "No"),
-  },
-  {
-    key: "order",
-    header: "Order",
-    sortable: true,
-    render: (f) => f.order?.toLocaleString() ?? "—",
-  },
-  {
-    key: "views",
-    header: "Views",
-    sortable: true,
-    render: (f) => f.stats?.views?.toLocaleString() ?? "—",
-  },
-  { key: "createdAt", header: "Created", sortable: true },
-];
-
-/**
- * Build a merged column list from the base FAQ columns.
- */
-export function buildFaqColumns<T extends FAQ = FAQ>(
-  opts?: ColumnExtensionOpts<T>,
-): TableColumn<T>[] {
-  const base = faqAdminColumns as TableColumn<T>[];
-  const omit = new Set(opts?.omit ?? []);
-  const cols = base
-    .filter((col) => !omit.has(col.key))
-    .map((col) => {
-      const ovr = opts?.overrides?.[col.key];
-      return ovr ? { ...col, ...ovr } : col;
-    });
-  return opts?.extras ? [...cols, ...opts.extras] : cols;
-}

package/src/features/faq/components/ContactCTA.tsx

@@ -1,115 +0,0 @@
-"use client";
-
-import { Div, Heading, Span, Text, TextLink } from "../../../ui";
-
-interface ContactCTAProps {
-  email: string;
-  phone: string;
-  contactHref: string;
-  labels?: {
-    title?: string;
-    description?: string;
-    emailUs?: string;
-    callUs?: string;
-    contactForm?: string;
-    submitRequest?: string;
-    contactTeam?: string;
-  };
-}
-
-export function ContactCTA({
-  email,
-  phone,
-  contactHref,
-  labels,
-}: ContactCTAProps) {
-  return (
-    <Div className="rounded-xl border border-zinc-200 bg-white p-8 text-center dark:border-slate-700 dark:bg-slate-800/60">
-      <Div className="mb-6 flex justify-center">
-        <Div className="rounded-full bg-primary/10 p-8">
-          <svg
-            className="h-12 w-12 text-primary"
-            fill="none"
-            stroke="currentColor"
-            viewBox="0 0 24 24"
-          >
-            <path
-              strokeLinecap="round"
-              strokeLinejoin="round"
-              strokeWidth={2}
-              d="M3 8l7.89 5.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z"
-            />
-          </svg>
-        </Div>
-      </Div>
-
-      <Heading level={2} className="mb-3 text-2xl font-semibold">
-        {labels?.title ?? "Need More Help?"}
-      </Heading>
-
-      <Text className="mx-auto mb-6 max-w-2xl text-zinc-600 dark:text-zinc-300">
-        {labels?.description ?? "Our support team is here to help you."}
-      </Text>
-
-      <Div className="mb-8 grid grid-cols-1 gap-4 md:grid-cols-3">
-        <TextLink
-          href={`mailto:${email}`}
-          variant="none"
-          className="group rounded-xl bg-zinc-100 p-6 transition-colors hover:bg-zinc-200 dark:bg-slate-700 dark:hover:bg-slate-600"
-        >
-          <Text className="mb-1 text-sm font-medium">
-            {labels?.emailUs ?? "Email Us"}
-          </Text>
-          <Text className="text-xs text-zinc-500 dark:text-zinc-400">
-            {email}
-          </Text>
-        </TextLink>
-
-        <TextLink
-          href={`tel:${phone}`}
-          variant="none"
-          className="group rounded-xl bg-zinc-100 p-6 transition-colors hover:bg-zinc-200 dark:bg-slate-700 dark:hover:bg-slate-600"
-        >
-          <Text className="mb-1 text-sm font-medium">
-            {labels?.callUs ?? "Call Us"}
-          </Text>
-          <Text className="text-xs text-zinc-500 dark:text-zinc-400">
-            {phone}
-          </Text>
-        </TextLink>
-
-        <TextLink
-          href={contactHref}
-          className="group rounded-xl bg-zinc-100 p-6 transition-colors hover:bg-zinc-200 dark:bg-slate-700 dark:hover:bg-slate-600"
-        >
-          <Text className="mb-1 text-sm font-medium">
-            {labels?.contactForm ?? "Contact Form"}
-          </Text>
-          <Text className="text-xs text-zinc-500 dark:text-zinc-400">
-            {labels?.submitRequest ?? "Submit a request"}
-          </Text>
-        </TextLink>
-      </Div>
-
-      <TextLink
-        href={contactHref}
-        className="inline-flex items-center gap-2 rounded-xl bg-primary p-6 font-medium text-white transition-colors hover:bg-primary/90"
-      >
-        <Span>{labels?.contactTeam ?? "Contact Team"}</Span>
-        <svg
-          className="h-5 w-5"
-          fill="none"
-          stroke="currentColor"
-          viewBox="0 0 24 24"
-        >
-          <path
-            strokeLinecap="round"
-            strokeLinejoin="round"
-            strokeWidth={2}
-            d="M9 5l7 7-7 7"
-          />
-        </svg>
-      </TextLink>
-    </Div>
-  );
-}