@mohasinac/appkit 2.1.3 → 2.3.0

package/src/features/blog/hooks/useBlog.ts

@@ -1,67 +0,0 @@
-"use client";
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import type { BlogListResponse, BlogListParams } from "../types";
-import type { BlogPostDetailResponse } from "../api/[slug]/route";
-
-export type { BlogListResponse };
-
-interface UseBlogPostsOptions {
-  initialData?: BlogListResponse;
-  enabled?: boolean;
-}
-
-export function useBlogPosts(
-  params: BlogListParams = {},
-  opts?: UseBlogPostsOptions,
-) {
-  const searchParams = new URLSearchParams();
-  if (params.category) searchParams.set("category", params.category);
-  if (params.q) searchParams.set("q", params.q);
-  if (params.tags) searchParams.set("tags", params.tags);
-  if (params.page) searchParams.set("page", String(params.page));
-  if (params.perPage) searchParams.set("perPage", String(params.perPage));
-  if (params.sort) searchParams.set("sort", params.sort);
-  if (params.featured !== undefined)
-    searchParams.set("featured", String(params.featured));
-  const qs = searchParams.toString();
-
-  const query = useQuery<BlogListResponse>({
-    queryKey: ["blog", qs],
-    queryFn: () =>
-      apiClient.get<BlogListResponse>(`/api/blog${qs ? `?${qs}` : ""}`),
-    initialData: opts?.initialData,
-    enabled: opts?.enabled,
-  });
-
-  return {
-    posts: query.data?.posts ?? [],
-    meta: query.data?.meta,
-    total: query.data?.meta?.total ?? 0,
-    totalPages: query.data?.meta?.totalPages ?? 1,
-    page: query.data?.meta?.page ?? 1,
-    isLoading: query.isLoading,
-    error: query.error,
-  };
-}
-
-interface UseBlogPostOptions {
-  initialData?: BlogPostDetailResponse;
-  enabled?: boolean;
-}
-
-export function useBlogPost(slug: string, opts?: UseBlogPostOptions) {
-  const query = useQuery<BlogPostDetailResponse>({
-    queryKey: ["blog", "post", slug],
-    queryFn: () => apiClient.get<BlogPostDetailResponse>(`/api/blog/${slug}`),
-    initialData: opts?.initialData,
-    enabled: opts?.enabled !== false && !!slug,
-  });
-
-  return {
-    post: query.data?.post ?? null,
-    related: query.data?.related ?? [],
-    isLoading: query.isLoading,
-    error: query.error,
-  };
-}

package/src/features/blog/index.ts

@@ -1,7 +0,0 @@
-export * from "./types";
-export * from "./hooks/useBlog";
-export * from "./components";
-export * from "./schemas";
-export * from "./columns";
-export { BlogRepository } from "./repository/blog.repository";
-export { manifest } from "./manifest";

package/src/features/blog/manifest.ts

@@ -1,16 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-
-export const manifest: FeatureManifest = {
-  name: "blog",
-  i18nNamespace: "blog",
-  envKeys: [],
-  routes: [
-    { segment: "[locale]/blog", exports: { default: "BlogListView" } },
-    { segment: "[locale]/blog/[slug]", exports: { default: "BlogPostView" } },
-  ],
-  apiRoutes: [
-    { segment: "api/blog", methods: ["GET", "POST"] },
-    { segment: "api/blog/[slug]", methods: ["GET", "PATCH", "DELETE"] },
-    { segment: "api/blog/[slug]/related", methods: ["GET"] },
-  ],
-};

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

@@ -1,14 +0,0 @@
-{
-  "title": "Blog",
-  "all": "All",
-  "readMore": "Read More",
-  "minRead": "{{count}} min read",
-  "noPostsFound": "No posts found",
-  "category": {
-    "news": "News",
-    "tips": "Tips",
-    "guides": "Guides",
-    "updates": "Updates",
-    "community": "Community"
-  }
-}

package/src/features/blog/repository/blog.repository.ts

