@apptimate/core-lib 6.8.0 → 7.0.0

package/package.json

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

package/src/api-services/entity-extensions.client.ts

@@ -0,0 +1,130 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+/**
+ * Normalise a backend response that may come in either of two shapes:
+ *  • Standard: { is_success, result, message }  (ResponseService)
+ *  • Raw:      { data, message }                 (Extension controllers)
+ * Returns a consistent { is_success, result, message } object.
+ */
+function normalise(raw: any, okStatus: boolean): IApiResponse {
+  if (typeof raw?.is_success === "boolean") return raw; // already standard
+  return {
+    is_success: okStatus,
+    result: raw?.data ?? raw,
+    message: raw?.message ?? "",
+    system_code: raw?.system_code ?? "",
+  } as IApiResponse;
+}
+
+// ── Activity Logs (scoped to an entity) ─────────────────────────────────────
+export async function getActivityLogsForEntity(entityId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/activity-logs/entity/${entityId}`, method: "GET" });
+  return normalise(res.responseData, res.ok);
+}
+
+// ── Notes ───────────────────────────────────────────────────────────────────
+export async function getNotesForEntity(entityId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/notes`, method: "GET" });
+  return normalise(res.responseData, res.ok);
+}
+export async function addNote(entityId: number, note: string): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/notes`, method: "POST", data: { note } });
+  return normalise(res.responseData, res.ok);
+}
+export async function updateNote(noteId: number, note: string): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entity-notes/${noteId}`, method: "PUT", data: { note } });
+  return normalise(res.responseData, res.ok);
+}
+export async function deleteNote(noteId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entity-notes/${noteId}`, method: "DELETE" });
+  return normalise(res.responseData, res.ok);
+}
+
+// ── Comments ────────────────────────────────────────────────────────────────
+export async function getCommentsForEntity(entityId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/comments`, method: "GET" });
+  return normalise(res.responseData, res.ok);
+}
+export async function addComment(entityId: number, comment: string): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/comments`, method: "POST", data: { comment } });
+  return normalise(res.responseData, res.ok);
+}
+export async function updateComment(commentId: number, comment: string): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entity-comments/${commentId}`, method: "PUT", data: { comment } });
+  return normalise(res.responseData, res.ok);
+}
+export async function deleteComment(commentId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entity-comments/${commentId}`, method: "DELETE" });
+  return normalise(res.responseData, res.ok);
+}
+
+// ── Tags ────────────────────────────────────────────────────────────────────
+export async function getTagsForEntity(entityId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/tags`, method: "GET" });
+  return normalise(res.responseData, res.ok);
+}
+export async function attachTag(entityId: number, tagId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/tags`, method: "POST", data: { tag_id: tagId } });
+  return normalise(res.responseData, res.ok);
+}
+export async function detachTag(entityId: number, tagId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/tags/${tagId}`, method: "DELETE" });
+  return normalise(res.responseData, res.ok);
+}
+export async function getAllTags(): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/tags`, method: "GET" });
+  return normalise(res.responseData, res.ok);
+}
+export async function createTag(name: string): Promise<IApiResponse> {
+  const code = name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/tags`, method: "POST", data: { name, code, color: "#6366f1" } });
+  return normalise(res.responseData, res.ok);
+}
+
+// ── Approvals ────────────────────────────────────────────────────────────────
+export async function getApprovalsForEntity(entityId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/approvals/entity/${entityId}`, method: "GET" });
+  return normalise(res.responseData, res.ok);
+}
+export async function requestApproval(entityId: number, approverIds: number[], approvalType: string = 'general'): Promise<IApiResponse> {
+  const res = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/approvals`,
+    method: "POST",
+    data: { entity_id: entityId, approver_ids: approverIds, approval_type: approvalType }
+  });
+  return normalise(res.responseData, res.ok);
+}
+export async function approveStep(stepId: number, remarks?: string): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/approval-steps/${stepId}/approve`, method: "POST", data: { remarks } });
+  return normalise(res.responseData, res.ok);
+}
+export async function rejectStep(stepId: number, remarks?: string): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/approval-steps/${stepId}/reject`, method: "POST", data: { remarks } });
+  return normalise(res.responseData, res.ok);
+}
+export async function sendBackStep(stepId: number, remarks?: string): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/approval-steps/${stepId}/send-back`, method: "POST", data: { remarks } });
+  return normalise(res.responseData, res.ok);
+}
+export async function requestApprovalFromWorkflow(entityId: number, approvalType: string): Promise<IApiResponse> {
+  const res = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/approvals/workflow`,
+    method: "POST",
+    data: { entity_id: entityId, approval_type: approvalType }
+  });
+  return normalise(res.responseData, res.ok);
+}
+
+// ── Properties (unstructured JSON) ──────────────────────────────────────────
+export async function getEntityProperties(entityId: number): Promise<IApiResponse> {
+  const res = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/properties`, method: "GET" });
+  return normalise(res.responseData, res.ok);
+}
+export async function updateEntityProperties(entityId: number, properties: any): Promise<IApiResponse> {
+  const res = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/entities/${entityId}/properties`,
+    method: "PUT",
+    data: { properties }
+  });
+  return normalise(res.responseData, res.ok);
+}

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

