@mohasinac/appkit 2.1.3 → 2.2.0

package/src/features/categories/hooks/useCategories.ts

@@ -1,72 +0,0 @@
-"use client";
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import type { CategoryItem } from "../types";
-
-interface UseCategoriesListOptions {
-  initialData?: CategoryItem[];
-  enabled?: boolean;
-}
-
-export function useCategoriesList(opts?: UseCategoriesListOptions) {
-  const query = useQuery<CategoryItem[]>({
-    queryKey: ["categories", "flat"],
-    queryFn: () => apiClient.get<CategoryItem[]>("/api/categories?flat=true"),
-    initialData: opts?.initialData,
-    enabled: opts?.enabled,
-    staleTime: 5 * 60 * 1000, // 5 min — categories change infrequently
-  });
-
-  return {
-    categories: query.data ?? [],
-    total: query.data?.length ?? 0,
-    isLoading: query.isLoading,
-    error: query.error,
-  };
-}
-
-interface UseCategoryDetailOptions {
-  initialCategory?: CategoryItem;
-  initialChildren?: CategoryItem[];
-  enabled?: boolean;
-}
-
-export function useCategoryDetail(
-  slug: string,
-  opts?: UseCategoryDetailOptions,
-) {
-  const categoryQuery = useQuery<CategoryItem | null>({
-    queryKey: ["categories", "slug", slug],
-    queryFn: async () => {
-      try {
-        return await apiClient.get<CategoryItem>(
-          `/api/categories?slug=${encodeURIComponent(slug)}`,
-        );
-      } catch {
-        return null;
-      }
-    },
-    initialData: opts?.initialCategory ?? undefined,
-    enabled: opts?.enabled !== false && !!slug,
-  });
-
-  const category = categoryQuery.data ?? null;
-
-  const childrenQuery = useQuery<CategoryItem[]>({
-    queryKey: ["categories", "children", category?.id ?? ""],
-    queryFn: () =>
-      apiClient.get<CategoryItem[]>(
-        `/api/categories?parentId=${encodeURIComponent(category!.id)}`,
-      ),
-    enabled: !!category?.id,
-    initialData: opts?.initialChildren,
-  });
-
-  return {
-    category,
-    children: childrenQuery.data ?? [],
-    isLoading: categoryQuery.isLoading,
-    childrenLoading: childrenQuery.isLoading,
-    error: categoryQuery.error,
-  };
-}

package/src/features/categories/index.ts

@@ -1,7 +0,0 @@
-export * from "./types";
-export * from "./hooks/useCategories";
-export * from "./components";
-export * from "./schemas";
-export * from "./columns";
-export { CategoriesRepository } from "./repository/categories.repository";
-export { manifest } from "./manifest";

package/src/features/categories/manifest.ts

@@ -1,22 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-
-export const manifest: FeatureManifest = {
-  name: "categories",
-  i18nNamespace: "categories",
-  envKeys: [],
-  routes: [
-    { segment: "[locale]/categories", exports: { default: "CategoriesView" } },
-    {
-      segment: "[locale]/categories/[slug]",
-      exports: { default: "CategoryDetailView" },
-    },
-    { segment: "[locale]/concern", exports: { default: "ConcernListPageView" } },
-    { segment: "[locale]/concern/[slug]", exports: { default: "ConcernPageView" } },
-  ],
-  apiRoutes: [
-    { segment: "api/categories", methods: ["GET", "POST"] },
-    { segment: "api/categories/[id]", methods: ["GET", "PATCH", "DELETE"] },
-    { segment: "api/categories/[id]/children", methods: ["GET"] },
-    { segment: "api/categories/flat", methods: ["GET"] },
-  ],
-};

package/src/features/categories/repository/categories.repository.ts