@@ -1,73 +0,0 @@
-import type {
-  IRepository,
-  PagedResult,
-  SieveQuery,
-} from "../../../contracts";
-import type { BlogPost, BlogPostCategory } from "../types";
-
-export class BlogRepository {
-  constructor(private readonly repo: IRepository<BlogPost>) {}
-
-  async findAll(query?: SieveQuery): Promise<PagedResult<BlogPost>> {
-    const base: SieveQuery = { filters: "status==published", ...query };
-    if (query?.filters) {
-      base.filters = `status==published,${query.filters}`;
-    }
-    return this.repo.findAll(base);
-  }
-
-  async findBySlug(slug: string): Promise<BlogPost | null> {
-    const result = await this.repo.findAll({
-      filters: `slug==${slug},status==published`,
-      perPage: 1,
-    });
-    return result.data[0] ?? null;
-  }
-
-  async findLatest(n = 5): Promise<BlogPost[]> {
-    const result = await this.repo.findAll({
-      filters: "status==published",
-      sort: "-publishedAt",
-      perPage: n,
-    });
-    return result.data;
-  }
-
-  async findFeatured(n = 3): Promise<BlogPost[]> {
-    const result = await this.repo.findAll({
-      filters: "status==published,isFeatured==true",
-      sort: "-publishedAt",
-      perPage: n,
-    });
-    return result.data;
-  }
-
-  async findByCategory(
-    category: BlogPostCategory,
-    page = 1,
-    perPage = 10,
-  ): Promise<PagedResult<BlogPost>> {
-    return this.repo.findAll({
-      filters: `status==published,category==${category}`,
-      sort: "-publishedAt",
-      page,
-      perPage,
-    });
-  }
-
-  async findById(id: string): Promise<BlogPost | null> {
-    return this.repo.findById(id);
-  }
-
-  async create(data: Omit<BlogPost, "id">): Promise<BlogPost> {
-    return this.repo.create(data);
-  }
-
-  async update(id: string, data: Partial<BlogPost>): Promise<BlogPost> {
-    return this.repo.update(id, data);
-  }
-
-  async delete(id: string): Promise<void> {
-    return this.repo.delete(id);
-  }
-}

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

@@ -1,74 +0,0 @@
-import { z } from "zod";
-import { mediaFieldSchema } from "../../media/types/index";
-
-const blogCoverImageSchema = z
-  .union([
-    mediaFieldSchema,
-    z.string().url().transform((url) => ({ url, type: "image" as const })),
-  ])
-  .nullable()
-  .optional()
-  .transform((value) => value ?? null);
-
-// ─── Sub-schemas ──────────────────────────────────────────────────────────────
-
-export const blogPostCategorySchema = z.enum([
-  "news",
-  "tips",
-  "guides",
-  "updates",
-  "community",
-]);
-
-export const blogPostStatusSchema = z.enum(["draft", "published", "archived"]);
-
-// ─── Base item schema ─────────────────────────────────────────────────────────
-
-/**
- * Base Zod schema for a blog post.
- * Apps can extend this to add their own fields:
- *
- * @example
- * import { blogPostSchema } from "@mohasinac/feat-blog";
- *
- * const myPostSchema = blogPostSchema.extend({
- *   series: z.string().optional(),
- *   sponsoredBy: z.string().optional(),
- * });
- * type MyPost = z.infer<typeof myPostSchema>;
- */
-export const blogPostSchema = z.object({
-  id: z.string(),
-  title: z.string(),
-  slug: z.string(),
-  excerpt: z.string().optional(),
-  content: z.string().optional(),
-  coverImage: blogCoverImageSchema,
-  contentImages: z.array(mediaFieldSchema).max(10).optional().default([]),
-  additionalImages: z.array(mediaFieldSchema).max(5).optional().default([]),
-  category: blogPostCategorySchema,
-  tags: z.array(z.string()).optional(),
-  isFeatured: z.boolean().optional(),
-  status: blogPostStatusSchema,
-  publishedAt: z.string().optional(),
-  authorId: z.string().optional(),
-  authorName: z.string().optional(),
-  authorAvatar: z.string().optional(),
-  readTimeMinutes: z.number().optional(),
-  views: z.number().optional(),
-  metaTitle: z.string().optional(),
-  metaDescription: z.string().optional(),
-  createdAt: z.string().optional(),
-  updatedAt: z.string().optional(),
-});
-
-/** Base Zod schema for list-query parameters. */
-export const blogListParamsSchema = z.object({
-  category: blogPostCategorySchema.optional(),
-  tags: z.string().optional(),
-  q: z.string().optional(),
-  page: z.coerce.number().optional(),
-  perPage: z.coerce.number().optional(),
-  sort: z.string().optional(),
-  featured: z.coerce.boolean().optional(),
-});

