@mohasinac/appkit 2.1.3 → 2.3.0

package/src/features/wishlist/components/WishlistView.tsx

@@ -1,150 +0,0 @@
-"use client";
-
-import React from "react";
-import { Div, Heading, Row, Text } from "../../../ui";
-import { useWishlist } from "../hooks/useWishlist";
-import type { WishlistItem, WishlistResponse } from "../types";
-
-export type WishlistTab = "products" | "auctions" | "categories" | "stores";
-
-export interface WishlistViewProps {
-  /** Authenticated user id — required to fetch wishlist */
-  userId: string;
-  /** Optional initial SSR data */
-  initialData?: WishlistResponse;
-  labels?: {
-    title?: string;
-    subtitle?: string;
-    emptyTitle?: string;
-    emptyDescription?: string;
-  };
-  /** Render tab bar (receives active tab and setter) */
-  renderTabs?: (
-    activeTab: WishlistTab,
-    onTabChange: (tab: WishlistTab) => void,
-  ) => React.ReactNode;
-  /** Render search input */
-  renderSearch?: (
-    value: string,
-    onChange: (v: string) => void,
-  ) => React.ReactNode;
-  /** Render sort dropdown */
-  renderSort?: (
-    value: string,
-    onChange: (v: string) => void,
-  ) => React.ReactNode;
-  /** Render view mode toggle */
-  renderViewToggle?: (
-    mode: string,
-    onToggle: (m: string) => void,
-  ) => React.ReactNode;
-  /** Render the products grid */
-  renderProducts: (
-    items: WishlistItem[],
-    isLoading: boolean,
-  ) => React.ReactNode;
-  /** Render coming-soon placeholder for non-products tabs */
-  renderTabPlaceholder?: (tab: WishlistTab) => React.ReactNode;
-  /** Render bulk action bar */
-  renderBulkActions?: (
-    selectedIds: string[],
-    onClearSelection: () => void,
-  ) => React.ReactNode;
-  /** Render pagination */
-  renderPagination?: (total: number) => React.ReactNode;
-  className?: string;
-}
-
-export function WishlistView({
-  userId,
-  initialData,
-  labels = {},
-  renderTabs,
-  renderSearch,
-  renderSort,
-  renderViewToggle,
-  renderProducts,
-  renderTabPlaceholder,
-  renderBulkActions,
-  renderPagination,
-  className = "",
-}: WishlistViewProps) {
-  const [activeTab, setActiveTab] = React.useState<WishlistTab>("products");
-  const [search, setSearch] = React.useState("");
-  const [sort, setSort] = React.useState("-addedAt");
-  const [viewMode, setViewMode] = React.useState("card");
-  const [selectedIds, setSelectedIds] = React.useState<string[]>([]);
-
-  const { items, total, isLoading } = useWishlist(userId, { initialData });
-
-  // Client-side filter + sort for products tab
-  const displayedItems = React.useMemo(() => {
-    if (activeTab !== "products") return [];
-    let result = [...items];
-    const q = search.trim().toLowerCase();
-    if (q) {
-      result = result.filter(
-        (i) =>
-          (i.productTitle ?? "").toLowerCase().includes(q) ||
-          (i.productSlug ?? "").toLowerCase().includes(q),
-      );
-    }
-    result.sort((a, b) => {
-      const desc = sort.startsWith("-");
-      const field = desc ? sort.slice(1) : sort;
-      if (field === "price") {
-        const av = a.productPrice ?? 0;
-        const bv = b.productPrice ?? 0;
-        return desc ? bv - av : av - bv;
-      }
-      const av = new Date(a.addedAt ?? "").getTime();
-      const bv = new Date(b.addedAt ?? "").getTime();
-      return desc ? bv - av : av - bv;
-    });
-    return result;
-  }, [items, activeTab, search, sort]);
-
-  return (
-    <Div className={`min-h-screen ${className}`}>
-      <Div className="py-8 px-4 max-w-screen-xl mx-auto">
-        {/* Header */}
-        <Heading level={1} className="text-2xl font-bold mb-1">
-          {labels.title ?? "My Wishlist"}
-        </Heading>
-        {total > 0 && (
-          <Text variant="secondary" className="mb-4">
-            {labels.subtitle ?? `${total} saved items`}
-          </Text>
-        )}
-
-        {/* Tabs */}
-        {renderTabs?.(activeTab, setActiveTab)}
-
-        {/* Toolbar: search + sort + view toggle */}
-        {activeTab === "products" && (
-          <Row wrap gap="3" className="mb-4">
-            {renderSearch?.(search, setSearch)}
-            {renderSort?.(sort, setSort)}
-            {renderViewToggle?.(viewMode, setViewMode)}
-          </Row>
-        )}
-
-        {/* Bulk actions */}
-        {selectedIds.length > 0 &&
-          renderBulkActions?.(selectedIds, () => setSelectedIds([]))}
-
-        {/* Content */}
-        {activeTab === "products"
-          ? renderProducts(displayedItems, isLoading)
-          : (renderTabPlaceholder?.(activeTab) ?? (
-              <Div className="py-16 text-center">
-                <Text variant="secondary">Coming soon</Text>
-              </Div>
-            ))}
-
-        {/* Pagination */}
-        {renderPagination?.(total)}
-      </Div>
-    </Div>
-  );
-}

