@devx-retailos/cms 0.0.1

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

@@ -0,0 +1,130 @@
+import type {
+  AuthenticatedMedusaRequest,
+  MedusaResponse,
+} from "@medusajs/framework"
+import { z } from "zod"
+import { CMS_MODULE } from "../../../../../modules/cms/constants"
+import type CmsModuleService from "../../../../../modules/cms/services/cms-module-service"
+
+const OPERATIONS = ["day_start", "day_end", "handover", "add_petty_cash", "add_expense"] as const
+type Operation = typeof OPERATIONS[number]
+
+const operationSchema = z.object({
+  operation: z.enum(OPERATIONS),
+  store_id: z.string().min(1),
+  employee_id: z.string().min(1),
+  opening_amount: z.number().nonnegative().optional(),
+  closing_amount: z.number().nonnegative().optional(),
+  handover_id: z.string().nullable().optional(),
+  handover_amount: z.number().nonnegative().optional(),
+  total_cash: z.number().nullable().optional(),
+  type: z.enum(["DB", "CR"]).nullable().optional(),
+  image_url: z.string().nullable().optional(),
+  remark: z.string().nullable().optional(),
+  amount: z.number().positive().optional(),
+  source: z.enum(["self", "from_petty_cash"]).nullable().optional(),
+  category: z.string().nullable().optional(),
+  sub_category: z.string().nullable().optional(),
+  reason: z.string().nullable().optional(),
+  metadata: z.record(z.string(), z.unknown()).nullable().optional(),
+})
+
+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: () => {} }
+  }
+}
+
+export const POST = async (req: AuthenticatedMedusaRequest, res: MedusaResponse) => {
+  const parsed = operationSchema.safeParse(req.body)
+  if (!parsed.success) {
+    return res.status(400).json({
+      code: "BAD_REQUEST",
+      message: "Invalid operation input",
+      details: parsed.error.flatten(),
+    })
+  }
+
+  const data = parsed.data
+  const service = getService(req)
+  const logger = getLogger(req)
+
+  try {
+    switch (data.operation as Operation) {
+      case "day_start": {
+        if (data.opening_amount == null) {
+          return res.status(400).json({ code: "BAD_REQUEST", message: "opening_amount is required for day_start" })
+        }
+        await service.dayStart({ store_id: data.store_id, employee_id: data.employee_id, opening_amount: data.opening_amount })
+        return res.status(200).json({ operation: "day_start", store_id: data.store_id })
+      }
+      case "day_end": {
+        if (data.closing_amount == null) {
+          return res.status(400).json({ code: "BAD_REQUEST", message: "closing_amount is required for day_end" })
+        }
+        await service.dayEnd({ store_id: data.store_id, employee_id: data.employee_id, closing_amount: data.closing_amount })
+        return res.status(200).json({ operation: "day_end", store_id: data.store_id })
+      }
+      case "handover": {
+        if (data.handover_amount == null) {
+          return res.status(400).json({ code: "BAD_REQUEST", message: "handover_amount is required for handover" })
+        }
+        const handover = await service.handover({
+          store_id: data.store_id,
+          employee_id: data.employee_id,
+          handover_id: data.handover_id ?? null,
+          handover_amount: data.handover_amount,
+          total_cash: data.total_cash ?? null,
+          type: data.type ?? null,
+          image_url: data.image_url ?? null,
+          remark: data.remark ?? null,
+          metadata: data.metadata ?? null,
+        })
+        return res.status(201).json({ operation: "handover", handover })
+      }
+      case "add_petty_cash": {
+        if (data.amount == null) {
+          return res.status(400).json({ code: "BAD_REQUEST", message: "amount is required for add_petty_cash" })
+        }
+        const tx = await service.addPettyCash({
+          store_id: data.store_id,
+          employee_id: data.employee_id,
+          amount: data.amount,
+          source: data.source ?? null,
+        })
+        return res.status(201).json({ operation: "add_petty_cash", transaction: tx })
+      }
+      case "add_expense": {
+        if (data.amount == null) {
+          return res.status(400).json({ code: "BAD_REQUEST", message: "amount is required for add_expense" })
+        }
+        const tx = await service.addExpense({
+          store_id: data.store_id,
+          employee_id: data.employee_id,
+          amount: data.amount,
+          category: data.category ?? null,
+          sub_category: data.sub_category ?? null,
+          reason: data.reason ?? null,
+          image_url: data.image_url ?? null,
+          metadata: data.metadata ?? null,
+        })
+        return res.status(201).json({ operation: "add_expense", transaction: tx })
+      }
+      default:
+        return res.status(400).json({ code: "BAD_REQUEST", message: "Unknown operation" })
+    }
+  } catch (err) {
+    logger.error("[retailos/cms] operation failed", {
+      operation: data.operation,
+      store_id: data.store_id,
+      error: err instanceof Error ? err.message : String(err),
+    })
+    return res.status(500).json({ code: "INTERNAL_ERROR", message: (err as Error).message })
+  }
+}

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