package/src/features/blog/server.ts

@@ -1,9 +0,0 @@
-/**
- * @mohasinac/appkit/features/blog/server
- *
- * Server-only entry point — exports only the API route handlers.
- */
-
-export { GET as blogGET, GET } from "./api/route";
-export { GET as blogSlugGET } from "./api/[slug]/route";
-export type { BlogPostDetailResponse } from "./api/[slug]/route";

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

@@ -1,58 +0,0 @@
-import type { MediaField, MediaFieldInput } from "../../media/types/index";
-
-export type BlogPostCategory =
-  | "news"
-  | "tips"
-  | "guides"
-  | "updates"
-  | "community";
-
-export type BlogPostStatus = "draft" | "published" | "archived";
-
-export interface BlogPost {
-  id: string;
-  title: string;
-  slug: string;
-  excerpt?: string;
-  content?: string;
-  coverImage?: MediaFieldInput;
-  contentImages?: MediaField[];
-  additionalImages?: MediaField[];
-  category: BlogPostCategory;
-  tags?: string[];
-  isFeatured?: boolean;
-  status: BlogPostStatus;
-  publishedAt?: string;
-  authorId?: string;
-  authorName?: string;
-  authorAvatar?: string;
-  readTimeMinutes?: number;
-  views?: number;
-  metaTitle?: string;
-  metaDescription?: string;
-  createdAt?: string;
-  updatedAt?: string;
-}
-
-export interface BlogListMeta {
-  total: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasMore: boolean;
-}
-
-export interface BlogListResponse {
-  posts: BlogPost[];
-  meta: BlogListMeta;
-}
-
-export interface BlogListParams {
-  category?: BlogPostCategory;
-  tags?: string;
-  q?: string;
-  page?: number;
-  perPage?: number;
-  sort?: string;
-  featured?: boolean;
-}

package/src/features/cart/api/[id]/route.ts