package/src/features/wishlist/components/index.ts

@@ -1,4 +0,0 @@
-export { WishlistCard, WishlistPage } from "./WishlistPage";
-export { WishlistToggleButton } from "./WishlistToggleButton";
-export { WishlistView } from "./WishlistView";
-export type { WishlistViewProps, WishlistTab } from "./WishlistView";

package/src/features/wishlist/hooks/useUserWishlist.ts

@@ -1,39 +0,0 @@
-"use client";
-
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-
-export interface UserWishlistItem<TProduct = unknown> {
-  productId: string;
-  addedAt: string;
-  product: TProduct | null;
-}
-
-export interface UserWishlistResponse<TProduct = unknown> {
-  items: UserWishlistItem<TProduct>[];
-  meta: { total: number };
-}
-
-interface UseUserWishlistOptions<TProduct> {
-  enabled?: boolean;
-  endpoint?: string;
-  queryKey?: unknown[];
-  initialData?: UserWishlistResponse<TProduct>;
-}
-
-export function useUserWishlist<TProduct = unknown>(
-  options?: UseUserWishlistOptions<TProduct>,
-) {
-  const endpoint = options?.endpoint ?? "/api/user/wishlist";
-  const query = useQuery<UserWishlistResponse<TProduct>>({
-    queryKey: options?.queryKey ?? ["user", "wishlist"],
-    queryFn: () => apiClient.get<UserWishlistResponse<TProduct>>(endpoint),
-    enabled: options?.enabled ?? true,
-    initialData: options?.initialData,
-  });
-
-  return {
-    ...query,
-    total: query.data?.meta.total ?? 0,
-  };
-}

package/src/features/wishlist/hooks/useWishlist.ts

@@ -1,31 +0,0 @@
-"use client";
-import { useQuery } from "@tanstack/react-query";
-import { apiClient } from "../../../http";
-import type { WishlistResponse } from "../types";
-
-interface UseWishlistOptions {
-  initialData?: WishlistResponse;
-  enabled?: boolean;
-}
-
-export function useWishlist(userId: string, opts?: UseWishlistOptions) {
-  const query = useQuery<WishlistResponse>({
-    queryKey: ["wishlist", userId],
-    queryFn: () =>
-      apiClient.get<WishlistResponse>(`/api/wishlist?userId=${userId}`),
-    initialData: opts?.initialData,
-    enabled: opts?.enabled !== false && !!userId,
-  });
-
-  const ids = new Set((query.data?.items ?? []).map((i) => i.productId));
-
-  return {
-    items: query.data?.items ?? [],
-    total: query.data?.total ?? 0,
-    wishlistedIds: ids,
-    isWishlisted: (productId: string) => ids.has(productId),
-    isLoading: query.isLoading,
-    error: query.error,
-    refetch: query.refetch,
-  };
-}

package/src/features/wishlist/index.ts