@@ -1,76 +0,0 @@
-import type {
-  IRepository,
-  PagedResult,
-  SieveQuery,
-} from "../../../contracts";
-import type { CategoryItem, CategoryType } from "../types";
-
-export class CategoriesRepository {
-  constructor(private readonly repo: IRepository<CategoryItem>) {}
-
-  async findAll(query?: SieveQuery): Promise<PagedResult<CategoryItem>> {
-    return this.repo.findAll(query ?? {});
-  }
-
-  async findByType(type: CategoryType, perPage = 100): Promise<CategoryItem[]> {
-    const result = await this.repo.findAll({
-      filters: `type==${type}`,
-      perPage,
-    });
-    return result.data;
-  }
-
-  async findConcerns(perPage = 100): Promise<CategoryItem[]> {
-    return this.findByType("concern", perPage);
-  }
-
-  async findBySlug(slug: string): Promise<CategoryItem | null> {
-    const result = await this.repo.findAll({
-      filters: `slug==${slug}`,
-      perPage: 1,
-    });
-    return result.data[0] ?? null;
-  }
-
-  async findChildren(parentId: string): Promise<CategoryItem[]> {
-    const result = await this.repo.findAll({
-      filters: `parentIds@=${parentId}`,
-      perPage: 100,
-    });
-    return result.data;
-  }
-
-  async findFeatured(limit = 12): Promise<CategoryItem[]> {
-    const result = await this.repo.findAll({
-      filters: "isFeatured==true",
-      sort: "featuredPriority",
-      perPage: limit,
-    });
-    return result.data;
-  }
-
-  async findRoots(): Promise<CategoryItem[]> {
-    const result = await this.repo.findAll({
-      filters: "tier==1",
-      sort: "order",
-      perPage: 100,
-    });
-    return result.data;
-  }
-
-  async findById(id: string): Promise<CategoryItem | null> {
-    return this.repo.findById(id);
-  }
-
-  async create(data: Omit<CategoryItem, "id">): Promise<CategoryItem> {
-    return this.repo.create(data);
-  }
-
-  async update(id: string, data: Partial<CategoryItem>): Promise<CategoryItem> {
-    return this.repo.update(id, data);
-  }
-
-  async delete(id: string): Promise<void> {
-    return this.repo.delete(id);
-  }
-}

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

@@ -1,74 +0,0 @@
-import { z } from "zod";
-
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
-
-export const categoryTypeSchema = z.enum([
-  "category",
-  "concern",
-  "collection",
-  "brand",
-]);
-
-export const categorySeoSchema = z.object({
-  title: z.string().optional(),
-  description: z.string().optional(),
-  keywords: z.array(z.string()).optional(),
-  ogImage: z.string().optional(),
-});
-
-export const categoryDisplaySchema = z.object({
-  icon: z.string().optional(),
-  coverImage: z.string().optional(),
-  showInMenu: z.boolean().optional(),
-});
-
-export const categoryMetricsSchema = z.object({
-  productCount: z.number(),
-  totalItemCount: z.number(),
-  lastUpdated: z.string().optional(),
-});
-
-// ─── Base item schema ─────────────────────────────────────────────────────────
-
-/**
- * Base Zod schema for a category item.
- * Apps can extend this to add their own fields:
- *
- * @example
- * import { categoryItemSchema } from "@mohasinac/feat-categories";
- *
- * const mySchema = categoryItemSchema.extend({
- *   colorHex: z.string().optional(),
- * });
- */
-export const categoryItemSchema = z.object({
-  id: z.string(),
-  type: categoryTypeSchema.optional(),
-  name: z.string(),
-  slug: z.string(),
-  description: z.string().optional(),
-  rootId: z.string().optional(),
-  parentIds: z.array(z.string()).optional(),
-  childrenIds: z.array(z.string()).optional(),
-  tier: z.number(),
-  path: z.string().optional(),
-  order: z.number().optional(),
-  isLeaf: z.boolean().optional(),
-  metrics: categoryMetricsSchema.optional(),
-  isFeatured: z.boolean().optional(),
-  featuredPriority: z.number().optional(),
-  seo: categorySeoSchema.optional(),
-  display: categoryDisplaySchema.optional(),
-  createdAt: z.string().optional(),
-  updatedAt: z.string().optional(),
-});
-
-export const categoryListParamsSchema = z.object({
-  type: categoryTypeSchema.optional(),
-  parentId: z.string().optional(),
-  tier: z.coerce.number().optional(),
-  featured: z.coerce.boolean().optional(),
-  q: z.string().optional(),
-  page: z.coerce.number().optional(),
-  perPage: z.coerce.number().optional(),
-});

