@apptimate/core-lib 4.1.0 → 4.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apptimate/core-lib",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "publishConfig": {

package/src/api-services/inventory/brands.client.ts

@@ -0,0 +1,34 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/brands`;
+
+export async function getBrands(params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const queryParams = new URLSearchParams(params as Record<string, string>).toString();
+  const response = await sendRequest({ url: `${BASE}${queryParams ? `?${queryParams}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getBrand(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function createBrand(data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: BASE, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateBrand(id: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteBrand(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}
+
+export async function lookupBrands(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/lookup`, method: "GET" });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/inventory/categories.client.ts

@@ -0,0 +1,39 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/categories`;
+
+export async function getCategories(params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const queryParams = new URLSearchParams(params as Record<string, string>).toString();
+  const response = await sendRequest({ url: `${BASE}${queryParams ? `?${queryParams}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getCategoryTree(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/tree`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getCategory(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function createCategory(data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: BASE, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateCategory(id: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteCategory(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}
+
+export async function lookupCategories(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/lookup`, method: "GET" });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/inventory/inventory-settings.client.ts

@@ -0,0 +1,24 @@
+"use client";
+
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+const BASE_URL = process.env.NEXT_PUBLIC_API_URL || "http://localhost:8000";
+
+export async function getInventorySettings(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/settings`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getInventorySetting(key: string): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/settings/${key}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function saveInventorySetting(key: string, value: any): Promise<IApiResponse> {
+  const response = await sendRequest({ 
+    url: `${BASE_URL}/api/inventory/settings/${key}`, 
+    method: "PUT", 
+    data: { value } 
+  });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/inventory/items.client.ts

@@ -0,0 +1,113 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/items`;
+
+export async function getItems(params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const queryParams = new URLSearchParams(params as Record<string, string>).toString();
+  const response = await sendRequest({ url: `${BASE}${queryParams ? `?${queryParams}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getItem(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getItemCategoryCount(categoryId: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/category-count?category_id=${categoryId}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function createItem(data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: BASE, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateItem(id: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteItem(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}
+
+export async function lookupItems(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/lookup`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function addVariant(itemId: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${itemId}/variants`, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateVariant(itemId: number, variantId: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${itemId}/variants/${variantId}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteVariant(itemId: number, variantId: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${itemId}/variants/${variantId}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}
+
+export async function pickerSearchItems(
+  search: string,
+  warehouseId?: number,
+  limit?: number
+): Promise<IApiResponse> {
+  const params = new URLSearchParams();
+  if (search) params.append("search", search);
+  if (warehouseId) params.append("warehouse_id", warehouseId.toString());
+  if (limit) params.append("limit", limit.toString());
+  
+  const response = await sendRequest({ url: `${BASE}/picker-search?${params.toString()}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+// ── Image Management ──
+
+export async function getItemImages(itemId: number, variantId?: number, batchId?: number): Promise<IApiResponse> {
+  const params = new URLSearchParams();
+  if (variantId) params.append("variant_id", String(variantId));
+  if (batchId) params.append("batch_id", String(batchId));
+  const qs = params.toString();
+  const response = await sendRequest({ url: `${BASE}/${itemId}/images${qs ? `?${qs}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function uploadItemImages(
+  itemId: number,
+  files: File[],
+  variantId?: number,
+  batchId?: number
+): Promise<IApiResponse> {
+  const formData = new FormData();
+  files.forEach((file) => formData.append("images[]", file));
+  if (variantId) formData.append("variant_id", String(variantId));
+  if (batchId) formData.append("batch_id", String(batchId));
+
+  const response = await sendRequest({
+    url: `${BASE}/${itemId}/images`,
+    method: "POST",
+    data: formData,
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteItemImage(itemId: number, imageId: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${itemId}/images/${imageId}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}
+
+export async function setPrimaryImage(itemId: number, imageId: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${itemId}/images/${imageId}/primary`, method: "PATCH" });
+  return response.responseData as IApiResponse;
+}
+
+export async function reorderItemImages(itemId: number, imageIds: number[]): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${itemId}/images/reorder`, method: "POST", data: { image_ids: imageIds } });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/inventory/parties.client.ts

@@ -0,0 +1,66 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/parties`;
+
+export async function getParties(params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const queryParams = new URLSearchParams(params as Record<string, string>).toString();
+  const url = `${BASE}${queryParams ? `?${queryParams}` : ""}`;
+
+  const response = await sendRequest({
+    url,
+    method: "GET",
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function getParty(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${BASE}/${id}`,
+    method: "GET",
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function createParty(data: any): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: BASE,
+    method: "POST",
+    data,
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateParty(id: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${BASE}/${id}`,
+    method: "PUT",
+    data,
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteParty(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${BASE}/${id}`,
+    method: "DELETE",
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function togglePartyStatus(id: number, status: string): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${BASE}/${id}`,
+    method: "PUT",
+    data: { status },
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function lookupParties(type?: string): Promise<IApiResponse> {
+  const queryParams = type ? `?type=${type}` : "";
+  const response = await sendRequest({
+    url: `${BASE}/lookup${queryParams}`,
+    method: "GET",
+  });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/inventory/transaction.client.ts

@@ -0,0 +1,51 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+const INV_BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory`;
+const FIN_BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/finance`;
+
+// ── Inventory: Transaction Lookup ──
+
+export async function transactionLookup(params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${INV_BASE}/items/transaction-lookup`, method: "GET", params });
+  return response.responseData as IApiResponse;
+}
+
+export async function getItemBatches(itemId: number, params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${INV_BASE}/items/${itemId}/batches`, method: "GET", params });
+  return response.responseData as IApiResponse;
+}
+
+export async function bulkStockCheck(data: {
+  warehouse_id: number;
+  lines: Array<{ item_id: number; variant_id?: number | null; batch_id?: number | null; quantity: number }>;
+}): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${INV_BASE}/stock/check`, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+// ── Finance: Payment Modes ──
+
+export async function getPaymentModes(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${FIN_BASE}/payment-modes`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getBankAccountsLookup(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${FIN_BASE}/bank-accounts/lookup`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+// ── Finance: Warehouses Lookup ──
+
+export async function getWarehousesLookup(allOrgs: boolean = false): Promise<IApiResponse> {
+  const url = `${process.env.NEXT_PUBLIC_API_URL}/api/warehouses/lookup${allOrgs ? '?all_orgs=1' : ''}`;
+  const response = await sendRequest({ url, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+// ── Core: Parties Lookup ──
+
+export async function getPartiesLookup(params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/parties/lookup`, method: "GET", params });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/inventory/uom-group.client.ts

@@ -0,0 +1,24 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/uom-groups`;
+
+export async function getUomGroups(params: Record<string, string | number | boolean> = {}): Promise<IApiResponse> {
+  const queryParams = new URLSearchParams(params as Record<string, string>).toString();
+  const response = await sendRequest({ url: `${BASE}${queryParams ? `?${queryParams}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function createUomGroup(data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: BASE, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateUomGroup(id: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteUomGroup(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/inventory/uom.client.ts

@@ -0,0 +1,29 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/uom`;
+
+export async function getUoms(params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const queryParams = new URLSearchParams(params as Record<string, string>).toString();
+  const response = await sendRequest({ url: `${BASE}${queryParams ? `?${queryParams}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function createUom(data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: BASE, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateUom(id: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteUom(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}
+
+export async function lookupUoms(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/lookup`, method: "GET" });
+  return response.responseData as IApiResponse;
+}

package/src/constants/menus.ts

@@ -88,9 +88,10 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
 
   { key: 'inventory__stock', label: 'Stock Overview', path: '/inventory/stock', module: 'Inventory', defaultGroup: 'Stock', permission: null },
   { key: 'inventory__ledger', label: 'Stock Movements', path: '/inventory/ledger', module: 'Inventory', defaultGroup: 'Stock', permission: null },
+  { key: 'inventory__opening_stock', label: 'Opening Stock', path: '/inventory/opening-stocks', module: 'Inventory', defaultGroup: 'Operations', permission: 'inventory.opening_stock.view' },
   { key: 'inventory__adjustments', label: 'Adjustments', path: '/inventory/adjustments', module: 'Inventory', defaultGroup: 'Operations', permission: null },
   { key: 'inventory__transfers', label: 'Transfers', path: '/inventory/transfers', module: 'Inventory', defaultGroup: 'Operations', permission: null },
-  { key: 'inventory__serials', label: 'Serial Numbers', path: '/inventory/serials', module: 'Inventory', defaultGroup: 'Operations', permission: null },
+  { key: 'inventory__serials', label: 'Serial Numbers', path: '/inventory/serials', module: 'Inventory', defaultGroup: 'Stock', permission: null },
 
   // ── Sales Module ──
   { key: 'sales__price_lists', label: 'Price Lists', path: '/sales/price-lists', module: 'Sales', defaultGroup: 'Master Data', permission: null },
@@ -317,7 +318,7 @@ export const MENU_PRESETS: MenuPreset[] = [
         secondaryItems: [
           'inventory__items', 'inventory__categories', 'inventory__brands', 'inventory__uom',
           'inventory__stock', 'inventory__ledger',
-          'inventory__adjustments', 'inventory__transfers', 'inventory__serials',
+          'inventory__opening_stock', 'inventory__adjustments', 'inventory__transfers', 'inventory__serials',
         ],
       },
       {

package/src/index.ts

@@ -1,3 +1,12 @@
 // Default entry point — client-safe (no 'use server' modules)
 // For server components/actions, import from '@apptimate/core-lib/src/server'
-export * from './client';
+export * from './client';
+// Inventory API Services
+export * from './api-services/inventory/inventory-settings.client';
+export * from './api-services/inventory/items.client';
+export * from './api-services/inventory/categories.client';
+export * from './api-services/inventory/brands.client';
+export * from './api-services/inventory/uom.client';
+export * from './api-services/inventory/uom-group.client';
+export * from './api-services/inventory/parties.client';
+export * from './api-services/inventory/transaction.client';