@@ -14,8 +14,9 @@ export async function getItem(id: number): Promise<IApiResponse> {
   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" });
+export async function getItemCount(categoryId?: number): Promise<IApiResponse> {
+  const url = categoryId ? `${BASE}/count?category_id=${categoryId}` : `${BASE}/count`;
+  const response = await sendRequest({ url, method: "GET" });
   return response.responseData as IApiResponse;
 }
 

package/src/api-services/inventory/sku-components.client.ts

@@ -0,0 +1,106 @@
+"use client";
+
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
+
+const BASE_URL = process.env.NEXT_PUBLIC_API_URL || "http://localhost:8000";
+
+// ── SKU Component Fields ──
+
+export async function getSkuComponentFields(params?: { search?: string; status?: string; per_page?: number; page?: number }): Promise<IApiResponse> {
+  const searchParams = new URLSearchParams();
+  if (params?.search) searchParams.set("search", params.search);
+  if (params?.status) searchParams.set("status", params.status);
+  if (params?.per_page) searchParams.set("per_page", String(params.per_page));
+  if (params?.page) searchParams.set("page", String(params.page));
+  const qs = searchParams.toString();
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-fields${qs ? `?${qs}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getSkuComponentField(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-fields/${id}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function createSkuComponentField(data: {
+  name: string;
+  code?: string;
+  description?: string;
+  applicable_to?: string;
+  options: { label: string; code: string; sort_order?: number }[];
+}): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-fields`, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateSkuComponentField(id: number, data: {
+  name?: string;
+  description?: string;
+  status?: string;
+  applicable_to?: string;
+  options?: { id?: number; label: string; code: string; sort_order?: number }[];
+}): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-fields/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteSkuComponentField(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-fields/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}
+
+export async function lookupSkuComponentFields(params?: { applicable_to?: string }): Promise<IApiResponse> {
+  const searchParams = new URLSearchParams();
+  if (params?.applicable_to) searchParams.set("applicable_to", params.applicable_to);
+  const qs = searchParams.toString();
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-fields/lookup${qs ? `?${qs}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+// ── SKU Component Templates ──
+
+export async function getSkuComponentTemplates(params?: { search?: string; status?: string; applicable_to?: string; per_page?: number; page?: number }): Promise<IApiResponse> {
+  const searchParams = new URLSearchParams();
+  if (params?.search) searchParams.set("search", params.search);
+  if (params?.status) searchParams.set("status", params.status);
+  if (params?.applicable_to) searchParams.set("applicable_to", params.applicable_to);
+  if (params?.per_page) searchParams.set("per_page", String(params.per_page));
+  if (params?.page) searchParams.set("page", String(params.page));
+  const qs = searchParams.toString();
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-templates${qs ? `?${qs}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function getSkuComponentTemplate(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-templates/${id}`, method: "GET" });
+  return response.responseData as IApiResponse;
+}
+
+export async function createSkuComponentTemplate(data: {
+  name: string;
+  description?: string;
+  config: any;
+  is_default?: boolean;
+  applicable_to?: string;
+}): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-templates`, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateSkuComponentTemplate(id: number, data: {
+  name?: string;
+  description?: string;
+  config?: any;
+  is_default?: boolean;
+  status?: string;
+  applicable_to?: string;
+}): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-templates/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteSkuComponentTemplate(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/api/inventory/sku-templates/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/users.client.ts

@@ -0,0 +1,64 @@
+import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+
+export async function getUsers(params: Record<string, string | number> = {}): Promise<IApiResponse> {
+  const queryParams = new URLSearchParams(params as Record<string, string>).toString();
+  const url = `${process.env.NEXT_PUBLIC_API_URL}/api/users${queryParams ? `?${queryParams}` : ""}`;
+  
+  const response = await sendRequest({
+    url,
+    method: "GET",
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function createUser(data: any): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/users`,
+    method: "POST",
+    data,
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateUser(id: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/users/${id}`,
+    method: "PUT",
+    data,
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function deleteUser(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/users/${id}`,
+    method: "DELETE",
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function deactivateUser(id: number, status: string): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/users/${id}`,
+    method: "PUT",
+    data: { status }
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function getUserDetails(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/users/${id}`,
+    method: "GET",
+  });
+  return response.responseData as IApiResponse;
+}
+
+export async function getUserPermissions(id: number): Promise<IApiResponse> {
+  const response = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/users/${id}/permissions`,
+    method: "GET",
+  });
+  return response.responseData as IApiResponse;
+}
+

package/src/constants/menus.ts

@@ -114,6 +114,7 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
   { 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: 'Stock', permission: null },
   { key: 'inventory__settings', label: 'Settings', path: '/inventory/settings', module: 'Inventory', defaultGroup: 'Settings', permission: 'inventory_setting.view' },
+  { key: 'inventory__sku_components', label: 'SKU Configuration', path: '/inventory/settings/sku-components', module: 'Inventory', defaultGroup: 'Settings', permission: 'inventory_setting.view' },
 
   // ── Sales Module ──
   { key: 'sales__price_lists', label: 'Price Lists', path: '/sales/price-lists', module: 'Sales', defaultGroup: 'Master Data', permission: null },
@@ -160,13 +161,14 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
   { key: 'jewelry__items', label: 'Jewelry Items', path: '/jewelry/items', module: 'Jewelry', defaultGroup: 'Catalog', permission: 'jewelry.items.view' },
 
   { key: 'jewelry__categories', label: 'Categories', path: '/jewelry/categories', module: 'Jewelry', defaultGroup: 'Catalog', permission: 'jewelry.categories.view' },
+  { key: 'jewelry__services_master', label: 'Services', path: '/jewelry/services', module: 'Jewelry', defaultGroup: 'Catalog', permission: 'jewelry.services.view' },
   { key: 'jewelry__material_types', label: 'Material Types', path: '/jewelry/material-types', module: 'Jewelry', defaultGroup: 'Master Data', permission: 'jewelry.material_types.view' },
   { key: 'jewelry__purities', label: 'Purities', path: '/jewelry/purities', module: 'Jewelry', defaultGroup: 'Master Data', permission: 'jewelry.purities.view' },
   { key: 'jewelry__metal_rates', label: 'Metal Rates', path: '/jewelry/metal-rates', module: 'Jewelry', defaultGroup: 'Master Data', permission: 'jewelry.metal_rates.view' },
   { key: 'jewelry__purchase_orders', label: 'Purchase Orders', path: '/jewelry/procurement/orders', module: 'Jewelry', defaultGroup: 'Procurement', permission: 'jewelry.purchase_orders.view' },
   { key: 'jewelry__grn', label: 'Goods Receipt', path: '/jewelry/procurement/grn', module: 'Jewelry', defaultGroup: 'Procurement', permission: 'jewelry.grn.view' },
   { key: 'jewelry__custom_orders', label: 'Custom Orders', path: '/jewelry/custom-orders', module: 'Jewelry', defaultGroup: 'Procurement', permission: 'jewelry.custom_orders.view' },
-  { key: 'jewelry__service_orders', label: 'Service Orders', path: '/jewelry/service-orders', module: 'Jewelry', defaultGroup: 'Procurement', permission: 'jewelry.services.view' },
+  { key: 'jewelry__service_orders', label: 'Service Orders', path: '/jewelry/service-orders', module: 'Jewelry', defaultGroup: 'Procurement', permission: 'jewelry.service_orders.view' },
   { key: 'jewelry__opening_stock', label: 'Opening Stock', path: '/jewelry/procurement/opening_stock', module: 'Jewelry', defaultGroup: 'Procurement', permission: 'jewelry.opening_stock.view' },
   { key: 'jewelry__transformations', label: 'Transformations', path: '/jewelry/procurement/transformations', module: 'Jewelry', defaultGroup: 'Procurement', permission: 'jewelry.transformations.view' },
   { key: 'jewelry__old_gold_purchases', label: 'Old Material Purchases', path: '/jewelry/old-gold-purchases', module: 'Jewelry', defaultGroup: 'Buying', permission: 'jewelry.old_gold_purchases.view' },
@@ -229,6 +231,7 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
   { key: 'money_exchange__denominations', label: 'Denomination', path: '/money-exchange/denominations', module: 'Money Exchange', defaultGroup: 'Config', permission: 'money_exchange.denominations.view' },
   { key: 'money_exchange__till_thresholds', label: 'Till Thresholds', path: '/money-exchange/till-thresholds', module: 'Money Exchange', defaultGroup: 'Config', permission: 'money_exchange.till_thresholds.view' },
   { key: 'money_exchange__cross_currency', label: 'Margin Rate', path: '/money-exchange/cross-currency', module: 'Money Exchange', defaultGroup: 'Config', permission: 'money_exchange.cross_currency.view' },
+  { key: 'money_exchange__currency_adjustments', label: 'Currency Adjustments', path: '/money-exchange/currency-adjustments', module: 'Money Exchange', defaultGroup: 'Config', permission: 'money_exchange.currency_adjustments.view' },
 
   // ── Reports Module (Admin/General) ──
   { key: 'reports__jewelry', label: 'Jewelry', path: '/reports/jewelry', module: 'Reporting', defaultGroup: 'Dashboards', permission: null },
@@ -415,7 +418,7 @@ export const MENU_PRESETS: MenuPreset[] = [
           'inventory__items', 'inventory__categories', 'inventory__brands', 'inventory__uom',
           'inventory__stock', 'inventory__ledger',
           'inventory__opening_stock', 'inventory__adjustments', 'inventory__transfers', 'inventory__serials',
-          'inventory__settings'
+          'inventory__settings', 'inventory__sku_components'
         ],
       },
       {
@@ -456,7 +459,7 @@ export const MENU_PRESETS: MenuPreset[] = [
         label: 'Jewelry',
         iconName: 'Gem',
         secondaryItems: [
-          'jewelry__items', 'jewelry__categories',
+          'jewelry__items', 'jewelry__categories', 'jewelry__services_master',
           'jewelry__material_types', 'jewelry__purities', 'jewelry__metal_rates',
           'jewelry__purchase_orders', 'jewelry__grn', 'jewelry__opening_stock', 'jewelry__custom_orders', 'jewelry__service_orders', 'jewelry__transformations',
           'jewelry__old_gold_purchases',
@@ -502,6 +505,7 @@ export const MENU_PRESETS: MenuPreset[] = [
           'money_exchange__denominations',
           'money_exchange__till_thresholds',
           'money_exchange__cross_currency',
+          'money_exchange__currency_adjustments',
         ],
       },
       {

package/src/index.ts

@@ -3,6 +3,7 @@
 export * from './client';
 // Inventory API Services
 export * from './api-services/inventory/inventory-settings.client';
+export * from './api-services/inventory/sku-components.client';
 export * from './api-services/inventory/items.client';
 export * from './api-services/inventory/categories.client';
 export * from './api-services/inventory/brands.client';
@@ -18,3 +19,5 @@ export * from './api-services/hr-employees.client';
 export * from './api-services/email-services.client';
 export * from './api-services/email-templates.client';
 export * from "./api-services/finance-shared.client";
+export * from './api-services/users.client';
+export * from './api-services/entity-extensions.client';