package/src/features/categories/server.ts

@@ -1,12 +0,0 @@
-/**
- * @mohasinac/appkit/features/categories/server
- *
- * Server-only entry point — exports only the API route handlers.
- */
-
-export { GET as categoriesGET, GET, POST } from "./api/route";
-export {
-  categoryItemGET,
-  categoryItemPATCH,
-  categoryItemDELETE,
-} from "./api/[id]/route";

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

@@ -1,60 +0,0 @@
-export type CategoryType = "category" | "concern" | "collection" | "brand";
-
-export interface CategorySeo {
-  title?: string;
-  description?: string;
-  keywords?: string[];
-  ogImage?: string;
-}
-
-export interface CategoryDisplay {
-  icon?: string;
-  coverImage?: string;
-  color?: string;
-  showInMenu?: boolean;
-}
-
-export interface CategoryMetrics {
-  productCount: number;
-  totalItemCount: number;
-  lastUpdated?: string;
-}
-
-export interface CategoryAncestor {
-  id: string;
-  name: string;
-  tier: number;
-}
-
-export interface CategoryItem {
-  id: string;
-  type?: CategoryType;
-  name: string;
-  slug: string;
-  description?: string;
-  rootId?: string;
-  parentIds?: string[];
-  childrenIds?: string[];
-  tier: number;
-  path?: string;
-  order?: number;
-  isLeaf?: boolean;
-  metrics?: CategoryMetrics;
-  isFeatured?: boolean;
-  featuredPriority?: number;
-  /** @deprecated Use type === "brand" */ isBrand?: boolean;
-  seo?: CategorySeo;
-  display?: CategoryDisplay;
-  ancestors?: CategoryAncestor[];
-  createdAt?: string;
-  updatedAt?: string;
-}
-
-export interface CategoriesResponse {
-  items: CategoryItem[];
-  total: number;
-}
-
-// Concerns, collections, and brands are all categories with a type discriminator.
-export type Concern = CategoryItem;
-export type ConcernListResponse = CategoriesResponse;

package/src/features/checkout/components/CheckoutStepper.tsx

@@ -1,45 +0,0 @@
-import React from "react";
-import type { CheckoutStep } from "../types";
-import { Div, Nav, Span } from "../../../ui";
-
-interface CheckoutStepperProps {
-  steps: { id: CheckoutStep; label: string }[];
-  current: CheckoutStep;
-}
-
-export function CheckoutStepper({ steps, current }: CheckoutStepperProps) {
-  const currentIdx = steps.findIndex((s) => s.id === current);
-  return (
-    <Nav aria-label="Checkout steps" className="flex items-center gap-2">
-      {steps.map((step, idx) => {
-        const isDone = idx < currentIdx;
-        const isActive = step.id === current;
-        return (
-          <React.Fragment key={step.id}>
-            <Div className="flex items-center gap-1.5">
-              <Span
-                className={`flex h-6 w-6 items-center justify-center rounded-full text-xs font-semibold ${
-                  isDone
-                    ? "bg-green-500 text-white"
-                    : isActive
-                      ? "bg-neutral-900 text-white"
-                      : "bg-neutral-200 text-neutral-500"
-                }`}
-              >
-                {isDone ? "✓" : idx + 1}
-              </Span>
-              <Span
-                className={`text-sm font-medium ${isActive ? "text-neutral-900" : isDone ? "text-neutral-500" : "text-neutral-400"}`}
-              >
-                {step.label}
-              </Span>
-            </Div>
-            {idx < steps.length - 1 && (
-              <Span className="h-px flex-1 bg-neutral-200" />
-            )}
-          </React.Fragment>
-        );
-      })}
-    </Nav>
-  );
-}