@@ -0,0 +1,73 @@
+import { describe, it, expect, vi } from "vitest"
+import { GET } from "../route"
+
+function makeService() {
+  return {
+    listAndCountPettyCashTransactions: vi.fn().mockResolvedValue([[], 0]),
+  }
+}
+
+function makeReq(filterableFields: Record<string, unknown> = {}, service = makeService()) {
+  return {
+    filterableFields,
+    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 /petty-cash", () => {
+  it("returns transactions and count", async () => {
+    const service = makeService()
+    const transactions = [{ id: "pct_1" }, { id: "pct_2" }]
+    service.listAndCountPettyCashTransactions.mockResolvedValue([transactions, 2])
+    const req = makeReq({}, service)
+    const res = makeRes()
+
+    await GET(req as any, res as any)
+
+    expect(service.listAndCountPettyCashTransactions).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 })
+  })
+
+  it("merges filterableFields with transaction_type filter", async () => {
+    const service = makeService()
+    service.listAndCountPettyCashTransactions.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.objectContaining({ store_id: ["s1"], transaction_type: ["open", "close", "petty_cash"] }),
+      expect.any(Object)
+    )
+  })
+
+  it("returns 500 when service throws", async () => {
+    const service = makeService()
+    service.listAndCountPettyCashTransactions.mockRejectedValue(new Error("db error"))
+    const req = makeReq({}, service)
+    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/petty-cash/route.ts

@@ -0,0 +1,35 @@
+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: () => {} }
+  }
+}
+
+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(
+      { ...filters, transaction_type: ["open", "close", "petty_cash"] },
+      { take: 100, order: { created_at: "DESC" } }
+    )
+    return res.status(200).json({ transactions, count })
+  } catch (err) {
+    getLogger(req).error("[retailos/cms] list petty cash failed", {
+      error: err instanceof Error ? err.message : String(err),
+    })
+    return res.status(500).json({ code: "INTERNAL_ERROR", message: (err as Error).message })
+  }
+}

package/src/api/admin/retailos/cms/shift-logs/__tests__/route.test.ts

@@ -0,0 +1,77 @@
+import { describe, it, expect, vi } from "vitest"
+import { GET } from "../route"
+
+function makeService() {
+  return {
+    getShiftLogs: vi.fn().mockResolvedValue([]),
+  }
+}
+
+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 /shift-logs", () => {
+  it("returns shift logs with count", async () => {
+    const service = makeService()
+    const logs = [{ id: "pct_1", transaction_type: "open" }, { id: "pct_2", transaction_type: "close" }]
+    service.getShiftLogs.mockResolvedValue(logs)
+    const req = makeReq({}, service)
+    const res = makeRes()
+
+    await GET(req as any, res as any)
+
+    expect(res.status).toHaveBeenCalledWith(200)
+    expect(res.json).toHaveBeenCalledWith({ shift_logs: logs, count: 2 })
+  })
+
+  it("passes store_id and limit to service", async () => {
+    const service = makeService()
+    service.getShiftLogs.mockResolvedValue([])
+    const req = makeReq({ store_id: "s1", limit: "20" }, service)
+    const res = makeRes()
+
+    await GET(req as any, res as any)
+
+    expect(service.getShiftLogs).toHaveBeenCalledWith({ store_id: "s1", limit: 20 })
+  })
+
+  it("defaults limit to 50 when not provided", async () => {
+    const service = makeService()
+    service.getShiftLogs.mockResolvedValue([])
+    const req = makeReq({}, service)
+    const res = makeRes()
+
+    await GET(req as any, res as any)
+
+    expect(service.getShiftLogs).toHaveBeenCalledWith({ store_id: undefined, limit: 50 })
+  })
+
+  it("returns 500 when service throws", async () => {
+    const service = makeService()
+    service.getShiftLogs.mockRejectedValue(new Error("db error"))
+    const req = makeReq({}, service)
+    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/shift-logs/route.ts

@@ -0,0 +1,38 @@
+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: () => {} }
+  }
+}
+
+export const GET = async (req: AuthenticatedMedusaRequest, res: MedusaResponse) => {
+  const query = req.query as Record<string, string>
+  const store_id = query.store_id
+  const limit = query.limit ? Number(query.limit) : 50
+
+  try {
+    const service = getService(req)
+    const logs = await service.getShiftLogs({
+      store_id: store_id || undefined,
+      limit,
+    })
+    return res.status(200).json({ shift_logs: logs, count: logs.length })
+  } catch (err) {
+    getLogger(req).error("[retailos/cms] list shift logs failed", {
+      error: err instanceof Error ? err.message : String(err),
+    })
+    return res.status(500).json({ code: "INTERNAL_ERROR", message: (err as Error).message })
+  }
+}

package/src/links/employee-to-cms-handover.ts

@@ -0,0 +1,11 @@
+import { defineLink } from "@medusajs/framework/utils"
+import EmployeeModule from "@devx-retailos/employee"
+import CmsModule from "../modules/cms"
+
+export default defineLink(
+  (EmployeeModule as any).linkable.retailosEmployee,
+  {
+    linkable: (CmsModule as any).linkable.retailosCmsHandover,
+    isList: true,
+  }
+)

package/src/links/store-to-cms-handover.ts

@@ -0,0 +1,11 @@
+import { defineLink } from "@medusajs/framework/utils"
+import RbacModule from "@devx-retailos/rbac"
+import CmsModule from "../modules/cms"
+
+export default defineLink(
+  (RbacModule as any).linkable.retailosStore,
+  {
+    linkable: (CmsModule as any).linkable.retailosCmsHandover,
+    isList: true,
+  }
+)