@@ -1,98 +0,0 @@
-/**
- * feat-cart — PATCH/DELETE /api/cart/[id]
- *
- * Cart item update and deletion.
- *
- * Consumer stub:
- * ```ts
- * export { cartItemPATCH as PATCH, cartItemDELETE as DELETE } from "@mohasinac/feat-cart";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../../contracts";
-
-export async function PATCH(
-  request: Request,
-  { params }: { params: { id: string } },
-): Promise<NextResponse> {
-  try {
-    const { id } = await params;
-    if (!id) {
-      return NextResponse.json(
-        { success: false, error: "Cart ID 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<Record<string, unknown>>("carts");
-    const updated = await repo.update(id, body);
-
-    if (!updated) {
-      return NextResponse.json(
-        { success: false, error: "Cart not found" },
-        { status: 404 },
-      );
-    }
-
-    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: { id: string } },
-): Promise<NextResponse> {
-  try {
-    const { id } = await params;
-    if (!id) {
-      return NextResponse.json(
-        { success: false, error: "Cart ID required" },
-        { status: 400 },
-      );
-    }
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<Record<string, unknown>>("carts");
-    await repo.delete(id);
-
-    return NextResponse.json({
-      success: true,
-      data: { id },
-    });
-  } catch (error) {
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "Internal server error",
-      },
-      { status: 500 },
-    );
-  }
-}

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

@@ -1,104 +0,0 @@
-/**
- * feat-cart — GET/POST /api/cart
- *
- * User cart list with Sieve filtering and cart creation.
- *
- * Consumer stub:
- * ```ts
- * export { cartListGET as GET, cartListPOST as POST } from "@mohasinac/feat-cart";
- * ```
- */
-
-import { NextResponse } from "next/server.js";
-import { getProviders } from "../../../contracts";
-
-function numParam(url: URL, key: string, fallback: number): number {
-  const v = url.searchParams.get(key);
-  const n = v !== null ? Number(v) : NaN;
-  return Number.isFinite(n) ? n : fallback;
-}
-
-export async function GET(request: Request): Promise<NextResponse> {
-  try {
-    const url = new URL(request.url);
-    const page = Math.max(1, numParam(url, "page", 1));
-    const pageSize = Math.min(100, Math.max(1, numParam(url, "pageSize", 20)));
-    const filters = url.searchParams.get("filters") ?? undefined;
-    const sort =
-      url.searchParams.get("sorts") ??
-      url.searchParams.get("sort") ??
-      "-createdAt";
-
-    const { db } = getProviders();
-    if (!db)
-      return NextResponse.json(
-        { success: false, error: "DB not configured" },
-        { status: 503 },
-      );
-
-    const repo = db.getRepository<Record<string, unknown>>("carts");
-    const result = await repo.findAll({
-      filters,
-      sort,
-      page,
-      perPage: pageSize,
-    });
-
-    const totalPages = Math.max(1, Math.ceil(result.total / pageSize));
-
-    return NextResponse.json({
-      success: true,
-      data: {
-        items: result.data,
-        total: result.total,
-        page,
-        pageSize,
-        totalPages,
-        hasMore: page < totalPages,
-      },
-    });
-  } catch (error) {
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "Internal server error",
-      },
-      { status: 500 },
-    );
-  }
-}
-
-export async function POST(request: Request): Promise<NextResponse> {
-  try {
-    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<Record<string, unknown>>("carts");
-    const created = await repo.create({
-      ...body,
-      createdAt: new Date(),
-    });
-
-    return NextResponse.json(
-      {
-        success: true,
-        data: created,
-      },
-      { status: 201 },
-    );
-  } catch (error) {
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "Internal server error",
-      },
-      { status: 500 },
-    );
-  }
-}

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

@@ -1,73 +0,0 @@
-import type { TableColumn, ColumnExtensionOpts } from "../../../contracts";
-import type { CartItem } from "../types";
-
-/**
- * Default admin columns for cart items.
- * Use `buildCartColumns()` to customise via overrides / extras / omit.
- */
-export const cartAdminColumns: TableColumn<CartItem>[] = [
-  {
-    key: "meta",
-    header: "Product",
-    sortable: false,
-    render: (item) => (item.meta as { title?: string })?.title ?? item.productId,
-  },
-  {
-    key: "quantity",
-    header: "Qty",
-    sortable: true,
-  },
-  {
-    key: "meta",
-    header: "Unit Price",
-    sortable: false,
-    render: (item) => {
-      const meta = item.meta as { price?: number; currency?: string } | undefined;
-      if (!meta?.price) return "—";
-      return `${meta.currency ?? "INR"} ${meta.price}`;
-    },
-  },
-  {
-    key: "userId",
-    header: "User / Session",
-    sortable: false,
-    render: (item) => item.userId ?? item.sessionId ?? "—",
-  },
-  {
-    key: "addedAt",
-    header: "Added",
-    sortable: true,
-  },
-];
-
-/**
- * Factory that returns columns for the cart admin table.
- *
- * @example
- * const cols = buildCartColumns<MyCartItem>({
- *   extras: [{ key: "giftMessage", header: "Gift Msg", render: (c) => c.giftMessage }],
- *   omit: ["userId"],
- * });
- */
-export function buildCartColumns<T extends CartItem = CartItem>(
-  opts?: ColumnExtensionOpts<T>
-): TableColumn<T>[] {
-  let base = cartAdminColumns as unknown as TableColumn<T>[];
-
-  if (opts?.omit?.length) {
-    base = base.filter((c) => !opts.omit!.includes(c.key as string));
-  }
-
-  if (opts?.overrides) {
-    base = base.map((c) => {
-      const override = (opts.overrides as Record<string, Partial<TableColumn<T>>>)[c.key as string];
-      return override ? { ...c, ...override } : c;
-    });
-  }
-
-  if (opts?.extras?.length) {
-    base = [...base, ...opts.extras];
-  }
-
-  return base;
-}