package/src/features/checkout/hooks/useCheckout.ts

@@ -1,38 +0,0 @@
-"use client";
-import { useState, useCallback } from "react";
-import type {
-  CheckoutState,
-  CheckoutStep,
-  UserAddress,
-  ShippingOption,
-  PaymentGateway,
-} from "../types";
-
-export function useCheckout(initial?: Partial<CheckoutState>) {
-  const [state, setState] = useState<CheckoutState>({
-    step: "address",
-    ...initial,
-  });
-
-  const setStep = useCallback((step: CheckoutStep) => {
-    setState((s) => ({ ...s, step }));
-  }, []);
-
-  const setAddress = useCallback((address: UserAddress) => {
-    setState((s) => ({ ...s, address, step: "shipping" }));
-  }, []);
-
-  const setShipping = useCallback((option: ShippingOption) => {
-    setState((s) => ({ ...s, shippingOption: option, step: "payment" }));
-  }, []);
-
-  const setPayment = useCallback((gateway: PaymentGateway) => {
-    setState((s) => ({ ...s, paymentGateway: gateway, step: "review" }));
-  }, []);
-
-  const setCoupon = useCallback((code: string) => {
-    setState((s) => ({ ...s, couponCode: code }));
-  }, []);
-
-  return { state, setStep, setAddress, setShipping, setPayment, setCoupon };
-}

package/src/features/checkout/index.ts

@@ -1,4 +0,0 @@
-export * from "./types";
-export * from "./hooks/useCheckout";
-export * from "./components";
-export { manifest } from "./manifest";

package/src/features/checkout/manifest.ts

@@ -1,19 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-
-export const manifest: FeatureManifest = {
-  name: "checkout",
-  i18nNamespace: "checkout",
-  envKeys: [],
-  routes: [
-    { segment: "[locale]/checkout", exports: { default: "CheckoutView" } },
-    {
-      segment: "[locale]/checkout/confirmation",
-      exports: { default: "CheckoutConfirmationView" },
-    },
-  ],
-  apiRoutes: [
-    { segment: "api/checkout/shipping-options", methods: ["POST"] },
-    { segment: "api/checkout/place-order", methods: ["POST"] },
-    { segment: "api/checkout/apply-coupon", methods: ["POST"] },
-  ],
-};

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

@@ -1,62 +0,0 @@
-export type PaymentGateway =
-  | "razorpay"
-  | "stripe"
-  | "paypal"
-  | "cod"
-  | "upi"
-  | "whatsapp";
-
-export interface UserAddress {
-  id: string;
-  label?: string;
-  line1: string;
-  line2?: string;
-  city: string;
-  state: string;
-  postalCode: string;
-  country: string;
-  isDefault?: boolean;
-  phone?: string;
-}
-
-export type CheckoutStep =
-  | "address"
-  | "shipping"
-  | "payment"
-  | "review"
-  | "confirmation";
-
-export interface ShippingOption {
-  id: string;
-  label: string;
-  description?: string;
-  price: number;
-  currency?: string;
-  estimatedDays?: number;
-}
-
-export interface CheckoutState {
-  step: CheckoutStep;
-  address?: UserAddress;
-  shippingOption?: ShippingOption;
-  paymentGateway?: PaymentGateway;
-  couponCode?: string;
-  notes?: string;
-}
-
-export interface CheckoutSummary {
-  subtotal: number;
-  shippingCost: number;
-  discount?: number;
-  tax?: number;
-  total: number;
-  currency: string;
-}
-
-export interface PlaceOrderInput {
-  address: UserAddress;
-  shippingOptionId: string;
-  paymentGateway: PaymentGateway;
-  couponCode?: string;
-  notes?: string;
-}

