@devx-retailos/cms 0.0.1

package/src/modules/cms/services/cms-module-service.ts

@@ -0,0 +1,284 @@
+import { MedusaService } from "@medusajs/framework/utils"
+import { createNoopLogger, type Logger } from "@devx-retailos/core"
+import CmsHandover from "../models/cms-handover"
+import CmsAccumulation from "../models/cms-accumulation"
+import PettyCash from "../models/petty-cash"
+import PettyCashTransaction from "../models/petty-cash-transaction"
+
+export type HandoverType = "DB" | "CR"
+export type TransactionType = "open" | "close" | "petty_cash"
+export type EntryType = "DB" | "CR"
+export type PettyCashSource = "self" | "from_petty_cash"
+
+export interface DayStartInput {
+  store_id: string
+  employee_id: string
+  opening_amount: number
+}
+
+export interface DayEndInput {
+  store_id: string
+  employee_id: string
+  closing_amount: number
+}
+
+export interface HandoverInput {
+  store_id: string
+  employee_id: string
+  handover_id?: string | null
+  handover_amount: number
+  total_cash?: number | null
+  type?: HandoverType | null
+  image_url?: string | null
+  remark?: string | null
+  metadata?: Record<string, unknown> | null
+}
+
+export interface AddPettyCashInput {
+  store_id: string
+  employee_id: string
+  amount: number
+  source?: PettyCashSource | null
+}
+
+export interface AddExpenseInput {
+  store_id: string
+  employee_id: string
+  amount: number
+  category?: string | null
+  sub_category?: string | null
+  reason?: string | null
+  image_url?: string | null
+  metadata?: Record<string, unknown> | null
+}
+
+export interface ShiftLogFilters {
+  store_id?: string
+  from?: Date
+  to?: Date
+  limit?: number
+}
+
+class CmsModuleService extends MedusaService({
+  CmsHandover,
+  CmsAccumulation,
+  PettyCash,
+  PettyCashTransaction,
+}) {
+  protected logger_: Logger
+
+  constructor(...args: any[]) {
+    super(...args)
+    const container = (args[0] ?? {}) as { logger?: Logger }
+    this.logger_ = container.logger ?? createNoopLogger()
+    this.logger_.debug("[retailos/cms] service initialized")
+  }
+
+  async dayStart(input: DayStartInput): Promise<void> {
+    const { store_id, employee_id, opening_amount } = input
+    if (opening_amount < 0) {
+      throw new Error("[retailos/cms] opening_amount must be >= 0")
+    }
+
+    const existing = await this.listCmsAccumulations({ store_id: [store_id] })
+    if (existing.length === 0) {
+      await this.createCmsAccumulations([{ store_id, cash_in_store: opening_amount }])
+    } else {
+      await this.updateCmsAccumulations([{ id: (existing[0] as any).id, cash_in_store: opening_amount }])
+    }
+
+    await this.createPettyCashTransactions([{
+      store_id,
+      employee_id,
+      transaction_type: "open" as TransactionType,
+      entry_type: "CR" as EntryType,
+      source: null,
+      amount: opening_amount,
+      opening_balance: opening_amount,
+      closing_balance: null,
+      expense_amount: 0,
+      difference_amount: 0,
+      category: null,
+      sub_category: null,
+      reason: null,
+      image_url: null,
+      date: new Date(),
+      metadata: null,
+    }])
+
+    this.logger_.info("cms.day_started", { store_id, employee_id, opening_amount })
+  }
+
+  async dayEnd(input: DayEndInput): Promise<void> {
+    const { store_id, employee_id, closing_amount } = input
+    if (closing_amount < 0) {
+      throw new Error("[retailos/cms] closing_amount must be >= 0")
+    }
+
+    const accumulations = await this.listCmsAccumulations({ store_id: [store_id] })
+    const current_cash = accumulations[0] ? (accumulations[0] as any).cash_in_store : 0
+    const difference = closing_amount - current_cash
+
+    await this.createPettyCashTransactions([{
+      store_id,
+      employee_id,
+      transaction_type: "close" as TransactionType,
+      entry_type: "DB" as EntryType,
+      source: null,
+      amount: closing_amount,
+      opening_balance: current_cash,
+      closing_balance: closing_amount,
+      expense_amount: 0,
+      difference_amount: difference,
+      category: null,
+      sub_category: null,
+      reason: null,
+      image_url: null,
+      date: new Date(),
+      metadata: null,
+    }])
+
+    this.logger_.info("cms.day_ended", { store_id, employee_id, closing_amount, difference })
+  }
+
+  async handover(input: HandoverInput) {
+    const { store_id, handover_amount, type } = input
+    if (handover_amount < 0) {
+      throw new Error("[retailos/cms] handover_amount must be >= 0")
+    }
+
+    const [created] = await this.createCmsHandovers([{
+      store_id,
+      employee_id: input.employee_id,
+      handover_id: input.handover_id ?? null,
+      handover_amount,
+      total_cash: input.total_cash ?? null,
+      type: type ?? null,
+      image_url: input.image_url ?? null,
+      remark: input.remark ?? null,
+      metadata: input.metadata ?? null,
+    }])
+
+    const accumulations = await this.listCmsAccumulations({ store_id: [store_id] })
+    const current = accumulations[0] ? (accumulations[0] as any).cash_in_store : 0
+
+    let updated_cash = current
+    if (type === "CR") {
+      updated_cash = current + handover_amount
+    } else if (type === "DB") {
+      updated_cash = current - handover_amount
+    }
+
+    if (accumulations.length === 0) {
+      await this.createCmsAccumulations([{ store_id, cash_in_store: updated_cash }])
+    } else {
+      await this.updateCmsAccumulations([{ id: (accumulations[0] as any).id, cash_in_store: updated_cash }])
+    }
+
+    this.logger_.info("[retailos/cms] handover created", {
+      id: (created as any)?.id,
+      store_id,
+      handover_amount,
+      type,
+    })
+
+    return created
+  }
+
+  async addPettyCash(input: AddPettyCashInput) {
+    const { store_id, employee_id, amount, source } = input
+    if (amount <= 0) {
+      throw new Error("[retailos/cms] amount must be > 0")
+    }
+
+    const existing = await this.listPettyCashes({ store_id: [store_id] })
+    const current_balance = existing[0] ? (existing[0] as any).balance : 0
+    const new_balance = current_balance + amount
+
+    if (existing.length === 0) {
+      await this.createPettyCashes([{ store_id, balance: new_balance }])
+    } else {
+      await this.updatePettyCashes([{ id: (existing[0] as any).id, balance: new_balance }])
+    }
+
+    const [tx] = await this.createPettyCashTransactions([{
+      store_id,
+      employee_id,
+      transaction_type: "petty_cash" as TransactionType,
+      entry_type: "CR" as EntryType,
+      source: source ?? null,
+      amount,
+      opening_balance: current_balance,
+      closing_balance: new_balance,
+      expense_amount: 0,
+      difference_amount: 0,
+      category: null,
+      sub_category: null,
+      reason: null,
+      image_url: null,
+      date: new Date(),
+      metadata: null,
+    }])
+
+    this.logger_.info("[retailos/cms] petty cash added", { store_id, amount, new_balance })
+    return tx
+  }
+
+  async addExpense(input: AddExpenseInput) {
+    const { store_id, employee_id, amount } = input
+    if (amount <= 0) {
+      throw new Error("[retailos/cms] expense amount must be > 0")
+    }
+
+    const existing = await this.listPettyCashes({ store_id: [store_id] })
+    const current_balance = existing[0] ? (existing[0] as any).balance : 0
+    const new_balance = current_balance - amount
+
+    if (existing.length === 0) {
+      await this.createPettyCashes([{ store_id, balance: new_balance }])
+    } else {
+      await this.updatePettyCashes([{ id: (existing[0] as any).id, balance: new_balance }])
+    }
+
+    const [tx] = await this.createPettyCashTransactions([{
+      store_id,
+      employee_id,
+      transaction_type: "petty_cash" as TransactionType,
+      entry_type: "DB" as EntryType,
+      source: null,
+      amount,
+      opening_balance: current_balance,
+      closing_balance: new_balance,
+      expense_amount: amount,
+      difference_amount: 0,
+      category: input.category ?? null,
+      sub_category: input.sub_category ?? null,
+      reason: input.reason ?? null,
+      image_url: input.image_url ?? null,
+      date: new Date(),
+      metadata: input.metadata ?? null,
+    }])
+
+    this.logger_.info("[retailos/cms] expense recorded", { store_id, amount, category: input.category })
+    return tx
+  }
+
+  async getAccumulation(store_id: string) {
+    const rows = await this.listCmsAccumulations({ store_id: [store_id] })
+    return rows[0] ?? null
+  }
+
+  async getShiftLogs(filters: ShiftLogFilters) {
+    const dbFilters: Record<string, unknown> = {}
+    if (filters.store_id) dbFilters.store_id = [filters.store_id]
+    dbFilters.transaction_type = ["open", "close"]
+
+    const rows = await this.listPettyCashTransactions(dbFilters, {
+      take: filters.limit ?? 100,
+      order: { created_at: "DESC" } as any,
+    })
+    return rows
+  }
+}
+
+export default CmsModuleService

package/src/modules/cms/services/index.ts

@@ -0,0 +1,13 @@
+export { default as CmsModuleService } from "./cms-module-service"
+export type {
+  DayStartInput,
+  DayEndInput,
+  HandoverInput,
+  AddPettyCashInput,
+  AddExpenseInput,
+  ShiftLogFilters,
+  HandoverType,
+  TransactionType,
+  EntryType,
+  PettyCashSource,
+} from "./cms-module-service"