@mohasinac/appkit 2.1.3 → 2.3.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/messages/en.json

@@ -1,14 +0,0 @@
-{
-  "title": "Categories",
-  "allCategories": "All Categories",
-  "noCategories": "No categories found",
-  "exploreAll": "Explore All",
-  "items": "{{count}} items",
-  "viewAll": "View All",
-  "concern": {
-    "title": "Shop by Concern",
-    "subtitle": "Find products tailored to your skin and hair needs",
-    "seeAll": "See all concerns",
-    "noProducts": "No products found for this concern"
-  }
-}

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/components/index.ts

@@ -1 +0,0 @@
-export { CheckoutStepper } from "./CheckoutStepper";

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/messages/en.json

@@ -1,10 +0,0 @@
-{
-  "title": "Checkout",
-  "address": "Delivery Address",
-  "shipping": "Shipping",
-  "payment": "Payment",
-  "review": "Review",
-  "confirmation": "Confirmation",
-  "placeOrder": "Place Order",
-  "orderPlaced": "Order placed successfully!"
-}

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";