package/src/features/cms/index.ts

@@ -1,6 +0,0 @@
-// @mohasinac/appkit/features/cms
-// CMS page renderer — content stored in Firestore site_settings/{pageId}
-// Views: AboutPageView, HowItWorksView, PolicyPageView, FeesTableView,
-//         TrackOrderView, SiteSettingsFormView, NavigationEditorView
-
-export const CMS_FEATURE = "cms";

package/src/features/collections/api/[slug]/route.ts

@@ -1,167 +0,0 @@
-/**
- * feat-collections — GET/PATCH/DELETE /api/collections/[slug]
- *
- * Collection retrieval, updates, and deletion by slug.
- *
- * Consumer stub:
- * ```ts
- * export { collectionDetailGET as GET, collectionDetailPATCH as PATCH, collectionDetailDELETE as DELETE } from "@mohasinac/feat-collections";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts";
-
-interface CollectionEntity extends Record<string, unknown> {
-  id: string;
-}
-
-export async function GET(
-  request: Request,
-  { params }: { params: { slug: string } },
-): Promise<NextResponse> {
-  try {
-    const { slug } = await params;
-    if (!slug) {
-      return NextResponse.json(
-        { success: false, error: "Collection slug required" },
-        { status: 400 },
-      );
-    }
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<CollectionEntity>("collections");
-    const result = await repo.findAll({
-      filters: `slug==${slug}`,
-      perPage: 1,
-    });
-
-    if (!result.data[0]) {
-      return NextResponse.json(
-        { success: false, error: "Collection not found" },
-        { status: 404 },
-      );
-    }
-
-    return NextResponse.json({
-      success: true,
-      data: result.data[0],
-    });
-  } catch (error) {
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "Internal server error",
-      },
-      { status: 500 },
-    );
-  }
-}
-
-export async function PATCH(
-  request: Request,
-  { params }: { params: { slug: string } },
-): Promise<NextResponse> {
-  try {
-    const { slug } = await params;
-    if (!slug) {
-      return NextResponse.json(
-        { success: false, error: "Collection slug required" },
-        { status: 400 },
-      );
-    }
-
-    const body = await request.json();
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<CollectionEntity>("collections");
-    const result = await repo.findAll({
-      filters: `slug==${slug}`,
-      perPage: 1,
-    });
-
-    if (!result.data[0]) {
-      return NextResponse.json(
-        { success: false, error: "Collection not found" },
-        { status: 404 },
-      );
-    }
-
-    const updated = await repo.update(result.data[0].id, body);
-
-    return NextResponse.json({
-      success: true,
-      data: updated,
-    });
-  } catch (error) {
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "Internal server error",
-      },
-      { status: 500 },
-    );
-  }
-}
-
-export async function DELETE(
-  request: Request,
-  { params }: { params: { slug: string } },
-): Promise<NextResponse> {
-  try {
-    const { slug } = await params;
-    if (!slug) {
-      return NextResponse.json(
-        { success: false, error: "Collection slug required" },
-        { status: 400 },
-      );
-    }
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<CollectionEntity>("collections");
-    const result = await repo.findAll({
-      filters: `slug==${slug}`,
-      perPage: 1,
-    });
-
-    if (!result.data[0]) {
-      return NextResponse.json(
-        { success: false, error: "Collection not found" },
-        { status: 404 },
-      );
-    }
-
-    await repo.delete(result.data[0].id);
-
-    return NextResponse.json({
-      success: true,
-      data: { slug },
-    });
-  } catch (error) {
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "Internal server error",
-      },
-      { status: 500 },
-    );
-  }
-}