@classytic/commerce-sdk 0.1.1 → 0.2.1

package/dist/analytics/types.d.ts

@@ -0,0 +1,46 @@
+//#region src/analytics/types.d.ts
+/**
+ * Analytics Types
+ */
+interface AnalyticsPeriod {
+  period: "7d" | "30d" | "90d" | "1y";
+}
+interface AnalyticsSummary {
+  totalRevenue: number;
+  totalOrders: number;
+  averageOrderValue: number;
+  conversionRate?: number;
+}
+interface AnalyticsTrend {
+  date: string;
+  revenue: number;
+  orders: number;
+}
+interface TopProduct {
+  productId: string;
+  name: string;
+  quantity: number;
+  revenue: number;
+}
+interface TopCategory {
+  categoryId: string;
+  name: string;
+  quantity: number;
+  revenue: number;
+}
+interface AnalyticsDashboard {
+  summary: AnalyticsSummary;
+  trends?: AnalyticsTrend[];
+  topProducts?: TopProduct[];
+  topCategories?: TopCategory[];
+  period: string;
+  startDate: string;
+  endDate: string;
+}
+interface AnalyticsDashboardParams {
+  period?: "7d" | "30d" | "90d" | "1y";
+  branchId?: string;
+  [key: string]: unknown;
+}
+//#endregion
+export { AnalyticsDashboard, AnalyticsDashboardParams, AnalyticsPeriod, AnalyticsSummary, AnalyticsTrend, TopCategory, TopProduct };

package/dist/audit/api/audit.d.ts

@@ -0,0 +1,17 @@
+import { AuditEntry, AuditQueryParams } from "../types/index.js";
+
+//#region src/audit/api/audit.d.ts
+declare class AuditLogApi {
+  private endpoint;
+  list(params?: AuditQueryParams): Promise<{
+    success: boolean;
+    data: AuditEntry[];
+  }>;
+  getById(id: string): Promise<{
+    success: boolean;
+    data: AuditEntry;
+  }>;
+}
+declare const auditLogApi: AuditLogApi;
+//#endregion
+export { AuditLogApi, auditLogApi };

package/dist/audit/api/audit.js

@@ -0,0 +1,21 @@
+import { handleApiRequest } from "../../core/api-handler.js";
+
+//#region src/audit/api/audit.ts
+var AuditLogApi = class {
+	constructor() {
+		this.endpoint = "/api/v1/audit-logs";
+	}
+	async list(params = {}) {
+		const query = new URLSearchParams();
+		for (const [key, value] of Object.entries(params)) if (value != null && value !== "") query.set(key, String(value));
+		const qs = query.toString();
+		return handleApiRequest("GET", `${this.endpoint}${qs ? `?${qs}` : ""}`);
+	}
+	async getById(id) {
+		return handleApiRequest("GET", `${this.endpoint}/${id}`);
+	}
+};
+const auditLogApi = new AuditLogApi();
+
+//#endregion
+export { AuditLogApi, auditLogApi };

package/dist/audit/hooks/audit.d.ts