@@ -1,8 +0,0 @@
-export * from "./types";
-export * from "./schemas";
-export * from "./columns";
-export * from "./hooks/useWishlist";
-export * from "./hooks/useUserWishlist";
-export * from "./components";
-export { WishlistRepository } from "./repository/wishlist.repository";
-export { manifest } from "./manifest";

package/src/features/wishlist/manifest.ts

@@ -1,14 +0,0 @@
-import type { FeatureManifest } from "../../contracts";
-
-export const manifest: FeatureManifest = {
-  name: "wishlist",
-  i18nNamespace: "wishlist",
-  envKeys: [],
-  routes: [
-    { segment: "[locale]/wishlist", exports: { default: "WishlistView" } },
-  ],
-  apiRoutes: [
-    { segment: "api/wishlist", methods: ["GET", "POST"] },
-    { segment: "api/wishlist/[id]", methods: ["DELETE"] },
-  ],
-};

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

@@ -1,7 +0,0 @@
-{
-  "title": "Wishlist",
-  "empty": "Your wishlist is empty",
-  "remove": "Remove",
-  "addToCart": "Add to Cart",
-  "itemCount": "{{count}} items"
-}

package/src/features/wishlist/repository/wishlist.repository.ts

@@ -1,43 +0,0 @@
-import type {
-  IRepository,
-  PagedResult,
-  SieveQuery,
-} from "../../../contracts";
-import type { WishlistItem } from "../types";
-
-export class WishlistRepository {
-  constructor(private readonly repo: IRepository<WishlistItem>) {}
-
-  async findByUser(userId: string): Promise<WishlistItem[]> {
-    const result = await this.repo.findAll({
-      filters: `userId==${userId}`,
-      sort: "-addedAt",
-      perPage: 200,
-    });
-    return result.data;
-  }
-
-  async findAll(query?: SieveQuery): Promise<PagedResult<WishlistItem>> {
-    return this.repo.findAll(query ?? {});
-  }
-
-  async findById(id: string): Promise<WishlistItem | null> {
-    return this.repo.findById(id);
-  }
-
-  async add(data: Omit<WishlistItem, "id">): Promise<WishlistItem> {
-    return this.repo.create(data);
-  }
-
-  async remove(id: string): Promise<void> {
-    return this.repo.delete(id);
-  }
-
-  async update(id: string, data: Partial<WishlistItem>): Promise<WishlistItem> {
-    return this.repo.update(id, data);
-  }
-
-  async delete(id: string): Promise<void> {
-    return this.repo.delete(id);
-  }
-}

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

@@ -1,25 +0,0 @@
-import { z } from "zod";
-
-/**
- * Base Zod schema for a wishlist item.
- * Apps can extend this to add their own fields:
- *
- * @example
- * import { wishlistItemSchema } from "@mohasinac/feat-wishlist";
- *
- * const mySchema = wishlistItemSchema.extend({
- *   priceAlertThreshold: z.number().optional(),
- * });
- */
-export const wishlistItemSchema = z.object({
-  id: z.string(),
-  userId: z.string(),
-  productId: z.string(),
-  productTitle: z.string().optional(),
-  productImage: z.string().optional(),
-  productPrice: z.number().optional(),
-  productCurrency: z.string().optional(),
-  productSlug: z.string().optional(),
-  productStatus: z.string().optional(),
-  addedAt: z.string().optional(),
-});

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

@@ -1,17 +0,0 @@
-export interface WishlistItem {
-  id: string;
-  userId: string;
-  productId: string;
-  productTitle?: string;
-  productImage?: string;
-  productPrice?: number;
-  productCurrency?: string;
-  productSlug?: string;
-  productStatus?: string;
-  addedAt?: string;
-}
-
-export interface WishlistResponse {
-  items: WishlistItem[];
-  total: number;
-}

package/src/http/ApiClient.ts

