@devx-retailos/cms 0.0.1 → 0.1.0

package/src/api/admin/retailos/cms/handovers/[id]/__tests__/route.test.ts

@@ -3,7 +3,7 @@ import { GET } from "../route"
 
 function makeService() {
   return {
-    retrieveCmsHandover: vi.fn(),
+    retrieveRetailosCmsHandover: vi.fn(),
   }
 }
 
@@ -31,20 +31,20 @@ describe("GET /handovers/[id]", () => {
   it("returns handover when found", async () => {
     const service = makeService()
     const handover = { id: "cmsh_1", store_id: "s1", handover_amount: 500 }
-    service.retrieveCmsHandover.mockResolvedValue(handover)
+    service.retrieveRetailosCmsHandover.mockResolvedValue(handover)
     const req = makeReq({ id: "cmsh_1" }, service)
     const res = makeRes()
 
     await GET(req as any, res as any)
 
-    expect(service.retrieveCmsHandover).toHaveBeenCalledWith("cmsh_1")
+    expect(service.retrieveRetailosCmsHandover).toHaveBeenCalledWith("cmsh_1")
     expect(res.status).toHaveBeenCalledWith(200)
     expect(res.json).toHaveBeenCalledWith({ handover })
   })
 
   it("returns 404 when handover is null", async () => {
     const service = makeService()
-    service.retrieveCmsHandover.mockResolvedValue(null)
+    service.retrieveRetailosCmsHandover.mockResolvedValue(null)
     const req = makeReq({ id: "cmsh_missing" }, service)
     const res = makeRes()
 
@@ -56,7 +56,7 @@ describe("GET /handovers/[id]", () => {
 
   it("returns 500 when service throws", async () => {
     const service = makeService()
-    service.retrieveCmsHandover.mockRejectedValue(new Error("db error"))
+    service.retrieveRetailosCmsHandover.mockRejectedValue(new Error("db error"))
     const req = makeReq({ id: "cmsh_1" }, service)
     const res = makeRes()
 

package/src/api/admin/retailos/cms/handovers/[id]/route.ts

@@ -21,7 +21,7 @@ export const GET = async (req: AuthenticatedMedusaRequest, res: MedusaResponse)
   const { id } = req.params
   try {
     const service = getService(req)
-    const handover = await service.retrieveCmsHandover(id)
+    const handover = await service.retrieveRetailosCmsHandover(id)
     if (!handover) {
       return res.status(404).json({ code: "NOT_FOUND", message: "Handover not found" })
     }

package/src/api/admin/retailos/cms/handovers/__tests__/route.test.ts

@@ -3,18 +3,24 @@ import { GET, POST } from "../route"
 
 function makeService() {
   return {
-    listAndCountCmsHandovers: vi.fn().mockResolvedValue([[], 0]),
     handover: vi.fn().mockResolvedValue({ id: "cmsh_1", store_id: "s1", handover_amount: 100 }),
   }
 }
 
-function makeReq(overrides: Record<string, unknown> = {}, service = makeService()) {
+function makeQueryModule(data: unknown[] = [], count = 0) {
+  return {
+    graph: vi.fn().mockResolvedValue({ data, metadata: { count } }),
+  }
+}
+
+function makeReq(overrides: Record<string, unknown> = {}, service = makeService(), queryModule = makeQueryModule()) {
   return {
     body: {},
-    filterableFields: {},
+    query: {},
     scope: {
       resolve: vi.fn().mockImplementation((key: string) => {
         if (key === "cms") return service
+        if (key === "query") return queryModule
         throw new Error("not found")
       }),
     },
@@ -32,22 +38,27 @@ function makeRes() {
 
 describe("GET /handovers", () => {
   it("returns handover list with count", async () => {
+    const data = [{ id: "cmsh_1" }, { id: "cmsh_2" }]
+    const queryModule = makeQueryModule(data, 2)
     const service = makeService()
-    const handovers = [{ id: "cmsh_1" }, { id: "cmsh_2" }]
-    service.listAndCountCmsHandovers.mockResolvedValue([handovers, 2])
-    const req = makeReq({}, service)
+    const req = makeReq({}, service, queryModule)
     const res = makeRes()
 
     await GET(req as any, res as any)
 
     expect(res.status).toHaveBeenCalledWith(200)
-    expect(res.json).toHaveBeenCalledWith({ handovers, count: 2 })
+    expect(res.json).toHaveBeenCalledWith({
+      handovers: [
+        { id: "cmsh_1", employee: null, store: null },
+        { id: "cmsh_2", employee: null, store: null },
+      ],
+      count: 2,
+    })
   })
 
-  it("returns 500 when service throws", async () => {
-    const service = makeService()
-    service.listAndCountCmsHandovers.mockRejectedValue(new Error("db error"))
-    const req = makeReq({}, service)
+  it("returns 500 when query.graph throws", async () => {
+    const queryModule = { graph: vi.fn().mockRejectedValue(new Error("db error")) }
+    const req = makeReq({}, makeService(), queryModule)
     const res = makeRes()
 
     await GET(req as any, res as any)

package/src/api/admin/retailos/cms/handovers/route.ts

@@ -2,6 +2,7 @@ import type {
   AuthenticatedMedusaRequest,
   MedusaResponse,
 } from "@medusajs/framework"
+import { ContainerRegistrationKeys } from "@medusajs/framework/utils"
 import { z } from "zod"
 import { CMS_MODULE } from "../../../../../modules/cms/constants"
 import type CmsModuleService from "../../../../../modules/cms/services/cms-module-service"
@@ -32,13 +33,84 @@ function getLogger(req: AuthenticatedMedusaRequest) {
 
 export const GET = async (req: AuthenticatedMedusaRequest, res: MedusaResponse) => {
   try {
-    const service = getService(req)
-    const filters = (req.filterableFields ?? {}) as Record<string, unknown>
-    const [data, count] = await service.listAndCountCmsHandovers(filters, {
-      take: 100,
-      order: { created_at: "DESC" },
+    const query = (req as any).scope.resolve(ContainerRegistrationKeys.QUERY)
+    const q = req.query as Record<string, any>
+
+    const filters: Record<string, unknown> = {}
+
+    // Direct equality filters from query params
+    const DIRECT = ["store_id", "employee_id", "type"] as const
+    for (const key of DIRECT) {
+      if (q[key] !== undefined && q[key] !== "") filters[key] = q[key]
+    }
+    if (q.handover_id) filters.handover_id = q.handover_id
+
+    // q: full-text search on handover_id
+    if (q.q) {
+      filters.handover_id = { $ilike: `%${q.q}%` }
+    }
+
+    // Date range filters
+    if (q.created_at) {
+      filters.created_at = typeof q.created_at === "object" ? q.created_at : { $gte: new Date(q.created_at as string) }
+    }
+    if (q.updated_at) {
+      filters.updated_at = typeof q.updated_at === "object" ? q.updated_at : { $gte: new Date(q.updated_at as string) }
+    }
+
+    // Pagination
+    const limit = q.limit ? Math.min(parseInt(q.limit as string, 10), 500) : 20
+    const offset = q.offset ? parseInt(q.offset as string, 10) : 0
+
+    // Ordering: "field" = ASC, "-field" = DESC
+    let order: Record<string, "ASC" | "DESC"> = { created_at: "DESC" }
+    if (q.order) {
+      const raw = q.order as string
+      const isDesc = raw.startsWith("-")
+      const field = isDesc ? raw.slice(1) : raw
+      const SORTABLE = ["created_at", "updated_at", "handover_amount", "total_cash"]
+      if (SORTABLE.includes(field)) {
+        order = { [field]: isDesc ? "DESC" : "ASC" }
+      }
+    }
+
+    const { data, metadata } = await query.graph({
+      entity: "retailos_cms_handover",
+      fields: [
+        "*",
+        "retailos_employee.id",
+        "retailos_employee.first_name",
+        "retailos_employee.last_name",
+        "retailos_employee.email",
+        "retailos_store.id",
+        "retailos_store.name",
+        "retailos_store.store_code",
+      ],
+      filters: filters as any,
+      pagination: { skip: offset, take: limit },
+      // @ts-ignore
+      order,
     })
-    return res.status(200).json({ handovers: data, count })
+
+    const handovers = (data as any[]).map((h: any) => ({
+      ...h,
+      employee: h.retailos_employee
+        ? {
+            id: h.retailos_employee.id,
+            first_name: h.retailos_employee.first_name,
+            last_name: h.retailos_employee.last_name,
+          }
+        : null,
+      store: h.retailos_store
+        ? {
+            id: h.retailos_store.id,
+            name: h.retailos_store.name,
+            store_code: h.retailos_store.store_code,
+          }
+        : null,
+    }))
+
+    return res.status(200).json({ handovers, count: (metadata as any)?.count ?? handovers.length })
   } catch (err) {
     getLogger(req).error("[retailos/cms] list handovers failed", {
       error: err instanceof Error ? err.message : String(err),

package/src/api/admin/retailos/cms/petty-cash/__tests__/route.test.ts

@@ -3,13 +3,13 @@ import { GET } from "../route"
 
 function makeService() {
   return {
-    listAndCountPettyCashTransactions: vi.fn().mockResolvedValue([[], 0]),
+    listAndCountRetailosPettyCashTransactions: vi.fn().mockResolvedValue([[], 0]),
   }
 }
 
-function makeReq(filterableFields: Record<string, unknown> = {}, service = makeService()) {
+function makeReq(query: Record<string, unknown> = {}, service = makeService()) {
   return {
-    filterableFields,
+    query,
     scope: {
       resolve: vi.fn().mockImplementation((key: string) => {
         if (key === "cms") return service
@@ -28,32 +28,38 @@ function makeRes() {
 }
 
 describe("GET /petty-cash", () => {
-  it("returns transactions and count", async () => {
+  it("returns petty cash transactions and count", async () => {
     const service = makeService()
     const transactions = [{ id: "pct_1" }, { id: "pct_2" }]
-    service.listAndCountPettyCashTransactions.mockResolvedValue([transactions, 2])
+    service.listAndCountRetailosPettyCashTransactions.mockResolvedValue([transactions, 2])
     const req = makeReq({}, service)
     const res = makeRes()
 
     await GET(req as any, res as any)
 
-    expect(service.listAndCountPettyCashTransactions).toHaveBeenCalledWith(
+    expect(service.listAndCountRetailosPettyCashTransactions).toHaveBeenCalledWith(
       expect.objectContaining({ transaction_type: ["open", "close", "petty_cash"] }),
       expect.objectContaining({ take: 100 })
     )
     expect(res.status).toHaveBeenCalledWith(200)
-    expect(res.json).toHaveBeenCalledWith({ transactions, count: 2 })
+    expect(res.json).toHaveBeenCalledWith({
+      petty_cash: [
+        { id: "pct_1", employee: null },
+        { id: "pct_2", employee: null },
+      ],
+      count: 2,
+    })
   })
 
-  it("merges filterableFields with transaction_type filter", async () => {
+  it("includes store_id in filter when provided", async () => {
     const service = makeService()
-    service.listAndCountPettyCashTransactions.mockResolvedValue([[], 0])
-    const req = makeReq({ store_id: ["s1"] }, service)
+    service.listAndCountRetailosPettyCashTransactions.mockResolvedValue([[], 0])
+    const req = makeReq({ store_id: "s1" }, service)
     const res = makeRes()
 
     await GET(req as any, res as any)
 
-    expect(service.listAndCountPettyCashTransactions).toHaveBeenCalledWith(
+    expect(service.listAndCountRetailosPettyCashTransactions).toHaveBeenCalledWith(
       expect.objectContaining({ store_id: ["s1"], transaction_type: ["open", "close", "petty_cash"] }),
       expect.any(Object)
     )
@@ -61,7 +67,7 @@ describe("GET /petty-cash", () => {
 
   it("returns 500 when service throws", async () => {
     const service = makeService()
-    service.listAndCountPettyCashTransactions.mockRejectedValue(new Error("db error"))
+    service.listAndCountRetailosPettyCashTransactions.mockRejectedValue(new Error("db error"))
     const req = makeReq({}, service)
     const res = makeRes()
 

package/src/api/admin/retailos/cms/petty-cash/route.ts

@@ -5,6 +5,8 @@ import type {
 import { CMS_MODULE } from "../../../../../modules/cms/constants"
 import type CmsModuleService from "../../../../../modules/cms/services/cms-module-service"
 
+const EMPLOYEE_MODULE = "employee"
+
 function getService(req: AuthenticatedMedusaRequest): CmsModuleService {
   return (req as any).scope.resolve(CMS_MODULE)
 }
@@ -20,12 +22,52 @@ function getLogger(req: AuthenticatedMedusaRequest) {
 export const GET = async (req: AuthenticatedMedusaRequest, res: MedusaResponse) => {
   try {
     const service = getService(req)
-    const filters = (req.filterableFields ?? {}) as Record<string, unknown>
-    const [transactions, count] = await service.listAndCountPettyCashTransactions(
+    const q = req.query as Record<string, any>
+
+    const filters: Record<string, unknown> = {}
+    if (q.store_id) filters.store_id = [q.store_id]
+
+    const limit = q.limit ? Math.min(parseInt(q.limit as string, 10), 500) : 100
+    const offset = q.offset ? parseInt(q.offset as string, 10) : 0
+
+    const [transactions, count] = await service.listAndCountRetailosPettyCashTransactions(
       { ...filters, transaction_type: ["open", "close", "petty_cash"] },
-      { take: 100, order: { created_at: "DESC" } }
+      { take: limit, skip: offset, order: { created_at: "DESC" } } as any
     )
-    return res.status(200).json({ transactions, count })
+
+    // Enrich with employee data via bulk lookup
+    const employeeIds = [...new Set(
+      transactions.map((t: any) => t.employee_id).filter(Boolean)
+    )] as string[]
+
+    let employeeMap = new Map<string, { id: string; first_name: string; last_name: string }>()
+    if (employeeIds.length) {
+      try {
+        const employeeService = (req as any).scope.resolve(EMPLOYEE_MODULE)
+        const employees = await employeeService.listEmployees(
+          { id: employeeIds },
+          { select: ["id", "first_name", "last_name"] }
+        )
+        employeeMap = new Map(employees.map((e: any) => [e.id, e]))
+      } catch {
+        // employee module unavailable — return without enrichment
+      }
+    }
+
+    const petty_cash = transactions.map((t: any) => ({
+      ...t,
+      employee: t.employee_id
+        ? (employeeMap.get(t.employee_id)
+            ? {
+                id: employeeMap.get(t.employee_id)!.id,
+                first_name: employeeMap.get(t.employee_id)!.first_name,
+                last_name: employeeMap.get(t.employee_id)!.last_name,
+              }
+            : null)
+        : null,
+    }))
+
+    return res.status(200).json({ petty_cash, count })
   } catch (err) {
     getLogger(req).error("[retailos/cms] list petty cash failed", {
       error: err instanceof Error ? err.message : String(err),

package/src/api/admin/retailos/cms/reconciliation/__tests__/route.test.ts

@@ -0,0 +1,124 @@
+import { describe, it, expect, vi } from "vitest"
+import { GET } from "../route"
+
+function makeReport(overrides = {}) {
+  return {
+    date: "2026-06-23",
+    store_id: "s1",
+    opening_balance: 8200,
+    net_cash_sales: 28450,
+    total_handovers_in: 0,
+    total_handovers_out: 5000,
+    petty_cash_in: 0,
+    petty_cash_out: 1000,
+    expected_closing_balance: 30650,
+    closing_balance: 30650,
+    cms_balance: 30650,
+    variance: 0,
+    is_balanced: true,
+    handovers: [],
+    shift_logs: [],
+    ...overrides,
+  }
+}
+
+function makeService(report = makeReport()) {
+  return { getReconciliationReport: vi.fn().mockResolvedValue(report) }
+}
+
+function makeReq(query: Record<string, string> = {}, service = makeService()) {
+  return {
+    query,
+    scope: {
+      resolve: vi.fn().mockImplementation((key: string) => {
+        if (key === "cms") return service
+        throw new Error("not found")
+      }),
+    },
+    _service: service,
+  }
+}
+
+function makeRes() {
+  return {
+    status: vi.fn().mockReturnThis(),
+    json: vi.fn().mockReturnThis(),
+  }
+}
+
+describe("GET /reconciliation", () => {
+  it("returns 400 when store_id is missing", async () => {
+    const req = makeReq({ date: "2026-06-23" })
+    const res = makeRes()
+    await GET(req as any, res as any)
+    expect(res.status).toHaveBeenCalledWith(400)
+    expect(res.json).toHaveBeenCalledWith(expect.objectContaining({ code: "BAD_REQUEST" }))
+  })
+
+  it("returns 400 when date is missing", async () => {
+    const req = makeReq({ store_id: "s1" })
+    const res = makeRes()
+    await GET(req as any, res as any)
+    expect(res.status).toHaveBeenCalledWith(400)
+    expect(res.json).toHaveBeenCalledWith(expect.objectContaining({ code: "BAD_REQUEST" }))
+  })
+
+  it("returns 400 when date format is invalid", async () => {
+    const req = makeReq({ store_id: "s1", date: "23-06-2026" })
+    const res = makeRes()
+    await GET(req as any, res as any)
+    expect(res.status).toHaveBeenCalledWith(400)
+    expect(res.json).toHaveBeenCalledWith(expect.objectContaining({ code: "BAD_REQUEST" }))
+  })
+
+  it("returns reconciliation report on success", async () => {
+    const report = makeReport()
+    const service = makeService(report)
+    const req = makeReq({ store_id: "s1", date: "2026-06-23" }, service)
+    const res = makeRes()
+
+    await GET(req as any, res as any)
+
+    expect(res.status).toHaveBeenCalledWith(200)
+    expect(res.json).toHaveBeenCalledWith({ data: report })
+  })
+
+  it("passes net_cash_sales from query to service", async () => {
+    const service = makeService()
+    const req = makeReq({ store_id: "s1", date: "2026-06-23", net_cash_sales: "28450" }, service)
+    const res = makeRes()
+
+    await GET(req as any, res as any)
+
+    expect(service.getReconciliationReport).toHaveBeenCalledWith({
+      store_id: "s1",
+      date: "2026-06-23",
+      net_cash_sales: 28450,
+    })
+  })
+
+  it("defaults net_cash_sales to 0 when not provided", async () => {
+    const service = makeService()
+    const req = makeReq({ store_id: "s1", date: "2026-06-23" }, service)
+    const res = makeRes()
+
+    await GET(req as any, res as any)
+
+    expect(service.getReconciliationReport).toHaveBeenCalledWith({
+      store_id: "s1",
+      date: "2026-06-23",
+      net_cash_sales: 0,
+    })
+  })
+
+  it("returns 500 when service throws", async () => {
+    const service = { getReconciliationReport: vi.fn().mockRejectedValue(new Error("db error")) }
+    const req = makeReq({ store_id: "s1", date: "2026-06-23" }, service as any)
+    const res = makeRes()
+
+    await GET(req as any, res as any)
+
+    expect(res.status).toHaveBeenCalledWith(500)
+    expect(res.json).toHaveBeenCalledWith(expect.objectContaining({ code: "INTERNAL_ERROR" }))
+  })
+})

package/src/api/admin/retailos/cms/reconciliation/route.ts

@@ -0,0 +1,47 @@
+import type {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "@medusajs/framework"
+import { CMS_MODULE } from "../../../../../modules/cms/constants"
+import type CmsModuleService from "../../../../../modules/cms/services/cms-module-service"
+
+function getService(req: AuthenticatedMedusaRequest): CmsModuleService {
+  return (req as any).scope.resolve(CMS_MODULE)
+}
+
+function getLogger(req: AuthenticatedMedusaRequest) {
+  try {
+    return (req as any).scope.resolve("logger")
+  } catch {
+    return { info: () => {}, warn: () => {}, error: () => {}, debug: () => {} }
+  }
+}
+
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/
+
+export const GET = async (req: AuthenticatedMedusaRequest, res: MedusaResponse) => {
+  const query = req.query as Record<string, string>
+  const { store_id, date } = query
+
+  if (!store_id) {
+    return res.status(400).json({ code: "BAD_REQUEST", message: "store_id is required" })
+  }
+  if (!date || !DATE_RE.test(date)) {
+    return res.status(400).json({ code: "BAD_REQUEST", message: "date is required in YYYY-MM-DD format" })
+  }
+
+  const net_cash_sales = query.net_cash_sales !== undefined ? Number(query.net_cash_sales) : 0
+
+  try {
+    const service = getService(req)
+    const data = await service.getReconciliationReport({ store_id, date, net_cash_sales })
+    return res.status(200).json({ data })
+  } catch (err) {
+    getLogger(req).error("[retailos/cms] reconciliation report failed", {
+      store_id,
+      date,
+      error: err instanceof Error ? err.message : String(err),
+    })
+    return res.status(500).json({ code: "INTERNAL_ERROR", message: (err as Error).message })
+  }
+}