@@ -0,0 +1,17 @@
+import { AuditEntry, AuditQueryParams } from "../types/index.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+
+//#region src/audit/hooks/audit.d.ts
+declare const AUDIT_LOG_KEYS: {
+  all: readonly ["audit-logs"];
+  list: (params?: AuditQueryParams) => readonly ["audit-logs", "list", AuditQueryParams | undefined];
+  detail: (id: string) => readonly ["audit-logs", "detail", string];
+};
+declare function useAuditLogs(params?: AuditQueryParams, options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<AuditEntry[], Error>;
+declare function useAuditLogDetail(id: string, options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<AuditEntry, Error>;
+//#endregion
+export { AUDIT_LOG_KEYS, useAuditLogDetail, useAuditLogs };

package/dist/audit/hooks/audit.js

@@ -0,0 +1,38 @@
+"use client";
+
+import { auditLogApi } from "../api/audit.js";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/audit/hooks/audit.ts
+const AUDIT_LOG_KEYS = {
+	all: ["audit-logs"],
+	list: (params) => [
+		...AUDIT_LOG_KEYS.all,
+		"list",
+		params
+	],
+	detail: (id) => [
+		...AUDIT_LOG_KEYS.all,
+		"detail",
+		id
+	]
+};
+function useAuditLogs(params = {}, options) {
+	return useQuery({
+		queryKey: AUDIT_LOG_KEYS.list(params),
+		queryFn: () => auditLogApi.list(params),
+		enabled: options?.enabled ?? true,
+		select: (res) => res.data
+	});
+}
+function useAuditLogDetail(id, options) {
+	return useQuery({
+		queryKey: AUDIT_LOG_KEYS.detail(id),
+		queryFn: () => auditLogApi.getById(id),
+		enabled: (options?.enabled ?? true) && !!id,
+		select: (res) => res.data
+	});
+}
+
+//#endregion
+export { AUDIT_LOG_KEYS, useAuditLogDetail, useAuditLogs };

package/dist/audit/index.d.ts

@@ -0,0 +1,4 @@
+import { AuditAction, AuditEntry, AuditQueryParams } from "./types/index.js";
+import { AuditLogApi, auditLogApi } from "./api/audit.js";
+import { AUDIT_LOG_KEYS, useAuditLogDetail, useAuditLogs } from "./hooks/audit.js";
+export { AUDIT_LOG_KEYS, type AuditAction, type AuditEntry, AuditLogApi, type AuditQueryParams, auditLogApi, useAuditLogDetail, useAuditLogs };

package/dist/audit/index.js

@@ -0,0 +1,4 @@
+import { AuditLogApi, auditLogApi } from "./api/audit.js";
+import { AUDIT_LOG_KEYS, useAuditLogDetail, useAuditLogs } from "./hooks/audit.js";
+
+export { AUDIT_LOG_KEYS, AuditLogApi, auditLogApi, useAuditLogDetail, useAuditLogs };

package/dist/audit/types/index.d.ts

@@ -0,0 +1,32 @@
+//#region src/audit/types/index.d.ts
+type AuditAction = 'create' | 'update' | 'delete' | 'restore' | 'custom';
+interface AuditEntry {
+  id: string;
+  resource: string;
+  documentId: string;
+  action: AuditAction;
+  userId?: string;
+  organizationId?: string;
+  before?: Record<string, unknown>;
+  after?: Record<string, unknown>;
+  changes?: string[];
+  requestId?: string;
+  ipAddress?: string;
+  userAgent?: string;
+  metadata?: Record<string, unknown>;
+  timestamp: string;
+}
+interface AuditQueryParams {
+  resource?: string;
+  documentId?: string;
+  userId?: string;
+  organizationId?: string;
+  action?: string;
+  module?: string;
+  from?: string;
+  to?: string;
+  limit?: number;
+  offset?: number;
+}
+//#endregion
+export { AuditAction, AuditEntry, AuditQueryParams };

package/dist/auth/api/user-data.d.ts

@@ -0,0 +1,30 @@
+import { User, VerifyManagerData, VerifyManagerResponse } from "../types.js";
+
+//#region src/auth/api/user-data.d.ts
+interface UserSearchResponse {
+  success: boolean;
+  docs?: User[];
+  message?: string;
+}
+/** Search user by email */
+declare const getUser: (email: string, token?: string) => Promise<UserSearchResponse>;
+/** Search customer by phone */
+declare const getUserByPhone: (phone: string, token?: string) => Promise<UserSearchResponse>;
+/** Get current user profile */
+declare const getProfile: (token?: string) => Promise<unknown>;
+/** Update current user profile */
+declare const updateUser: (token: string, userId: string, data: Partial<User>) => Promise<unknown>;
+/**
+ * Verify manager credentials for discount authorization.
+ * Authenticates via Better Auth's sign-in endpoint and checks roles.
+ */
+declare const verifyManagerAuth: (data: VerifyManagerData) => Promise<VerifyManagerResponse>;
+declare const authApi: {
+  verifyManager: (data: VerifyManagerData) => Promise<VerifyManagerResponse>;
+  getUser: (email: string, token?: string) => Promise<UserSearchResponse>;
+  getUserByPhone: (phone: string, token?: string) => Promise<UserSearchResponse>;
+  getProfile: (token?: string) => Promise<unknown>;
+  updateUser: (token: string, userId: string, data: Partial<User>) => Promise<unknown>;
+};
+//#endregion
+export { authApi, getProfile, getUser, getUserByPhone, updateUser, verifyManagerAuth };

package/dist/auth/api/user-data.js

@@ -0,0 +1,70 @@
+import { handleApiRequest } from "../../core/api-handler.js";
+import { DISCOUNT_ALLOWED_ROLES } from "../types.js";
+
+//#region src/auth/api/user-data.ts
+/**
+* @classytic/commerce-sdk - User API
+*
+* User management and query APIs.
+* Authentication (sign-in, sign-up, password reset, OAuth) is handled
+* by Better Auth client directly — not through this SDK.
+*/
+/** Search user by email */
+const getUser = async (email, token) => {
+	return handleApiRequest("GET", `/api/v1/users?email=${encodeURIComponent(email)}`, { token });
+};
+/** Search customer by phone */
+const getUserByPhone = async (phone, token) => {
+	return handleApiRequest("GET", `/api/v1/customers?phone=${encodeURIComponent(phone)}`, { token });
+};
+/** Get current user profile */
+const getProfile = async (token) => {
+	return handleApiRequest("GET", "/api/v1/users/me", { token });
+};
+/** Update current user profile */
+const updateUser = async (token, userId, data) => {
+	return handleApiRequest("PATCH", "/api/v1/users/me", {
+		token,
+		body: data
+	});
+};
+/**
+* Verify manager credentials for discount authorization.
+* Authenticates via Better Auth's sign-in endpoint and checks roles.
+*/
+const verifyManagerAuth = async (data) => {
+	const { email, password, allowedRoles = DISCOUNT_ALLOWED_ROLES } = data;
+	try {
+		const user = (await handleApiRequest("POST", "/api/auth/sign-in/email", { body: {
+			email,
+			password
+		} }))?.user;
+		if (!user) return {
+			success: false,
+			message: "Invalid credentials"
+		};
+		if (!(user.role || []).some((role) => allowedRoles.includes(role))) return {
+			success: false,
+			message: "You don't have permission to authorize discounts"
+		};
+		return {
+			success: true,
+			user
+		};
+	} catch (error) {
+		return {
+			success: false,
+			message: error instanceof Error ? error.message : "Authentication failed"
+		};
+	}
+};
+const authApi = {
+	verifyManager: verifyManagerAuth,
+	getUser,
+	getUserByPhone,
+	getProfile,
+	updateUser
+};
+
+//#endregion
+export { authApi as default, getProfile, getUser, getUserByPhone, updateUser, verifyManagerAuth };

package/dist/auth/hooks/user-search.d.ts

@@ -0,0 +1,32 @@
+import { User } from "../types.js";
+
+//#region src/auth/hooks/user-search.d.ts
+interface UseUserSearchReturn {
+  /** Search for user by email or phone */
+  searchUser: (value: string, by?: "email" | "phone") => void;
+  /** Found user (first match) */
+  user: User | undefined;
+  /** No user found for the search */
+  notFound: boolean;
+  /** Search in progress */
+  isSearching: boolean;
+  /** Search error */
+  error: Error | null;
+  /** Reset search state */
+  reset: () => void;
+}
+/**
+ * Hook for searching users by email or phone number.
+ * Auth token is provided automatically via SDK configuration.
+ *
+ * @example
+ * ```tsx
+ * const { searchUser, user, isSearching, notFound } = useUserSearch();
+ *
+ * searchUser("user@example.com");
+ * searchUser("01712345678", "phone");
+ * ```
+ */
+declare function useUserSearch(): UseUserSearchReturn;
+//#endregion
+export { useUserSearch };

package/dist/auth/hooks/user-search.js

@@ -0,0 +1,51 @@
+"use client";
+
+import { getUser, getUserByPhone } from "../api/user-data.js";
+import { useMutation } from "@tanstack/react-query";
+
+//#region src/auth/hooks/user-search.ts
+/**
+* User Search Hook
+*
+* React hook for searching users by email or phone number.
+* Bearer token is sent automatically via SDK's configured auth.
+*/
+/**
+* Hook for searching users by email or phone number.
+* Auth token is provided automatically via SDK configuration.
+*
+* @example
+* ```tsx
+* const { searchUser, user, isSearching, notFound } = useUserSearch();
+*
+* searchUser("user@example.com");
+* searchUser("01712345678", "phone");
+* ```
+*/
+function useUserSearch() {
+	const searchUserMutation = useMutation({
+		mutationFn: async ({ value, by = "email" }) => {
+			if (by === "phone") return getUserByPhone(value);
+			return getUser(value);
+		},
+		onError: (error) => {
+			console.error("User search error:", error);
+		}
+	});
+	return {
+		searchUser: (value, by = "email") => {
+			searchUserMutation.mutate({
+				value,
+				by
+			});
+		},
+		user: searchUserMutation.data?.docs?.[0],
+		notFound: Array.isArray(searchUserMutation.data?.docs) && searchUserMutation.data.docs.length === 0,
+		isSearching: searchUserMutation.isPending,
+		error: searchUserMutation.error,
+		reset: searchUserMutation.reset
+	};
+}
+
+//#endregion
+export { useUserSearch };

package/dist/auth/index.d.ts

@@ -1,39 +1,4 @@
-import { i as User } from '../user-data-DdLjAGwO.js';
-export { j as AuthApiResponse, A as AuthResponse, D as DISCOUNT_ALLOWED_ROLES, F as ForgotPasswordData, L as LoginCredentials, O as OAuthLoginData, R as RefreshResponse, n as RefreshTokenData, k as RegisterData, m as ResetPasswordData, U as UserRole, h as UserRoleType, V as VerifyManagerData, p as VerifyManagerResponse, a as authApi, a as authApiDefault, d as createUser, f as forgetPassApi, e as getProfile, g as getUser, c as getUserByPhone, l as loginApi, o as oauthLoginApi, r as registerApi, b as resetPassApi, t as tokenRefreshApi, u as updateUser, v as verifyManagerAuth } from '../user-data-DdLjAGwO.js';
-
-interface UseUserSearchOptions {
-    token: string;
-}
-interface UseUserSearchReturn {
-    /** Search for user by email or phone */
-    searchUser: (value: string, by?: "email" | "phone") => void;
-    /** Found user (first match) */
-    user: User | undefined;
-    /** No user found for the search */
-    notFound: boolean;
-    /** Search in progress */
-    isSearching: boolean;
-    /** Search error */
-    error: Error | null;
-    /** Reset search state */
-    reset: () => void;
-}
-/**
- * Hook for searching users by email or phone number
- *
- * @param options.token - Auth token (required)
- *
- * @example
- * ```tsx
- * const { searchUser, user, isSearching, notFound } = useUserSearch({ token });
- *
- * // Search by email
- * searchUser("user@example.com");
- *
- * // Search by phone
- * searchUser("01712345678", "phone");
- * ```
- */
-declare function useUserSearch({ token }: UseUserSearchOptions): UseUserSearchReturn;
-
-export { User, useUserSearch };
+import { DISCOUNT_ALLOWED_ROLES, User, UserRole, UserRoleType, VerifyManagerData, VerifyManagerResponse } from "./types.js";
+import { authApi, getProfile, getUser, getUserByPhone, updateUser, verifyManagerAuth } from "./api/user-data.js";
+import { useUserSearch } from "./hooks/user-search.js";
+export { DISCOUNT_ALLOWED_ROLES, type User, UserRole, type UserRoleType, type VerifyManagerData, type VerifyManagerResponse, authApi, authApi as authApiDefault, getProfile, getUser, getUserByPhone, updateUser, useUserSearch, verifyManagerAuth };

package/dist/auth/index.js

@@ -1,5 +1,5 @@
-"use client";
-export { DISCOUNT_ALLOWED_ROLES, UserRole, authApi, user_data_default as authApiDefault, createUser, forgetPassApi, getProfile, getUser, getUserByPhone, loginApi, oauthLoginApi, registerApi, resetPassApi, tokenRefreshApi, updateUser, useUserSearch, verifyManagerAuth } from '../chunk-W22WB3WZ.js';
-import '../chunk-IHCBBLLW.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+import { DISCOUNT_ALLOWED_ROLES, UserRole } from "./types.js";
+import authApi, { getProfile, getUser, getUserByPhone, updateUser, verifyManagerAuth } from "./api/user-data.js";
+import { useUserSearch } from "./hooks/user-search.js";
+
+export { DISCOUNT_ALLOWED_ROLES, UserRole, authApi, authApi as authApiDefault, getProfile, getUser, getUserByPhone, updateUser, useUserSearch, verifyManagerAuth };

package/dist/auth/types.d.ts

@@ -0,0 +1,46 @@
+//#region src/auth/types.d.ts
+/**
+ * @classytic/commerce-sdk - Auth Types
+ *
+ * Type definitions for user management.
+ * Authentication (sign-in, sign-up, password reset) is handled by Better Auth client directly.
+ */
+declare const UserRole: {
+  readonly SUPER_ADMIN: "superadmin";
+  readonly ADMIN: "admin";
+  readonly CUSTOMER: "user";
+  readonly FINANCE_ADMIN: "finance-admin";
+  readonly FINANCE_MANAGER: "finance-manager";
+  readonly STORE_MANAGER: "store-manager";
+  readonly STORE_STAFF: "store-staff";
+  readonly WAREHOUSE_ADMIN: "warehouse-admin";
+  readonly WAREHOUSE_STAFF: "warehouse-staff";
+};
+type UserRoleType = (typeof UserRole)[keyof typeof UserRole];
+interface User {
+  id: string;
+  _id?: string;
+  name: string;
+  email: string;
+  phone?: string;
+  role?: UserRoleType[];
+  image?: string;
+  isActive?: boolean;
+  emailVerified?: boolean;
+  createdAt?: string;
+  updatedAt?: string;
+}
+interface VerifyManagerData {
+  email: string;
+  password: string;
+  allowedRoles?: UserRoleType[];
+}
+interface VerifyManagerResponse {
+  success: boolean;
+  user?: User;
+  message?: string;
+}
+/** Allowed roles for discount authorization */
+declare const DISCOUNT_ALLOWED_ROLES: UserRoleType[];
+//#endregion
+export { DISCOUNT_ALLOWED_ROLES, User, UserRole, UserRoleType, VerifyManagerData, VerifyManagerResponse };

package/dist/auth/types.js

@@ -0,0 +1,27 @@
+//#region src/auth/types.ts
+/**
+* @classytic/commerce-sdk - Auth Types
+*
+* Type definitions for user management.
+* Authentication (sign-in, sign-up, password reset) is handled by Better Auth client directly.
+*/
+const UserRole = {
+	SUPER_ADMIN: "superadmin",
+	ADMIN: "admin",
+	CUSTOMER: "user",
+	FINANCE_ADMIN: "finance-admin",
+	FINANCE_MANAGER: "finance-manager",
+	STORE_MANAGER: "store-manager",
+	STORE_STAFF: "store-staff",
+	WAREHOUSE_ADMIN: "warehouse-admin",
+	WAREHOUSE_STAFF: "warehouse-staff"
+};
+/** Allowed roles for discount authorization */
+const DISCOUNT_ALLOWED_ROLES = [
+	"superadmin",
+	"admin",
+	"store-manager"
+];
+
+//#endregion
+export { DISCOUNT_ALLOWED_ROLES, UserRole };

package/dist/catalog/api/category.d.ts

@@ -0,0 +1,97 @@
+import { ApiResponse, BaseApi } from "../../core/api-factory.js";
+import { Category, CategoryTreeResponse, CreateCategoryPayload, UpdateCategoryPayload } from "../types/category.js";
+//#region src/catalog/api/category.d.ts
+type FetchOptions = {
+  cache?: RequestCache;
+  revalidate?: number;
+  tags?: string[];
+};
+/**
+ * Category API Client
+ * Extends BaseApi with category-specific endpoints
+ */
+declare class CategoryApi extends BaseApi<Category, CreateCategoryPayload, UpdateCategoryPayload> {
+  constructor(config?: {});
+  /**
+   * Get category tree (nested structure)
+   * GET /categories/tree
+   *
+   * **This is the main endpoint - FE should cache this and derive everything else from it.**
+   *
+   * Returns nested tree structure with children. Use helper functions to flatten, search, or extract children.
+   *
+   * @param token - Auth token (optional, public endpoint)
+   * @param options - Additional fetch options
+   * @returns Nested category tree
+   *
+   * @example
+   * ```typescript
+   * const { data } = await categoryApi.getTree({ token: null });
+   * // data = [{ slug: "clothing", name: "Clothing", children: [...] }]
+   * ```
+   */
+  getTree({
+    token,
+    options
+  }?: {
+    token?: string | null;
+    options?: FetchOptions;
+  }): Promise<CategoryTreeResponse>;
+  /**
+   * Get category by slug
+   * GET /categories/slug/:slug
+   *
+   * For URL resolution when you need full category details.
+   *
+   * @param token - Auth token (optional, public endpoint)
+   * @param slug - Category slug (e.g., "electronics", "t-shirts")
+   * @param options - Additional fetch options
+   * @returns Category object
+   *
+   * @example
+   * ```typescript
+   * const { data } = await categoryApi.getBySlug({
+   *   token: null,
+   *   slug: 'electronics'
+   * });
+   * ```
+   */
+  getBySlug({
+    token,
+    slug,
+    options
+  }: {
+    token?: string | null;
+    slug: string;
+    options?: FetchOptions;
+  }): Promise<ApiResponse<Category>>;
+  /**
+   * Sync product counts for all categories
+   * POST /categories/sync-product-count
+   *
+   * Recalculates `productCount` for all categories based on current products.
+   * Use when manual data fixes or migrations may have desynced counts.
+   *
+   * @param token - Auth token (admin or inventory staff required)
+   * @param options - Additional fetch options
+   * @returns Number of categories updated
+   *
+   * @example
+   * ```typescript
+   * const { data } = await categoryApi.syncProductCount({ token });
+   * // data = { updated: 42 }
+   * ```
+   */
+  syncProductCount({
+    token,
+    options
+  }: {
+    token: string;
+    options?: FetchOptions;
+  }): Promise<ApiResponse<{
+    updated: number;
+  }>>;
+}
+declare const categoryApi: CategoryApi;
+//#endregion
+export { CategoryApi, categoryApi };