@@ -1,247 +0,0 @@
-/**
- * ApiClient — @mohasinac/http
- *
- * Centralized HTTP client with consistent error handling,
- * timeout management, abort controller, and JSON parsing.
- *
- * Stripped of app-specific `API_ENDPOINTS` dependency from the original
- * `src/lib/api-client.ts`. The constructor accepts a `baseURL` option
- * instead of reading `process.env.NEXT_PUBLIC_API_URL` directly.
- *
- * Usage:
- * ```ts
- * import { ApiClient, ApiClientError } from "./";
- *
- * const client = new ApiClient({ baseURL: process.env.NEXT_PUBLIC_APP_URL });
- * const data = await client.get("/api/products");
- * ```
- */
-
-export class ApiClientError extends Error {
-  constructor(
-    message: string,
-    public readonly status: number,
-    public readonly data?: unknown,
-  ) {
-    super(message);
-    this.name = "ApiClientError";
-  }
-}
-
-export interface RequestConfig extends RequestInit {
-  params?: Record<string, string | number | boolean>;
-  timeout?: number;
-}
-
-export interface ApiResponse<T = unknown> {
-  success: boolean;
-  data?: T;
-  error?: string;
-  message?: string;
-}
-
-export interface ApiClientOptions {
-  /**
-   * Base URL for relative endpoint resolution.
-   * Falls back to `window.location.origin` in browsers or
-   * `process.env.NEXT_PUBLIC_APP_URL` / `http://localhost:3000` on the server.
-   */
-  baseURL?: string;
-  /** Default request timeout in milliseconds. Default: 120000 (2 min). */
-  defaultTimeout?: number;
-}
-
-export class ApiClient {
-  private readonly baseURL: string;
-  private readonly defaultTimeout: number;
-
-  constructor(options?: ApiClientOptions) {
-    this.baseURL = options?.baseURL ?? process.env.NEXT_PUBLIC_APP_URL ?? "";
-    this.defaultTimeout = options?.defaultTimeout ?? 120_000;
-  }
-
-  private buildURL(
-    endpoint: string,
-    params?: Record<string, string | number | boolean>,
-  ): string {
-    const origin =
-      this.baseURL ||
-      (typeof window !== "undefined"
-        ? window.location.origin
-        : (process.env.NEXT_PUBLIC_APP_URL ?? "http://localhost:3000"));
-    const url = new URL(endpoint, origin);
-    if (params) {
-      Object.entries(params).forEach(([key, value]) =>
-        url.searchParams.append(key, String(value)),
-      );
-    }
-    return url.toString();
-  }
-
-  private async getHeaders(
-    method: string,
-    customHeaders?: HeadersInit,
-  ): Promise<HeadersInit> {
-    const hasBody = !["GET", "HEAD", "DELETE"].includes(method.toUpperCase());
-    return {
-      ...(hasBody ? { "Content-Type": "application/json" } : {}),
-      ...customHeaders,
-    };
-  }
-
-  private async request<T>(
-    endpoint: string,
-    config: RequestConfig = {},
-  ): Promise<T> {
-    const {
-      params,
-      timeout = this.defaultTimeout,
-      headers: customHeaders,
-      signal: externalSignal,
-      ...fetchConfig
-    } = config;
-    const method = (fetchConfig.method ?? "GET").toUpperCase();
-
-    const url = this.buildURL(endpoint, params);
-    const headers = await this.getHeaders(method, customHeaders);
-
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), timeout);
-
-    let onAbort: (() => void) | null = null;
-    if (externalSignal) {
-      if (externalSignal.aborted) {
-        controller.abort();
-      } else {
-        onAbort = () => controller.abort();
-        externalSignal.addEventListener("abort", onAbort);
-      }
-    }
-
-    try {
-      const response = await fetch(url, {
-        ...fetchConfig,
-        headers,
-        signal: controller.signal,
-        credentials: "include",
-      });
-
-      clearTimeout(timeoutId);
-
-      const data: ApiResponse<T> = await response.json().catch(() => ({
-        success: false,
-        error: "Invalid JSON response",
-      }));
-
-      if (!response.ok) {
-        throw new ApiClientError(
-          data.error ??
-            data.message ??
-            `Request failed with status ${response.status}`,
-          response.status,
-          data,
-        );
-      }
-
-      if (!data.success) {
-        throw new ApiClientError(
-          data.error ?? data.message ?? "Request failed",
-          response.status,
-          data,
-        );
-      }
-
-      return data.data as T;
-    } catch (error) {
-      clearTimeout(timeoutId);
-
-      if (error instanceof Error && error.name === "AbortError") {
-        if (externalSignal?.aborted) throw error;
-        throw new ApiClientError("Request timeout", 408);
-      }
-
-      if (error instanceof TypeError) {
-        throw new ApiClientError(
-          "Network error. Please check your connection.",
-          0,
-        );
-      }
-
-      if (error instanceof ApiClientError) throw error;
-
-      throw new ApiClientError(
-        error instanceof Error ? error.message : "An unexpected error occurred",
-        500,
-      );
-    } finally {
-      if (onAbort) externalSignal?.removeEventListener("abort", onAbort);
-    }
-  }
-
-  async get<T = unknown>(endpoint: string, config?: RequestConfig): Promise<T> {
-    return this.request<T>(endpoint, { ...config, method: "GET" });
-  }
-
-  async post<T = unknown>(
-    endpoint: string,
-    data?: unknown,
-    config?: RequestConfig,
-  ): Promise<T> {
-    return this.request<T>(endpoint, {
-      ...config,
-      method: "POST",
-      body: data != null ? JSON.stringify(data) : undefined,
-    });
-  }
-
-  async put<T = unknown>(
-    endpoint: string,
-    data?: unknown,
-    config?: RequestConfig,
-  ): Promise<T> {
-    return this.request<T>(endpoint, {
-      ...config,
-      method: "PUT",
-      body: data != null ? JSON.stringify(data) : undefined,
-    });
-  }
-
-  async patch<T = unknown>(
-    endpoint: string,
-    data?: unknown,
-    config?: RequestConfig,
-  ): Promise<T> {
-    return this.request<T>(endpoint, {
-      ...config,
-      method: "PATCH",
-      body: data != null ? JSON.stringify(data) : undefined,
-    });
-  }
-
-  async delete<T = unknown>(
-    endpoint: string,
-    config?: RequestConfig,
-  ): Promise<T> {
-    return this.request<T>(endpoint, { ...config, method: "DELETE" });
-  }
-
-  async upload<T = unknown>(
-    endpoint: string,
-    formData: FormData,
-    config?: RequestConfig,
-  ): Promise<T> {
-    const { headers, ...restConfig } = config ?? {};
-    const uploadHeaders = await this.getHeaders("POST", headers);
-    // Remove Content-Type so browser can set it with multipart boundary
-    delete (uploadHeaders as Record<string, string>)["Content-Type"];
-    return this.request<T>(endpoint, {
-      ...restConfig,
-      method: "POST",
-      body: formData,
-      headers: uploadHeaders,
-    });
-  }
-}
-
-/** Default singleton instance — reads NEXT_PUBLIC_APP_URL from env */
-export const apiClient = new ApiClient();

package/src/http/index.ts

@@ -1,10 +0,0 @@
-/**
- * @mohasinac/http — Stage B3
- *
- * Framework-agnostic HTTP client extracted from src/lib/api-client.ts.
- * No app-specific imports (API_ENDPOINTS stripped).
- * Accepts baseURL as a constructor option instead.
- */
-
-export { ApiClient, ApiClientError, apiClient } from "./ApiClient";
-export type { ApiClientOptions, RequestConfig, ApiResponse } from "./ApiClient";

package/src/index.ts

@@ -1,22 +0,0 @@
-/**
- * @mohasinac/appkit — Root barrel export
- *
- * Prefer importing from specific sub-paths for better tree-shaking:
- *   import { getProviders } from "@mohasinac/appkit/contracts"
- *   import { apiClient }    from "@mohasinac/appkit/http"
- *   import { Button }       from "@mohasinac/appkit/ui"
- *
- * This root barrel is provided for convenience in small projects or
- * when bundle size is not a concern.
- */
-
-export * from "./contracts/index";
-export * from "./core/index";
-export * from "./http/index";
-export * from "./errors/index";
-export * from "./utils/index";
-export * from "./validation/index";
-export * from "./tokens/index";
-export * from "./security/index";
-export * from "./seo/index";
-export * from "./monitoring/index";