@aghamdi/shared-types 0.2.35 → 0.2.37

package/dist/index.d.mts

@@ -319,6 +319,21 @@ interface OrderCreatedEvent {
 declare class MiaOrders {
     static publishOrderCreated(event: OrderCreatedEvent): Promise<void>;
 }
+interface PreorderPaymentEvent {
+    preorderId: string;
+    sourceId: string;
+    source: ServiceType;
+    brandId: string;
+    branchId?: string;
+    payment: PaymentInfo;
+    totalPaid: number;
+    total: number;
+    isFullyPaid: boolean;
+    orderId?: string;
+}
+declare class MiaPreorders {
+    static publishPaymentAdded(event: PreorderPaymentEvent): Promise<void>;
+}
 
 interface ShiftClosedEvent {
     shiftId: string;
@@ -389,4 +404,17 @@ declare class MiaAuditTrace {
     static publish(event: AuditTraceEvent): Promise<void>;
 }
 
-export { type AttributeValue, type AuditRiskLevel, type AuditTraceEvent, type BuyerIdentificationScheme, type CriticalErrorEvent, type CustomerActionMessage, type CustomerAddTagMessage, type CustomerInfo, type CustomerMobileVerifiedMessage, type CustomerUpdateNotesMessage, type DeviceNotification, MessagingBus, MiaAuditTrace, MiaCriticalErrors, MiaNotifications, MiaOrders, MiaServerResponse, MiaShifts, MicrogemsCustomer, type MultilanguageString, type Notification, type OperateOrderNotification, type OperateOrderNotificationPayload, type OrderAttribute, type OrderCreatedEvent, type OrderFeeInfo, type OrderItemAttributes, type OrderItemForInvoice, type PaymentInfo, type PrintLine, type SelectedOrderAttribute, type ServiceType, type ShiftClosedEvent, type SmsNotification, type StaffNotification, type TopicNotification, type UserNotification, calculateAttributesPrice, createMultilanguageString, getLocalizedText, validateSelectedAttributes };
+interface LowStockEvent {
+    brandId: string;
+    branchId: string;
+    rawMaterialId: string;
+    materialName: string;
+    currentQuantity: number;
+    lowThreshold: number;
+    unit: string;
+}
+declare class MiaStock {
+    static publishLowStockAlert(event: LowStockEvent): Promise<void>;
+}
+
+export { type AttributeValue, type AuditRiskLevel, type AuditTraceEvent, type BuyerIdentificationScheme, type CriticalErrorEvent, type CustomerActionMessage, type CustomerAddTagMessage, type CustomerInfo, type CustomerMobileVerifiedMessage, type CustomerUpdateNotesMessage, type DeviceNotification, type LowStockEvent, MessagingBus, MiaAuditTrace, MiaCriticalErrors, MiaNotifications, MiaOrders, MiaPreorders, MiaServerResponse, MiaShifts, MiaStock, MicrogemsCustomer, type MultilanguageString, type Notification, type OperateOrderNotification, type OperateOrderNotificationPayload, type OrderAttribute, type OrderCreatedEvent, type OrderFeeInfo, type OrderItemAttributes, type OrderItemForInvoice, type PaymentInfo, type PreorderPaymentEvent, type PrintLine, type SelectedOrderAttribute, type ServiceType, type ShiftClosedEvent, type SmsNotification, type StaffNotification, type TopicNotification, type UserNotification, calculateAttributesPrice, createMultilanguageString, getLocalizedText, validateSelectedAttributes };

package/dist/index.d.ts

@@ -319,6 +319,21 @@ interface OrderCreatedEvent {
 declare class MiaOrders {
     static publishOrderCreated(event: OrderCreatedEvent): Promise<void>;
 }
+interface PreorderPaymentEvent {
+    preorderId: string;
+    sourceId: string;
+    source: ServiceType;
+    brandId: string;
+    branchId?: string;
+    payment: PaymentInfo;
+    totalPaid: number;
+    total: number;
+    isFullyPaid: boolean;
+    orderId?: string;
+}
+declare class MiaPreorders {
+    static publishPaymentAdded(event: PreorderPaymentEvent): Promise<void>;
+}
 
 interface ShiftClosedEvent {
     shiftId: string;
@@ -389,4 +404,17 @@ declare class MiaAuditTrace {
     static publish(event: AuditTraceEvent): Promise<void>;
 }
 
-export { type AttributeValue, type AuditRiskLevel, type AuditTraceEvent, type BuyerIdentificationScheme, type CriticalErrorEvent, type CustomerActionMessage, type CustomerAddTagMessage, type CustomerInfo, type CustomerMobileVerifiedMessage, type CustomerUpdateNotesMessage, type DeviceNotification, MessagingBus, MiaAuditTrace, MiaCriticalErrors, MiaNotifications, MiaOrders, MiaServerResponse, MiaShifts, MicrogemsCustomer, type MultilanguageString, type Notification, type OperateOrderNotification, type OperateOrderNotificationPayload, type OrderAttribute, type OrderCreatedEvent, type OrderFeeInfo, type OrderItemAttributes, type OrderItemForInvoice, type PaymentInfo, type PrintLine, type SelectedOrderAttribute, type ServiceType, type ShiftClosedEvent, type SmsNotification, type StaffNotification, type TopicNotification, type UserNotification, calculateAttributesPrice, createMultilanguageString, getLocalizedText, validateSelectedAttributes };
+interface LowStockEvent {
+    brandId: string;
+    branchId: string;
+    rawMaterialId: string;
+    materialName: string;
+    currentQuantity: number;
+    lowThreshold: number;
+    unit: string;
+}
+declare class MiaStock {
+    static publishLowStockAlert(event: LowStockEvent): Promise<void>;
+}
+
+export { type AttributeValue, type AuditRiskLevel, type AuditTraceEvent, type BuyerIdentificationScheme, type CriticalErrorEvent, type CustomerActionMessage, type CustomerAddTagMessage, type CustomerInfo, type CustomerMobileVerifiedMessage, type CustomerUpdateNotesMessage, type DeviceNotification, type LowStockEvent, MessagingBus, MiaAuditTrace, MiaCriticalErrors, MiaNotifications, MiaOrders, MiaPreorders, MiaServerResponse, MiaShifts, MiaStock, MicrogemsCustomer, type MultilanguageString, type Notification, type OperateOrderNotification, type OperateOrderNotificationPayload, type OrderAttribute, type OrderCreatedEvent, type OrderFeeInfo, type OrderItemAttributes, type OrderItemForInvoice, type PaymentInfo, type PreorderPaymentEvent, type PrintLine, type SelectedOrderAttribute, type ServiceType, type ShiftClosedEvent, type SmsNotification, type StaffNotification, type TopicNotification, type UserNotification, calculateAttributesPrice, createMultilanguageString, getLocalizedText, validateSelectedAttributes };

package/dist/index.js

@@ -66,8 +66,10 @@ __export(src_exports, {
   MiaCriticalErrors: () => MiaCriticalErrors,
   MiaNotifications: () => MiaNotifications,
   MiaOrders: () => MiaOrders,
+  MiaPreorders: () => MiaPreorders,
   MiaServerResponse: () => MiaServerResponse,
   MiaShifts: () => MiaShifts,
+  MiaStock: () => MiaStock,
   MicrogemsCustomer: () => MicrogemsCustomer,
   calculateAttributesPrice: () => calculateAttributesPrice,
   createMultilanguageString: () => createMultilanguageString,
@@ -286,6 +288,13 @@ var MiaOrders = class {
     });
   }
 };
+var MiaPreorders = class {
+  static publishPaymentAdded(event) {
+    return __async(this, null, function* () {
+      yield MessagingBus.publish("mia.preorders.payment-added", event);
+    });
+  }
+};
 
 // src/shifts.ts
 var MiaShifts = class {
@@ -315,6 +324,15 @@ var MiaAuditTrace = class {
     });
   }
 };
+
+// src/stock.ts
+var MiaStock = class {
+  static publishLowStockAlert(event) {
+    return __async(this, null, function* () {
+      yield MessagingBus.publish("mia.menu.stock.low", event);
+    });
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   MessagingBus,
@@ -322,8 +340,10 @@ var MiaAuditTrace = class {
   MiaCriticalErrors,
   MiaNotifications,
   MiaOrders,
+  MiaPreorders,
   MiaServerResponse,
   MiaShifts,
+  MiaStock,
   MicrogemsCustomer,
   calculateAttributesPrice,
   createMultilanguageString,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/mia-server-response.ts","../src/messaging-bus.ts","../src/notifications.ts","../src/customers.ts","../src/multilanguage.ts","../src/order-attributes.ts","../src/orders.ts","../src/shifts.ts","../src/critical-errors.ts","../src/audit-trace.ts"],"sourcesContent":["export * from './mia-server-response'\nexport * from './notifications'\nexport * from './messaging-bus'\nexport * from './customers'\nexport * from './multilanguage'\nexport * from './order-attributes'\nexport * from './orders'\nexport * from './shifts'\nexport * from './critical-errors'\nexport * from './audit-trace'\n","export class MiaServerResponse {\n  status?: number;\n  message?: string;\n  data: any;\n\n  static send = (status: number, message: string, data: any) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: message,\n      data: data\n    };\n    return response;\n  }\n  static sendData = (data: any, status: number = 200) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: \"Success\",\n      data: data\n    };\n    return response;\n  }\n  static sendError = (error: any, status: number = 400) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: \"Failed\",\n      data: error\n    };\n    return response;\n  }\n}\n","import { connect, JSONCodec } from \"nats\";\n\nexport class MessagingBus {\n  static async subscribe(channel: string, queue: string, onMessage: Function) {\n    if (!process.env.NATS_HOST) {\n      throw new Error(\"NATS_HOST ENV is not defined\");\n    }\n    const nc = await connect({ servers: process.env.NATS_HOST });\n    const sc = JSONCodec();\n    const subscription = nc.subscribe(channel, { queue: queue });\n\n    (async (sub) => {\n\n      console.log(`listening for ${sub.getSubject()} requests...`);\n\n      for await (const m of sub) {\n        const msg = sc.decode(m.data);\n        onMessage(msg);\n      }\n\n      console.log(`subscription ${sub.getSubject()} drained.`);\n    })(subscription);\n  }\n\n  static async publish(channel: string, message: any) {\n    if (!process.env.NATS_HOST) {\n      throw new Error(\"NATS_HOST ENV is not defined\");\n    }\n    const nc = await connect({ servers: process.env.NATS_HOST });\n    const jc = JSONCodec();\n    nc.publish(channel, jc.encode(message));\n    await nc.drain();\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\nexport interface Notification {\n  title?: string,\n  body: string,\n  badge?: number,\n  payload?: any,\n  target?: string\n}\nexport interface UserNotification extends Notification {\n  userId: string\n}\nexport interface DeviceNotification extends Notification {\n  deviceId: string\n}\nexport interface TopicNotification extends Notification {\n  topic: string,\n}\nexport interface SmsNotification extends Notification {\n  mobile: string,\n}\nexport interface StaffNotification extends Notification {\n  staffId: string\n  brandId: string\n}\n\nexport interface PrintLine {\n  text: string,\n  alignment: 'left' | 'center' | 'right',\n  size: 'normal' | 'large' | 'small',\n  weight: 'normal' | 'bold'\n}\n\nexport interface OperateOrderNotificationPayload {\n  orderId: string,\n  serveTo: string | null,\n  items: Array<{\n    name: string,\n    quantity: number,\n    price: number,\n    description: string | null\n  }>,\n  notes: string | null,\n  lines: PrintLine[]\n}\n\nexport interface OperateOrderNotification {\n  brandId: string,\n  branchId: string,\n  title: string,\n  body: string,\n  order: OperateOrderNotificationPayload\n}\n\nexport class MiaNotifications {\n  static async sendtoDevice(message: DeviceNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoUserDevices(message: UserNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoTopic(message: TopicNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoSms(message: SmsNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoStaff(message: StaffNotification) {\n    const topic = MiaNotifications.staffTopicFormatter(message.brandId, message.staffId);\n    await MiaNotifications.sendtoTopic({\n      topic,\n      title: message.title,\n      body: message.body,\n      badge: message.badge,\n      payload: message.payload,\n      target: message.target\n    });\n  }\n  static async sendOperateOrderNotification(message: OperateOrderNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, {\n      ...message,\n      type: 'operateOrder'\n    });\n  }\n  static topicFormatter = (topic: string) => \"/topics/\" + topic.replace(/\\//g, \"~\")\n  static operateOrderTopicFormatter = (brandId: string, branchId: string) =>\n    `~operate~orders~${brandId}~${branchId}`\n  static staffTopicFormatter = (brandId: string, staffId: string) =>\n    `/topics/~staff~${brandId}~${staffId}`\n}","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface CustomerMobileVerifiedMessage {\n  brandId: string;\n  customer: any;\n  isVerified: boolean;\n}\n\nexport interface CustomerActionMessage {\n  brandId: string;\n  type: string;\n  customer: any;\n  payload: any;\n}\n\nexport interface CustomerAddTagMessage {\n  brandId: string;\n  customer: any;\n  tag: string;\n  remove: boolean;\n}\n\nexport interface CustomerUpdateNotesMessage {\n  brandId: string;\n  customer: any;\n  newNotes: string;\n}\n\nexport class MicrogemsCustomer {\n  static async mobileVerified(message: CustomerMobileVerifiedMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async action(message: CustomerActionMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async addTag(message: CustomerAddTagMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async updateNotes(message: CustomerUpdateNotesMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n}","/**\n * Multilanguage String Type\n *\n * Represents text content that can be displayed in multiple languages.\n * Used across services for internationalization support.\n */\n\nexport interface MultilanguageString {\n  /**\n   * English text (required)\n   */\n  en: string;\n\n  /**\n   * Arabic text (optional)\n   */\n  ar?: string;\n}\n\n/**\n * Helper function to get text in preferred language with fallback\n *\n * @param text - Multilanguage string object\n * @param language - Preferred language ('en' | 'ar')\n * @returns Text in preferred language, or English if not available\n */\nexport function getLocalizedText(\n  text: MultilanguageString,\n  language: 'en' | 'ar' = 'en'\n): string {\n  if (language === 'ar' && text.ar) {\n    return text.ar;\n  }\n  return text.en;\n}\n\n/**\n * Helper function to create a multilanguage string from a plain string\n *\n * @param enText - English text\n * @param arText - Optional Arabic text\n * @returns MultilanguageString object\n */\nexport function createMultilanguageString(\n  enText: string,\n  arText?: string\n): MultilanguageString {\n  const result: MultilanguageString = { en: enText };\n  if (arText) {\n    result.ar = arText;\n  }\n  return result;\n}\n","/**\n * Order Item Attributes\n *\n * Shared types for order item customization attributes used across:\n * - menu API (for menu item attributes)\n * - schedule API (for appointment service attributes)\n * - transactions API (for order item attributes)\n */\n\n/**\n * Single attribute value option\n */\nexport interface AttributeValue {\n  /**\n   * Unique identifier for this value option\n   */\n  id: string;\n\n  /**\n   * Display name of the value\n   */\n  name: string;\n\n  /**\n   * Additional price for selecting this value (0 if no extra cost)\n   */\n  price: number;\n\n  /**\n   * Whether this value is available/in-stock\n   */\n  isAvailable?: boolean;\n}\n\n/**\n * Attribute definition (e.g., \"Size\", \"Color\", \"Extras\")\n */\nexport interface OrderAttribute {\n  /**\n   * Unique identifier for this attribute\n   */\n  id: string;\n\n  /**\n   * Attribute name (e.g., \"Size\", \"Toppings\")\n   */\n  name: string;\n\n  /**\n   * Available values for this attribute\n   */\n  values: AttributeValue[];\n\n  /**\n   * Whether customer must select a value for this attribute\n   */\n  required?: boolean;\n\n  /**\n   * Allow multiple values to be selected (e.g., multiple toppings)\n   */\n  allowMultiple?: boolean;\n\n  /**\n   * Minimum number of selections (if allowMultiple = true)\n   */\n  minSelections?: number;\n\n  /**\n   * Maximum number of selections (if allowMultiple = true)\n   */\n  maxSelections?: number;\n}\n\n/**\n * Selected attribute for an order item\n * (What the customer actually selected)\n */\nexport interface SelectedOrderAttribute {\n  /**\n   * Reference to the attribute definition\n   */\n  attributeId: string;\n\n  /**\n   * Attribute name (denormalized for display)\n   */\n  attributeName: string;\n\n  /**\n   * Selected value(s)\n   */\n  selectedValues: {\n    /**\n     * Value ID\n     */\n    id: string;\n\n    /**\n     * Value name (denormalized for display)\n     */\n    name: string;\n\n    /**\n     * Price of this selected value\n     */\n    price: number;\n  }[];\n\n  /**\n   * Total price for this attribute (sum of all selected values)\n   */\n  totalPrice: number;\n}\n\n/**\n * Array of selected attributes for an order item\n * This is what gets stored in Appointment.orderItemAttributes or Order.items[].attributes\n */\nexport type OrderItemAttributes = SelectedOrderAttribute[];\n\n/**\n * Helper function to calculate total price from selected attributes\n *\n * @param attributes - Array of selected attributes\n * @returns Total additional price from all attributes\n */\nexport function calculateAttributesPrice(\n  attributes: OrderItemAttributes\n): number {\n  return attributes.reduce((total, attr) => total + attr.totalPrice, 0);\n}\n\n/**\n * Helper function to validate selected attributes against definitions\n *\n * @param selected - Selected attributes\n * @param definitions - Attribute definitions\n * @returns Validation result with any errors\n */\nexport function validateSelectedAttributes(\n  selected: OrderItemAttributes,\n  definitions: OrderAttribute[]\n): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n\n  // Check required attributes\n  for (const def of definitions) {\n    if (def.required) {\n      const selectedAttr = selected.find((s) => s.attributeId === def.id);\n      if (!selectedAttr || selectedAttr.selectedValues.length === 0) {\n        errors.push(`Attribute \"${def.name}\" is required`);\n      }\n    }\n  }\n\n  // Check selection counts\n  for (const selectedAttr of selected) {\n    const def = definitions.find((d) => d.id === selectedAttr.attributeId);\n    if (!def) {\n      errors.push(`Unknown attribute: ${selectedAttr.attributeName}`);\n      continue;\n    }\n\n    const count = selectedAttr.selectedValues.length;\n\n    if (!def.allowMultiple && count > 1) {\n      errors.push(`Attribute \"${def.name}\" allows only one selection`);\n    }\n\n    if (def.minSelections && count < def.minSelections) {\n      errors.push(\n        `Attribute \"${def.name}\" requires at least ${def.minSelections} selections`\n      );\n    }\n\n    if (def.maxSelections && count > def.maxSelections) {\n      errors.push(\n        `Attribute \"${def.name}\" allows at most ${def.maxSelections} selections`\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport type ServiceType = 'MENU' | 'APPOINTMENT' | 'CREDIT_BUNDLE';\n\n// ZATCA-compliant buyer identification schemes for BR-KSA-81\nexport type BuyerIdentificationScheme = 'TIN'|'CRN'|'MOM'|'MLS'|'700'|'SAG'|'NAT'|'GCC'|'IQA'|'PAS'|'OTH';\n\nexport interface OrderItemForInvoice {\n  idInService: string;\n  name: string;\n  description?: string;\n  price: number;\n  quantity: number;\n  vatRate?: number;\n  invoicable?: boolean;  // defaults to true; set to false for items already paid (e.g., package redemptions)\n  orderAttributes?: { id?: string; name: string; price: number; quantity?: number }[];\n}\n\nexport interface PaymentInfo {\n  type: string;\n  amount: number;\n  reference?: string;\n}\n\n// Fee information for ZATCA invoice charges\nexport interface OrderFeeInfo {\n  feeId?: string;\n  name: string;\n  type: string;\n  value: number;\n  calculatedAmount: number; // VAT-inclusive amount\n}\n\nexport interface CustomerInfo {\n  name?: string;\n  phoneNumber?: string;\n  countryCode?: string;\n  email?: string;\n  vatNumber?: string;\n  crNumber?: string;\n  streetName?: string;\n  buildingNumber?: string;\n  cityName?: string;\n  postalZone?: string;\n  district?: string;\n  identificationNumber?: string;\n  identificationScheme?: BuyerIdentificationScheme;\n}\n\nexport interface OrderCreatedEvent {\n  orderId: string;\n  brandId: string;\n  branchId?: string;\n  source: ServiceType;\n  subtotal: number;\n  vatAmount: number;\n  vatPercentage?: number;\n  total: number;\n  items: OrderItemForInvoice[];\n  payments: PaymentInfo[];\n  customerInfo?: CustomerInfo;\n  dailyOrderNumber?: number;\n  yearlyOrderNumber?: number;\n  createdAt: Date;\n  additionalFees?: OrderFeeInfo[]; // Order-level fees (minimum order, service, delivery, etc.)\n}\n\nexport class MiaOrders {\n  static async publishOrderCreated(event: OrderCreatedEvent): Promise<void> {\n    await MessagingBus.publish('mia.orders.created', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface ShiftClosedEvent {\n  shiftId: string;\n  brandId: string;\n  branchId: string;\n  staffId: string;\n  openedAt: string;\n  closedAt: string;\n  initialCash: number;\n  expectedCash: number;\n  closingCash: number;\n  paymentSummary: Array<{ type: string; total: number; count: number }>;\n  refundSummary: Array<{ type: string; total: number; count: number }>;\n  totalRefunds: number;\n  closingNotes?: string;\n  staffName?: string;\n}\n\nexport class MiaShifts {\n  static async publishShiftClosed(event: ShiftClosedEvent): Promise<void> {\n    await MessagingBus.publish('mia.shifts.closed', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface CriticalErrorEvent {\n  brandId: string;\n  branchId?: string;\n  service: string;\n  errorType: string;\n  summary: string;\n  details: string;\n  resourceId?: string;\n  resourceType?: string;\n  occurredAt: string;\n}\n\nexport class MiaCriticalErrors {\n  static async publish(event: CriticalErrorEvent): Promise<void> {\n    await MessagingBus.publish('mia.errors.critical', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport type AuditRiskLevel = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';\n\nexport interface AuditTraceEvent {\n  action: string;\n  riskLevel: AuditRiskLevel;\n  service: string;\n  staffId?: string;\n  staffRole?: string;\n  brandId: string;\n  branchId?: string;\n  financialImpact?: {\n    amount: number;\n    currency: string;\n  };\n  objectRef?: {\n    collection: string;\n    id: string;\n    snapshot?: Record<string, any>;\n  };\n  details?: string;\n  metadata?: Record<string, any>;\n  performedAt?: string;\n}\n\nexport class MiaAuditTrace {\n  static async publish(event: AuditTraceEvent): Promise<void> {\n    await MessagingBus.publish('mia.audit.trace', {\n      ...event,\n      performedAt: event.performedAt || new Date().toISOString(),\n    });\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/mia-server-response.ts","../src/messaging-bus.ts","../src/notifications.ts","../src/customers.ts","../src/multilanguage.ts","../src/order-attributes.ts","../src/orders.ts","../src/shifts.ts","../src/critical-errors.ts","../src/audit-trace.ts","../src/stock.ts"],"sourcesContent":["export * from './mia-server-response'\nexport * from './notifications'\nexport * from './messaging-bus'\nexport * from './customers'\nexport * from './multilanguage'\nexport * from './order-attributes'\nexport * from './orders'\nexport * from './shifts'\nexport * from './critical-errors'\nexport * from './audit-trace'\nexport * from './stock'\n","export class MiaServerResponse {\n  status?: number;\n  message?: string;\n  data: any;\n\n  static send = (status: number, message: string, data: any) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: message,\n      data: data\n    };\n    return response;\n  }\n  static sendData = (data: any, status: number = 200) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: \"Success\",\n      data: data\n    };\n    return response;\n  }\n  static sendError = (error: any, status: number = 400) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: \"Failed\",\n      data: error\n    };\n    return response;\n  }\n}\n","import { connect, JSONCodec } from \"nats\";\n\nexport class MessagingBus {\n  static async subscribe(channel: string, queue: string, onMessage: Function) {\n    if (!process.env.NATS_HOST) {\n      throw new Error(\"NATS_HOST ENV is not defined\");\n    }\n    const nc = await connect({ servers: process.env.NATS_HOST });\n    const sc = JSONCodec();\n    const subscription = nc.subscribe(channel, { queue: queue });\n\n    (async (sub) => {\n\n      console.log(`listening for ${sub.getSubject()} requests...`);\n\n      for await (const m of sub) {\n        const msg = sc.decode(m.data);\n        onMessage(msg);\n      }\n\n      console.log(`subscription ${sub.getSubject()} drained.`);\n    })(subscription);\n  }\n\n  static async publish(channel: string, message: any) {\n    if (!process.env.NATS_HOST) {\n      throw new Error(\"NATS_HOST ENV is not defined\");\n    }\n    const nc = await connect({ servers: process.env.NATS_HOST });\n    const jc = JSONCodec();\n    nc.publish(channel, jc.encode(message));\n    await nc.drain();\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\nexport interface Notification {\n  title?: string,\n  body: string,\n  badge?: number,\n  payload?: any,\n  target?: string\n}\nexport interface UserNotification extends Notification {\n  userId: string\n}\nexport interface DeviceNotification extends Notification {\n  deviceId: string\n}\nexport interface TopicNotification extends Notification {\n  topic: string,\n}\nexport interface SmsNotification extends Notification {\n  mobile: string,\n}\nexport interface StaffNotification extends Notification {\n  staffId: string\n  brandId: string\n}\n\nexport interface PrintLine {\n  text: string,\n  alignment: 'left' | 'center' | 'right',\n  size: 'normal' | 'large' | 'small',\n  weight: 'normal' | 'bold'\n}\n\nexport interface OperateOrderNotificationPayload {\n  orderId: string,\n  serveTo: string | null,\n  items: Array<{\n    name: string,\n    quantity: number,\n    price: number,\n    description: string | null\n  }>,\n  notes: string | null,\n  lines: PrintLine[]\n}\n\nexport interface OperateOrderNotification {\n  brandId: string,\n  branchId: string,\n  title: string,\n  body: string,\n  order: OperateOrderNotificationPayload\n}\n\nexport class MiaNotifications {\n  static async sendtoDevice(message: DeviceNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoUserDevices(message: UserNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoTopic(message: TopicNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoSms(message: SmsNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoStaff(message: StaffNotification) {\n    const topic = MiaNotifications.staffTopicFormatter(message.brandId, message.staffId);\n    await MiaNotifications.sendtoTopic({\n      topic,\n      title: message.title,\n      body: message.body,\n      badge: message.badge,\n      payload: message.payload,\n      target: message.target\n    });\n  }\n  static async sendOperateOrderNotification(message: OperateOrderNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, {\n      ...message,\n      type: 'operateOrder'\n    });\n  }\n  static topicFormatter = (topic: string) => \"/topics/\" + topic.replace(/\\//g, \"~\")\n  static operateOrderTopicFormatter = (brandId: string, branchId: string) =>\n    `~operate~orders~${brandId}~${branchId}`\n  static staffTopicFormatter = (brandId: string, staffId: string) =>\n    `/topics/~staff~${brandId}~${staffId}`\n}","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface CustomerMobileVerifiedMessage {\n  brandId: string;\n  customer: any;\n  isVerified: boolean;\n}\n\nexport interface CustomerActionMessage {\n  brandId: string;\n  type: string;\n  customer: any;\n  payload: any;\n}\n\nexport interface CustomerAddTagMessage {\n  brandId: string;\n  customer: any;\n  tag: string;\n  remove: boolean;\n}\n\nexport interface CustomerUpdateNotesMessage {\n  brandId: string;\n  customer: any;\n  newNotes: string;\n}\n\nexport class MicrogemsCustomer {\n  static async mobileVerified(message: CustomerMobileVerifiedMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async action(message: CustomerActionMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async addTag(message: CustomerAddTagMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async updateNotes(message: CustomerUpdateNotesMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n}","/**\n * Multilanguage String Type\n *\n * Represents text content that can be displayed in multiple languages.\n * Used across services for internationalization support.\n */\n\nexport interface MultilanguageString {\n  /**\n   * English text (required)\n   */\n  en: string;\n\n  /**\n   * Arabic text (optional)\n   */\n  ar?: string;\n}\n\n/**\n * Helper function to get text in preferred language with fallback\n *\n * @param text - Multilanguage string object\n * @param language - Preferred language ('en' | 'ar')\n * @returns Text in preferred language, or English if not available\n */\nexport function getLocalizedText(\n  text: MultilanguageString,\n  language: 'en' | 'ar' = 'en'\n): string {\n  if (language === 'ar' && text.ar) {\n    return text.ar;\n  }\n  return text.en;\n}\n\n/**\n * Helper function to create a multilanguage string from a plain string\n *\n * @param enText - English text\n * @param arText - Optional Arabic text\n * @returns MultilanguageString object\n */\nexport function createMultilanguageString(\n  enText: string,\n  arText?: string\n): MultilanguageString {\n  const result: MultilanguageString = { en: enText };\n  if (arText) {\n    result.ar = arText;\n  }\n  return result;\n}\n","/**\n * Order Item Attributes\n *\n * Shared types for order item customization attributes used across:\n * - menu API (for menu item attributes)\n * - schedule API (for appointment service attributes)\n * - transactions API (for order item attributes)\n */\n\n/**\n * Single attribute value option\n */\nexport interface AttributeValue {\n  /**\n   * Unique identifier for this value option\n   */\n  id: string;\n\n  /**\n   * Display name of the value\n   */\n  name: string;\n\n  /**\n   * Additional price for selecting this value (0 if no extra cost)\n   */\n  price: number;\n\n  /**\n   * Whether this value is available/in-stock\n   */\n  isAvailable?: boolean;\n}\n\n/**\n * Attribute definition (e.g., \"Size\", \"Color\", \"Extras\")\n */\nexport interface OrderAttribute {\n  /**\n   * Unique identifier for this attribute\n   */\n  id: string;\n\n  /**\n   * Attribute name (e.g., \"Size\", \"Toppings\")\n   */\n  name: string;\n\n  /**\n   * Available values for this attribute\n   */\n  values: AttributeValue[];\n\n  /**\n   * Whether customer must select a value for this attribute\n   */\n  required?: boolean;\n\n  /**\n   * Allow multiple values to be selected (e.g., multiple toppings)\n   */\n  allowMultiple?: boolean;\n\n  /**\n   * Minimum number of selections (if allowMultiple = true)\n   */\n  minSelections?: number;\n\n  /**\n   * Maximum number of selections (if allowMultiple = true)\n   */\n  maxSelections?: number;\n}\n\n/**\n * Selected attribute for an order item\n * (What the customer actually selected)\n */\nexport interface SelectedOrderAttribute {\n  /**\n   * Reference to the attribute definition\n   */\n  attributeId: string;\n\n  /**\n   * Attribute name (denormalized for display)\n   */\n  attributeName: string;\n\n  /**\n   * Selected value(s)\n   */\n  selectedValues: {\n    /**\n     * Value ID\n     */\n    id: string;\n\n    /**\n     * Value name (denormalized for display)\n     */\n    name: string;\n\n    /**\n     * Price of this selected value\n     */\n    price: number;\n  }[];\n\n  /**\n   * Total price for this attribute (sum of all selected values)\n   */\n  totalPrice: number;\n}\n\n/**\n * Array of selected attributes for an order item\n * This is what gets stored in Appointment.orderItemAttributes or Order.items[].attributes\n */\nexport type OrderItemAttributes = SelectedOrderAttribute[];\n\n/**\n * Helper function to calculate total price from selected attributes\n *\n * @param attributes - Array of selected attributes\n * @returns Total additional price from all attributes\n */\nexport function calculateAttributesPrice(\n  attributes: OrderItemAttributes\n): number {\n  return attributes.reduce((total, attr) => total + attr.totalPrice, 0);\n}\n\n/**\n * Helper function to validate selected attributes against definitions\n *\n * @param selected - Selected attributes\n * @param definitions - Attribute definitions\n * @returns Validation result with any errors\n */\nexport function validateSelectedAttributes(\n  selected: OrderItemAttributes,\n  definitions: OrderAttribute[]\n): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n\n  // Check required attributes\n  for (const def of definitions) {\n    if (def.required) {\n      const selectedAttr = selected.find((s) => s.attributeId === def.id);\n      if (!selectedAttr || selectedAttr.selectedValues.length === 0) {\n        errors.push(`Attribute \"${def.name}\" is required`);\n      }\n    }\n  }\n\n  // Check selection counts\n  for (const selectedAttr of selected) {\n    const def = definitions.find((d) => d.id === selectedAttr.attributeId);\n    if (!def) {\n      errors.push(`Unknown attribute: ${selectedAttr.attributeName}`);\n      continue;\n    }\n\n    const count = selectedAttr.selectedValues.length;\n\n    if (!def.allowMultiple && count > 1) {\n      errors.push(`Attribute \"${def.name}\" allows only one selection`);\n    }\n\n    if (def.minSelections && count < def.minSelections) {\n      errors.push(\n        `Attribute \"${def.name}\" requires at least ${def.minSelections} selections`\n      );\n    }\n\n    if (def.maxSelections && count > def.maxSelections) {\n      errors.push(\n        `Attribute \"${def.name}\" allows at most ${def.maxSelections} selections`\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport type ServiceType = 'MENU' | 'APPOINTMENT' | 'CREDIT_BUNDLE';\n\n// ZATCA-compliant buyer identification schemes for BR-KSA-81\nexport type BuyerIdentificationScheme = 'TIN'|'CRN'|'MOM'|'MLS'|'700'|'SAG'|'NAT'|'GCC'|'IQA'|'PAS'|'OTH';\n\nexport interface OrderItemForInvoice {\n  idInService: string;\n  name: string;\n  description?: string;\n  price: number;\n  quantity: number;\n  vatRate?: number;\n  invoicable?: boolean;  // defaults to true; set to false for items already paid (e.g., package redemptions)\n  orderAttributes?: { id?: string; name: string; price: number; quantity?: number }[];\n}\n\nexport interface PaymentInfo {\n  type: string;\n  amount: number;\n  reference?: string;\n}\n\n// Fee information for ZATCA invoice charges\nexport interface OrderFeeInfo {\n  feeId?: string;\n  name: string;\n  type: string;\n  value: number;\n  calculatedAmount: number; // VAT-inclusive amount\n}\n\nexport interface CustomerInfo {\n  name?: string;\n  phoneNumber?: string;\n  countryCode?: string;\n  email?: string;\n  vatNumber?: string;\n  crNumber?: string;\n  streetName?: string;\n  buildingNumber?: string;\n  cityName?: string;\n  postalZone?: string;\n  district?: string;\n  identificationNumber?: string;\n  identificationScheme?: BuyerIdentificationScheme;\n}\n\nexport interface OrderCreatedEvent {\n  orderId: string;\n  brandId: string;\n  branchId?: string;\n  source: ServiceType;\n  subtotal: number;\n  vatAmount: number;\n  vatPercentage?: number;\n  total: number;\n  items: OrderItemForInvoice[];\n  payments: PaymentInfo[];\n  customerInfo?: CustomerInfo;\n  dailyOrderNumber?: number;\n  yearlyOrderNumber?: number;\n  createdAt: Date;\n  additionalFees?: OrderFeeInfo[]; // Order-level fees (minimum order, service, delivery, etc.)\n}\n\nexport class MiaOrders {\n  static async publishOrderCreated(event: OrderCreatedEvent): Promise<void> {\n    await MessagingBus.publish('mia.orders.created', event);\n  }\n}\n\nexport interface PreorderPaymentEvent {\n  preorderId: string;\n  sourceId: string;\n  source: ServiceType;\n  brandId: string;\n  branchId?: string;\n  payment: PaymentInfo;\n  totalPaid: number;\n  total: number;\n  isFullyPaid: boolean;\n  orderId?: string;\n}\n\nexport class MiaPreorders {\n  static async publishPaymentAdded(event: PreorderPaymentEvent): Promise<void> {\n    await MessagingBus.publish('mia.preorders.payment-added', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface ShiftClosedEvent {\n  shiftId: string;\n  brandId: string;\n  branchId: string;\n  staffId: string;\n  openedAt: string;\n  closedAt: string;\n  initialCash: number;\n  expectedCash: number;\n  closingCash: number;\n  paymentSummary: Array<{ type: string; total: number; count: number }>;\n  refundSummary: Array<{ type: string; total: number; count: number }>;\n  totalRefunds: number;\n  closingNotes?: string;\n  staffName?: string;\n}\n\nexport class MiaShifts {\n  static async publishShiftClosed(event: ShiftClosedEvent): Promise<void> {\n    await MessagingBus.publish('mia.shifts.closed', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface CriticalErrorEvent {\n  brandId: string;\n  branchId?: string;\n  service: string;\n  errorType: string;\n  summary: string;\n  details: string;\n  resourceId?: string;\n  resourceType?: string;\n  occurredAt: string;\n}\n\nexport class MiaCriticalErrors {\n  static async publish(event: CriticalErrorEvent): Promise<void> {\n    await MessagingBus.publish('mia.errors.critical', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport type AuditRiskLevel = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';\n\nexport interface AuditTraceEvent {\n  action: string;\n  riskLevel: AuditRiskLevel;\n  service: string;\n  staffId?: string;\n  staffRole?: string;\n  brandId: string;\n  branchId?: string;\n  financialImpact?: {\n    amount: number;\n    currency: string;\n  };\n  objectRef?: {\n    collection: string;\n    id: string;\n    snapshot?: Record<string, any>;\n  };\n  details?: string;\n  metadata?: Record<string, any>;\n  performedAt?: string;\n}\n\nexport class MiaAuditTrace {\n  static async publish(event: AuditTraceEvent): Promise<void> {\n    await MessagingBus.publish('mia.audit.trace', {\n      ...event,\n      performedAt: event.performedAt || new Date().toISOString(),\n    });\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface LowStockEvent {\n  brandId: string;\n  branchId: string;\n  rawMaterialId: string;\n  materialName: string;\n  currentQuantity: number;\n  lowThreshold: number;\n  unit: string;\n}\n\nexport class MiaStock {\n  static async publishLowStockAlert(event: LowStockEvent): Promise<void> {\n    await MessagingBus.publish('mia.menu.stock.low', event);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,oBAAN,MAAwB;AA6B/B;AA7Ba,kBAKJ,OAAO,CAAC,QAAgB,SAAiB,SAAc;AAC5D,QAAM,WAA8B;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,SAAO;AACT;AAZW,kBAaJ,WAAW,CAAC,MAAW,SAAiB,QAAQ;AACrD,QAAM,WAA8B;AAAA,IAClC;AAAA,IACA,SAAS;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AApBW,kBAqBJ,YAAY,CAAC,OAAY,SAAiB,QAAQ;AACvD,QAAM,WAA8B;AAAA,IAClC;AAAA,IACA,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AACA,SAAO;AACT;;;AC5BF,kBAAmC;AAE5B,IAAM,eAAN,MAAmB;AAAA,EACxB,OAAa,UAAU,SAAiB,OAAe,WAAqB;AAAA;AAC1E,UAAI,CAAC,QAAQ,IAAI,WAAW;AAC1B,cAAM,IAAI,MAAM,8BAA8B;AAAA,MAChD;AACA,YAAM,KAAK,UAAM,qBAAQ,EAAE,SAAS,QAAQ,IAAI,UAAU,CAAC;AAC3D,YAAM,SAAK,uBAAU;AACrB,YAAM,eAAe,GAAG,UAAU,SAAS,EAAE,MAAa,CAAC;AAE3D,OAAC,CAAO,QAAQ;AAEd,gBAAQ,IAAI,iBAAiB,IAAI,WAAW,CAAC,cAAc;AAE3D;AAAA,qCAAsB,MAAtB,0EAA2B;AAAhB,kBAAM,IAAjB;AACE,kBAAM,MAAM,GAAG,OAAO,EAAE,IAAI;AAC5B,sBAAU,GAAG;AAAA,UACf;AAAA,iBAHA,MAfN;AAeM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,gBAAQ,IAAI,gBAAgB,IAAI,WAAW,CAAC,WAAW;AAAA,MACzD,IAAG,YAAY;AAAA,IACjB;AAAA;AAAA,EAEA,OAAa,QAAQ,SAAiB,SAAc;AAAA;AAClD,UAAI,CAAC,QAAQ,IAAI,WAAW;AAC1B,cAAM,IAAI,MAAM,8BAA8B;AAAA,MAChD;AACA,YAAM,KAAK,UAAM,qBAAQ,EAAE,SAAS,QAAQ,IAAI,UAAU,CAAC;AAC3D,YAAM,SAAK,uBAAU;AACrB,SAAG,QAAQ,SAAS,GAAG,OAAO,OAAO,CAAC;AACtC,YAAM,GAAG,MAAM;AAAA,IACjB;AAAA;AACF;;;ACoBO,IAAM,oBAAN,MAAM,kBAAiB;AAAA,EAC5B,OAAa,aAAa,SAA6B;AAAA;AACrD,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC9F;AAAA;AAAA,EACA,OAAa,kBAAkB,SAA2B;AAAA;AACxD,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC9F;AAAA;AAAA,EACA,OAAa,YAAY,SAA4B;AAAA;AACnD,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC9F;AAAA;AAAA,EACA,OAAa,UAAU,SAA0B;AAAA;AAC/C,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC9F;AAAA;AAAA,EACA,OAAa,YAAY,SAA4B;AAAA;AACnD,YAAM,QAAQ,kBAAiB,oBAAoB,QAAQ,SAAS,QAAQ,OAAO;AACnF,YAAM,kBAAiB,YAAY;AAAA,QACjC;AAAA,QACA,OAAO,QAAQ;AAAA,QACf,MAAM,QAAQ;AAAA,QACd,OAAO,QAAQ;AAAA,QACf,SAAS,QAAQ;AAAA,QACjB,QAAQ,QAAQ;AAAA,MAClB,CAAC;AAAA,IACH;AAAA;AAAA,EACA,OAAa,6BAA6B,SAAmC;AAAA;AAC3E,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,iCAChF,UADgF;AAAA,QAEnF,MAAM;AAAA,MACR,EAAC;AAAA,IACH;AAAA;AAMF;AAnCa,kBA8BJ,iBAAiB,CAAC,UAAkB,aAAa,MAAM,QAAQ,OAAO,GAAG;AA9BrE,kBA+BJ,6BAA6B,CAAC,SAAiB,aACpD,mBAAmB,OAAO,IAAI,QAAQ;AAhC7B,kBAiCJ,sBAAsB,CAAC,SAAiB,YAC7C,kBAAkB,OAAO,IAAI,OAAO;AAlCjC,IAAM,mBAAN;;;ACzBA,IAAM,oBAAN,MAAwB;AAAA,EAC7B,OAAa,eAAe,SAAwC;AAAA;AAClE,YAAM,aAAa,QAAQ,iBAAiB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC1F;AAAA;AAAA,EAEA,OAAa,OAAO,SAAgC;AAAA;AAClD,YAAM,aAAa,QAAQ,iBAAiB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC1F;AAAA;AAAA,EAEA,OAAa,OAAO,SAAgC;AAAA;AAClD,YAAM,aAAa,QAAQ,iBAAiB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC1F;AAAA;AAAA,EAEA,OAAa,YAAY,SAAqC;AAAA;AAC5D,YAAM,aAAa,QAAQ,iBAAiB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC1F;AAAA;AACF;;;AClBO,SAAS,iBACd,MACA,WAAwB,MAChB;AACR,MAAI,aAAa,QAAQ,KAAK,IAAI;AAChC,WAAO,KAAK;AAAA,EACd;AACA,SAAO,KAAK;AACd;AASO,SAAS,0BACd,QACA,QACqB;AACrB,QAAM,SAA8B,EAAE,IAAI,OAAO;AACjD,MAAI,QAAQ;AACV,WAAO,KAAK;AAAA,EACd;AACA,SAAO;AACT;;;AC2EO,SAAS,yBACd,YACQ;AACR,SAAO,WAAW,OAAO,CAAC,OAAO,SAAS,QAAQ,KAAK,YAAY,CAAC;AACtE;AASO,SAAS,2BACd,UACA,aACsC;AACtC,QAAM,SAAmB,CAAC;AAG1B,aAAW,OAAO,aAAa;AAC7B,QAAI,IAAI,UAAU;AAChB,YAAM,eAAe,SAAS,KAAK,CAAC,MAAM,EAAE,gBAAgB,IAAI,EAAE;AAClE,UAAI,CAAC,gBAAgB,aAAa,eAAe,WAAW,GAAG;AAC7D,eAAO,KAAK,cAAc,IAAI,IAAI,eAAe;AAAA,MACnD;AAAA,IACF;AAAA,EACF;AAGA,aAAW,gBAAgB,UAAU;AACnC,UAAM,MAAM,YAAY,KAAK,CAAC,MAAM,EAAE,OAAO,aAAa,WAAW;AACrE,QAAI,CAAC,KAAK;AACR,aAAO,KAAK,sBAAsB,aAAa,aAAa,EAAE;AAC9D;AAAA,IACF;AAEA,UAAM,QAAQ,aAAa,eAAe;AAE1C,QAAI,CAAC,IAAI,iBAAiB,QAAQ,GAAG;AACnC,aAAO,KAAK,cAAc,IAAI,IAAI,6BAA6B;AAAA,IACjE;AAEA,QAAI,IAAI,iBAAiB,QAAQ,IAAI,eAAe;AAClD,aAAO;AAAA,QACL,cAAc,IAAI,IAAI,uBAAuB,IAAI,aAAa;AAAA,MAChE;AAAA,IACF;AAEA,QAAI,IAAI,iBAAiB,QAAQ,IAAI,eAAe;AAClD,aAAO;AAAA,QACL,cAAc,IAAI,IAAI,oBAAoB,IAAI,aAAa;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,OAAO,WAAW;AAAA,IACzB;AAAA,EACF;AACF;;;ACxHO,IAAM,YAAN,MAAgB;AAAA,EACrB,OAAa,oBAAoB,OAAyC;AAAA;AACxE,YAAM,aAAa,QAAQ,sBAAsB,KAAK;AAAA,IACxD;AAAA;AACF;AAeO,IAAM,eAAN,MAAmB;AAAA,EACxB,OAAa,oBAAoB,OAA4C;AAAA;AAC3E,YAAM,aAAa,QAAQ,+BAA+B,KAAK;AAAA,IACjE;AAAA;AACF;;;ACvEO,IAAM,YAAN,MAAgB;AAAA,EACrB,OAAa,mBAAmB,OAAwC;AAAA;AACtE,YAAM,aAAa,QAAQ,qBAAqB,KAAK;AAAA,IACvD;AAAA;AACF;;;ACTO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,OAAa,QAAQ,OAA0C;AAAA;AAC7D,YAAM,aAAa,QAAQ,uBAAuB,KAAK;AAAA,IACzD;AAAA;AACF;;;ACQO,IAAM,gBAAN,MAAoB;AAAA,EACzB,OAAa,QAAQ,OAAuC;AAAA;AAC1D,YAAM,aAAa,QAAQ,mBAAmB,iCACzC,QADyC;AAAA,QAE5C,aAAa,MAAM,gBAAe,oBAAI,KAAK,GAAE,YAAY;AAAA,MAC3D,EAAC;AAAA,IACH;AAAA;AACF;;;ACrBO,IAAM,WAAN,MAAe;AAAA,EACpB,OAAa,qBAAqB,OAAqC;AAAA;AACrE,YAAM,aAAa,QAAQ,sBAAsB,KAAK;AAAA,IACxD;AAAA;AACF;","names":[]}

package/dist/index.mjs

@@ -252,6 +252,13 @@ var MiaOrders = class {
     });
   }
 };
+var MiaPreorders = class {
+  static publishPaymentAdded(event) {
+    return __async(this, null, function* () {
+      yield MessagingBus.publish("mia.preorders.payment-added", event);
+    });
+  }
+};
 
 // src/shifts.ts
 var MiaShifts = class {
@@ -281,14 +288,25 @@ var MiaAuditTrace = class {
     });
   }
 };
+
+// src/stock.ts
+var MiaStock = class {
+  static publishLowStockAlert(event) {
+    return __async(this, null, function* () {
+      yield MessagingBus.publish("mia.menu.stock.low", event);
+    });
+  }
+};
 export {
   MessagingBus,
   MiaAuditTrace,
   MiaCriticalErrors,
   MiaNotifications,
   MiaOrders,
+  MiaPreorders,
   MiaServerResponse,
   MiaShifts,
+  MiaStock,
   MicrogemsCustomer,
   calculateAttributesPrice,
   createMultilanguageString,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mia-server-response.ts","../src/messaging-bus.ts","../src/notifications.ts","../src/customers.ts","../src/multilanguage.ts","../src/order-attributes.ts","../src/orders.ts","../src/shifts.ts","../src/critical-errors.ts","../src/audit-trace.ts"],"sourcesContent":["export class MiaServerResponse {\n  status?: number;\n  message?: string;\n  data: any;\n\n  static send = (status: number, message: string, data: any) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: message,\n      data: data\n    };\n    return response;\n  }\n  static sendData = (data: any, status: number = 200) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: \"Success\",\n      data: data\n    };\n    return response;\n  }\n  static sendError = (error: any, status: number = 400) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: \"Failed\",\n      data: error\n    };\n    return response;\n  }\n}\n","import { connect, JSONCodec } from \"nats\";\n\nexport class MessagingBus {\n  static async subscribe(channel: string, queue: string, onMessage: Function) {\n    if (!process.env.NATS_HOST) {\n      throw new Error(\"NATS_HOST ENV is not defined\");\n    }\n    const nc = await connect({ servers: process.env.NATS_HOST });\n    const sc = JSONCodec();\n    const subscription = nc.subscribe(channel, { queue: queue });\n\n    (async (sub) => {\n\n      console.log(`listening for ${sub.getSubject()} requests...`);\n\n      for await (const m of sub) {\n        const msg = sc.decode(m.data);\n        onMessage(msg);\n      }\n\n      console.log(`subscription ${sub.getSubject()} drained.`);\n    })(subscription);\n  }\n\n  static async publish(channel: string, message: any) {\n    if (!process.env.NATS_HOST) {\n      throw new Error(\"NATS_HOST ENV is not defined\");\n    }\n    const nc = await connect({ servers: process.env.NATS_HOST });\n    const jc = JSONCodec();\n    nc.publish(channel, jc.encode(message));\n    await nc.drain();\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\nexport interface Notification {\n  title?: string,\n  body: string,\n  badge?: number,\n  payload?: any,\n  target?: string\n}\nexport interface UserNotification extends Notification {\n  userId: string\n}\nexport interface DeviceNotification extends Notification {\n  deviceId: string\n}\nexport interface TopicNotification extends Notification {\n  topic: string,\n}\nexport interface SmsNotification extends Notification {\n  mobile: string,\n}\nexport interface StaffNotification extends Notification {\n  staffId: string\n  brandId: string\n}\n\nexport interface PrintLine {\n  text: string,\n  alignment: 'left' | 'center' | 'right',\n  size: 'normal' | 'large' | 'small',\n  weight: 'normal' | 'bold'\n}\n\nexport interface OperateOrderNotificationPayload {\n  orderId: string,\n  serveTo: string | null,\n  items: Array<{\n    name: string,\n    quantity: number,\n    price: number,\n    description: string | null\n  }>,\n  notes: string | null,\n  lines: PrintLine[]\n}\n\nexport interface OperateOrderNotification {\n  brandId: string,\n  branchId: string,\n  title: string,\n  body: string,\n  order: OperateOrderNotificationPayload\n}\n\nexport class MiaNotifications {\n  static async sendtoDevice(message: DeviceNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoUserDevices(message: UserNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoTopic(message: TopicNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoSms(message: SmsNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoStaff(message: StaffNotification) {\n    const topic = MiaNotifications.staffTopicFormatter(message.brandId, message.staffId);\n    await MiaNotifications.sendtoTopic({\n      topic,\n      title: message.title,\n      body: message.body,\n      badge: message.badge,\n      payload: message.payload,\n      target: message.target\n    });\n  }\n  static async sendOperateOrderNotification(message: OperateOrderNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, {\n      ...message,\n      type: 'operateOrder'\n    });\n  }\n  static topicFormatter = (topic: string) => \"/topics/\" + topic.replace(/\\//g, \"~\")\n  static operateOrderTopicFormatter = (brandId: string, branchId: string) =>\n    `~operate~orders~${brandId}~${branchId}`\n  static staffTopicFormatter = (brandId: string, staffId: string) =>\n    `/topics/~staff~${brandId}~${staffId}`\n}","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface CustomerMobileVerifiedMessage {\n  brandId: string;\n  customer: any;\n  isVerified: boolean;\n}\n\nexport interface CustomerActionMessage {\n  brandId: string;\n  type: string;\n  customer: any;\n  payload: any;\n}\n\nexport interface CustomerAddTagMessage {\n  brandId: string;\n  customer: any;\n  tag: string;\n  remove: boolean;\n}\n\nexport interface CustomerUpdateNotesMessage {\n  brandId: string;\n  customer: any;\n  newNotes: string;\n}\n\nexport class MicrogemsCustomer {\n  static async mobileVerified(message: CustomerMobileVerifiedMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async action(message: CustomerActionMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async addTag(message: CustomerAddTagMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async updateNotes(message: CustomerUpdateNotesMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n}","/**\n * Multilanguage String Type\n *\n * Represents text content that can be displayed in multiple languages.\n * Used across services for internationalization support.\n */\n\nexport interface MultilanguageString {\n  /**\n   * English text (required)\n   */\n  en: string;\n\n  /**\n   * Arabic text (optional)\n   */\n  ar?: string;\n}\n\n/**\n * Helper function to get text in preferred language with fallback\n *\n * @param text - Multilanguage string object\n * @param language - Preferred language ('en' | 'ar')\n * @returns Text in preferred language, or English if not available\n */\nexport function getLocalizedText(\n  text: MultilanguageString,\n  language: 'en' | 'ar' = 'en'\n): string {\n  if (language === 'ar' && text.ar) {\n    return text.ar;\n  }\n  return text.en;\n}\n\n/**\n * Helper function to create a multilanguage string from a plain string\n *\n * @param enText - English text\n * @param arText - Optional Arabic text\n * @returns MultilanguageString object\n */\nexport function createMultilanguageString(\n  enText: string,\n  arText?: string\n): MultilanguageString {\n  const result: MultilanguageString = { en: enText };\n  if (arText) {\n    result.ar = arText;\n  }\n  return result;\n}\n","/**\n * Order Item Attributes\n *\n * Shared types for order item customization attributes used across:\n * - menu API (for menu item attributes)\n * - schedule API (for appointment service attributes)\n * - transactions API (for order item attributes)\n */\n\n/**\n * Single attribute value option\n */\nexport interface AttributeValue {\n  /**\n   * Unique identifier for this value option\n   */\n  id: string;\n\n  /**\n   * Display name of the value\n   */\n  name: string;\n\n  /**\n   * Additional price for selecting this value (0 if no extra cost)\n   */\n  price: number;\n\n  /**\n   * Whether this value is available/in-stock\n   */\n  isAvailable?: boolean;\n}\n\n/**\n * Attribute definition (e.g., \"Size\", \"Color\", \"Extras\")\n */\nexport interface OrderAttribute {\n  /**\n   * Unique identifier for this attribute\n   */\n  id: string;\n\n  /**\n   * Attribute name (e.g., \"Size\", \"Toppings\")\n   */\n  name: string;\n\n  /**\n   * Available values for this attribute\n   */\n  values: AttributeValue[];\n\n  /**\n   * Whether customer must select a value for this attribute\n   */\n  required?: boolean;\n\n  /**\n   * Allow multiple values to be selected (e.g., multiple toppings)\n   */\n  allowMultiple?: boolean;\n\n  /**\n   * Minimum number of selections (if allowMultiple = true)\n   */\n  minSelections?: number;\n\n  /**\n   * Maximum number of selections (if allowMultiple = true)\n   */\n  maxSelections?: number;\n}\n\n/**\n * Selected attribute for an order item\n * (What the customer actually selected)\n */\nexport interface SelectedOrderAttribute {\n  /**\n   * Reference to the attribute definition\n   */\n  attributeId: string;\n\n  /**\n   * Attribute name (denormalized for display)\n   */\n  attributeName: string;\n\n  /**\n   * Selected value(s)\n   */\n  selectedValues: {\n    /**\n     * Value ID\n     */\n    id: string;\n\n    /**\n     * Value name (denormalized for display)\n     */\n    name: string;\n\n    /**\n     * Price of this selected value\n     */\n    price: number;\n  }[];\n\n  /**\n   * Total price for this attribute (sum of all selected values)\n   */\n  totalPrice: number;\n}\n\n/**\n * Array of selected attributes for an order item\n * This is what gets stored in Appointment.orderItemAttributes or Order.items[].attributes\n */\nexport type OrderItemAttributes = SelectedOrderAttribute[];\n\n/**\n * Helper function to calculate total price from selected attributes\n *\n * @param attributes - Array of selected attributes\n * @returns Total additional price from all attributes\n */\nexport function calculateAttributesPrice(\n  attributes: OrderItemAttributes\n): number {\n  return attributes.reduce((total, attr) => total + attr.totalPrice, 0);\n}\n\n/**\n * Helper function to validate selected attributes against definitions\n *\n * @param selected - Selected attributes\n * @param definitions - Attribute definitions\n * @returns Validation result with any errors\n */\nexport function validateSelectedAttributes(\n  selected: OrderItemAttributes,\n  definitions: OrderAttribute[]\n): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n\n  // Check required attributes\n  for (const def of definitions) {\n    if (def.required) {\n      const selectedAttr = selected.find((s) => s.attributeId === def.id);\n      if (!selectedAttr || selectedAttr.selectedValues.length === 0) {\n        errors.push(`Attribute \"${def.name}\" is required`);\n      }\n    }\n  }\n\n  // Check selection counts\n  for (const selectedAttr of selected) {\n    const def = definitions.find((d) => d.id === selectedAttr.attributeId);\n    if (!def) {\n      errors.push(`Unknown attribute: ${selectedAttr.attributeName}`);\n      continue;\n    }\n\n    const count = selectedAttr.selectedValues.length;\n\n    if (!def.allowMultiple && count > 1) {\n      errors.push(`Attribute \"${def.name}\" allows only one selection`);\n    }\n\n    if (def.minSelections && count < def.minSelections) {\n      errors.push(\n        `Attribute \"${def.name}\" requires at least ${def.minSelections} selections`\n      );\n    }\n\n    if (def.maxSelections && count > def.maxSelections) {\n      errors.push(\n        `Attribute \"${def.name}\" allows at most ${def.maxSelections} selections`\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport type ServiceType = 'MENU' | 'APPOINTMENT' | 'CREDIT_BUNDLE';\n\n// ZATCA-compliant buyer identification schemes for BR-KSA-81\nexport type BuyerIdentificationScheme = 'TIN'|'CRN'|'MOM'|'MLS'|'700'|'SAG'|'NAT'|'GCC'|'IQA'|'PAS'|'OTH';\n\nexport interface OrderItemForInvoice {\n  idInService: string;\n  name: string;\n  description?: string;\n  price: number;\n  quantity: number;\n  vatRate?: number;\n  invoicable?: boolean;  // defaults to true; set to false for items already paid (e.g., package redemptions)\n  orderAttributes?: { id?: string; name: string; price: number; quantity?: number }[];\n}\n\nexport interface PaymentInfo {\n  type: string;\n  amount: number;\n  reference?: string;\n}\n\n// Fee information for ZATCA invoice charges\nexport interface OrderFeeInfo {\n  feeId?: string;\n  name: string;\n  type: string;\n  value: number;\n  calculatedAmount: number; // VAT-inclusive amount\n}\n\nexport interface CustomerInfo {\n  name?: string;\n  phoneNumber?: string;\n  countryCode?: string;\n  email?: string;\n  vatNumber?: string;\n  crNumber?: string;\n  streetName?: string;\n  buildingNumber?: string;\n  cityName?: string;\n  postalZone?: string;\n  district?: string;\n  identificationNumber?: string;\n  identificationScheme?: BuyerIdentificationScheme;\n}\n\nexport interface OrderCreatedEvent {\n  orderId: string;\n  brandId: string;\n  branchId?: string;\n  source: ServiceType;\n  subtotal: number;\n  vatAmount: number;\n  vatPercentage?: number;\n  total: number;\n  items: OrderItemForInvoice[];\n  payments: PaymentInfo[];\n  customerInfo?: CustomerInfo;\n  dailyOrderNumber?: number;\n  yearlyOrderNumber?: number;\n  createdAt: Date;\n  additionalFees?: OrderFeeInfo[]; // Order-level fees (minimum order, service, delivery, etc.)\n}\n\nexport class MiaOrders {\n  static async publishOrderCreated(event: OrderCreatedEvent): Promise<void> {\n    await MessagingBus.publish('mia.orders.created', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface ShiftClosedEvent {\n  shiftId: string;\n  brandId: string;\n  branchId: string;\n  staffId: string;\n  openedAt: string;\n  closedAt: string;\n  initialCash: number;\n  expectedCash: number;\n  closingCash: number;\n  paymentSummary: Array<{ type: string; total: number; count: number }>;\n  refundSummary: Array<{ type: string; total: number; count: number }>;\n  totalRefunds: number;\n  closingNotes?: string;\n  staffName?: string;\n}\n\nexport class MiaShifts {\n  static async publishShiftClosed(event: ShiftClosedEvent): Promise<void> {\n    await MessagingBus.publish('mia.shifts.closed', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface CriticalErrorEvent {\n  brandId: string;\n  branchId?: string;\n  service: string;\n  errorType: string;\n  summary: string;\n  details: string;\n  resourceId?: string;\n  resourceType?: string;\n  occurredAt: string;\n}\n\nexport class MiaCriticalErrors {\n  static async publish(event: CriticalErrorEvent): Promise<void> {\n    await MessagingBus.publish('mia.errors.critical', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport type AuditRiskLevel = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';\n\nexport interface AuditTraceEvent {\n  action: string;\n  riskLevel: AuditRiskLevel;\n  service: string;\n  staffId?: string;\n  staffRole?: string;\n  brandId: string;\n  branchId?: string;\n  financialImpact?: {\n    amount: number;\n    currency: string;\n  };\n  objectRef?: {\n    collection: string;\n    id: string;\n    snapshot?: Record<string, any>;\n  };\n  details?: string;\n  metadata?: Record<string, any>;\n  performedAt?: string;\n}\n\nexport class MiaAuditTrace {\n  static async publish(event: AuditTraceEvent): Promise<void> {\n    await MessagingBus.publish('mia.audit.trace', {\n      ...event,\n      performedAt: event.performedAt || new Date().toISOString(),\n    });\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/mia-server-response.ts","../src/messaging-bus.ts","../src/notifications.ts","../src/customers.ts","../src/multilanguage.ts","../src/order-attributes.ts","../src/orders.ts","../src/shifts.ts","../src/critical-errors.ts","../src/audit-trace.ts","../src/stock.ts"],"sourcesContent":["export class MiaServerResponse {\n  status?: number;\n  message?: string;\n  data: any;\n\n  static send = (status: number, message: string, data: any) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: message,\n      data: data\n    };\n    return response;\n  }\n  static sendData = (data: any, status: number = 200) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: \"Success\",\n      data: data\n    };\n    return response;\n  }\n  static sendError = (error: any, status: number = 400) => {\n    const response: MiaServerResponse = {\n      status: status,\n      message: \"Failed\",\n      data: error\n    };\n    return response;\n  }\n}\n","import { connect, JSONCodec } from \"nats\";\n\nexport class MessagingBus {\n  static async subscribe(channel: string, queue: string, onMessage: Function) {\n    if (!process.env.NATS_HOST) {\n      throw new Error(\"NATS_HOST ENV is not defined\");\n    }\n    const nc = await connect({ servers: process.env.NATS_HOST });\n    const sc = JSONCodec();\n    const subscription = nc.subscribe(channel, { queue: queue });\n\n    (async (sub) => {\n\n      console.log(`listening for ${sub.getSubject()} requests...`);\n\n      for await (const m of sub) {\n        const msg = sc.decode(m.data);\n        onMessage(msg);\n      }\n\n      console.log(`subscription ${sub.getSubject()} drained.`);\n    })(subscription);\n  }\n\n  static async publish(channel: string, message: any) {\n    if (!process.env.NATS_HOST) {\n      throw new Error(\"NATS_HOST ENV is not defined\");\n    }\n    const nc = await connect({ servers: process.env.NATS_HOST });\n    const jc = JSONCodec();\n    nc.publish(channel, jc.encode(message));\n    await nc.drain();\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\nexport interface Notification {\n  title?: string,\n  body: string,\n  badge?: number,\n  payload?: any,\n  target?: string\n}\nexport interface UserNotification extends Notification {\n  userId: string\n}\nexport interface DeviceNotification extends Notification {\n  deviceId: string\n}\nexport interface TopicNotification extends Notification {\n  topic: string,\n}\nexport interface SmsNotification extends Notification {\n  mobile: string,\n}\nexport interface StaffNotification extends Notification {\n  staffId: string\n  brandId: string\n}\n\nexport interface PrintLine {\n  text: string,\n  alignment: 'left' | 'center' | 'right',\n  size: 'normal' | 'large' | 'small',\n  weight: 'normal' | 'bold'\n}\n\nexport interface OperateOrderNotificationPayload {\n  orderId: string,\n  serveTo: string | null,\n  items: Array<{\n    name: string,\n    quantity: number,\n    price: number,\n    description: string | null\n  }>,\n  notes: string | null,\n  lines: PrintLine[]\n}\n\nexport interface OperateOrderNotification {\n  brandId: string,\n  branchId: string,\n  title: string,\n  body: string,\n  order: OperateOrderNotificationPayload\n}\n\nexport class MiaNotifications {\n  static async sendtoDevice(message: DeviceNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoUserDevices(message: UserNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoTopic(message: TopicNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoSms(message: SmsNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n  static async sendtoStaff(message: StaffNotification) {\n    const topic = MiaNotifications.staffTopicFormatter(message.brandId, message.staffId);\n    await MiaNotifications.sendtoTopic({\n      topic,\n      title: message.title,\n      body: message.body,\n      badge: message.badge,\n      payload: message.payload,\n      target: message.target\n    });\n  }\n  static async sendOperateOrderNotification(message: OperateOrderNotification) {\n    await MessagingBus.publish(`mia.notifications.${process.env.HOSTNAME || \"general\"}`, {\n      ...message,\n      type: 'operateOrder'\n    });\n  }\n  static topicFormatter = (topic: string) => \"/topics/\" + topic.replace(/\\//g, \"~\")\n  static operateOrderTopicFormatter = (brandId: string, branchId: string) =>\n    `~operate~orders~${brandId}~${branchId}`\n  static staffTopicFormatter = (brandId: string, staffId: string) =>\n    `/topics/~staff~${brandId}~${staffId}`\n}","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface CustomerMobileVerifiedMessage {\n  brandId: string;\n  customer: any;\n  isVerified: boolean;\n}\n\nexport interface CustomerActionMessage {\n  brandId: string;\n  type: string;\n  customer: any;\n  payload: any;\n}\n\nexport interface CustomerAddTagMessage {\n  brandId: string;\n  customer: any;\n  tag: string;\n  remove: boolean;\n}\n\nexport interface CustomerUpdateNotesMessage {\n  brandId: string;\n  customer: any;\n  newNotes: string;\n}\n\nexport class MicrogemsCustomer {\n  static async mobileVerified(message: CustomerMobileVerifiedMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async action(message: CustomerActionMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async addTag(message: CustomerAddTagMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n\n  static async updateNotes(message: CustomerUpdateNotesMessage) {\n    await MessagingBus.publish(`mia.customers.${process.env.HOSTNAME || \"general\"}`, message);\n  }\n}","/**\n * Multilanguage String Type\n *\n * Represents text content that can be displayed in multiple languages.\n * Used across services for internationalization support.\n */\n\nexport interface MultilanguageString {\n  /**\n   * English text (required)\n   */\n  en: string;\n\n  /**\n   * Arabic text (optional)\n   */\n  ar?: string;\n}\n\n/**\n * Helper function to get text in preferred language with fallback\n *\n * @param text - Multilanguage string object\n * @param language - Preferred language ('en' | 'ar')\n * @returns Text in preferred language, or English if not available\n */\nexport function getLocalizedText(\n  text: MultilanguageString,\n  language: 'en' | 'ar' = 'en'\n): string {\n  if (language === 'ar' && text.ar) {\n    return text.ar;\n  }\n  return text.en;\n}\n\n/**\n * Helper function to create a multilanguage string from a plain string\n *\n * @param enText - English text\n * @param arText - Optional Arabic text\n * @returns MultilanguageString object\n */\nexport function createMultilanguageString(\n  enText: string,\n  arText?: string\n): MultilanguageString {\n  const result: MultilanguageString = { en: enText };\n  if (arText) {\n    result.ar = arText;\n  }\n  return result;\n}\n","/**\n * Order Item Attributes\n *\n * Shared types for order item customization attributes used across:\n * - menu API (for menu item attributes)\n * - schedule API (for appointment service attributes)\n * - transactions API (for order item attributes)\n */\n\n/**\n * Single attribute value option\n */\nexport interface AttributeValue {\n  /**\n   * Unique identifier for this value option\n   */\n  id: string;\n\n  /**\n   * Display name of the value\n   */\n  name: string;\n\n  /**\n   * Additional price for selecting this value (0 if no extra cost)\n   */\n  price: number;\n\n  /**\n   * Whether this value is available/in-stock\n   */\n  isAvailable?: boolean;\n}\n\n/**\n * Attribute definition (e.g., \"Size\", \"Color\", \"Extras\")\n */\nexport interface OrderAttribute {\n  /**\n   * Unique identifier for this attribute\n   */\n  id: string;\n\n  /**\n   * Attribute name (e.g., \"Size\", \"Toppings\")\n   */\n  name: string;\n\n  /**\n   * Available values for this attribute\n   */\n  values: AttributeValue[];\n\n  /**\n   * Whether customer must select a value for this attribute\n   */\n  required?: boolean;\n\n  /**\n   * Allow multiple values to be selected (e.g., multiple toppings)\n   */\n  allowMultiple?: boolean;\n\n  /**\n   * Minimum number of selections (if allowMultiple = true)\n   */\n  minSelections?: number;\n\n  /**\n   * Maximum number of selections (if allowMultiple = true)\n   */\n  maxSelections?: number;\n}\n\n/**\n * Selected attribute for an order item\n * (What the customer actually selected)\n */\nexport interface SelectedOrderAttribute {\n  /**\n   * Reference to the attribute definition\n   */\n  attributeId: string;\n\n  /**\n   * Attribute name (denormalized for display)\n   */\n  attributeName: string;\n\n  /**\n   * Selected value(s)\n   */\n  selectedValues: {\n    /**\n     * Value ID\n     */\n    id: string;\n\n    /**\n     * Value name (denormalized for display)\n     */\n    name: string;\n\n    /**\n     * Price of this selected value\n     */\n    price: number;\n  }[];\n\n  /**\n   * Total price for this attribute (sum of all selected values)\n   */\n  totalPrice: number;\n}\n\n/**\n * Array of selected attributes for an order item\n * This is what gets stored in Appointment.orderItemAttributes or Order.items[].attributes\n */\nexport type OrderItemAttributes = SelectedOrderAttribute[];\n\n/**\n * Helper function to calculate total price from selected attributes\n *\n * @param attributes - Array of selected attributes\n * @returns Total additional price from all attributes\n */\nexport function calculateAttributesPrice(\n  attributes: OrderItemAttributes\n): number {\n  return attributes.reduce((total, attr) => total + attr.totalPrice, 0);\n}\n\n/**\n * Helper function to validate selected attributes against definitions\n *\n * @param selected - Selected attributes\n * @param definitions - Attribute definitions\n * @returns Validation result with any errors\n */\nexport function validateSelectedAttributes(\n  selected: OrderItemAttributes,\n  definitions: OrderAttribute[]\n): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n\n  // Check required attributes\n  for (const def of definitions) {\n    if (def.required) {\n      const selectedAttr = selected.find((s) => s.attributeId === def.id);\n      if (!selectedAttr || selectedAttr.selectedValues.length === 0) {\n        errors.push(`Attribute \"${def.name}\" is required`);\n      }\n    }\n  }\n\n  // Check selection counts\n  for (const selectedAttr of selected) {\n    const def = definitions.find((d) => d.id === selectedAttr.attributeId);\n    if (!def) {\n      errors.push(`Unknown attribute: ${selectedAttr.attributeName}`);\n      continue;\n    }\n\n    const count = selectedAttr.selectedValues.length;\n\n    if (!def.allowMultiple && count > 1) {\n      errors.push(`Attribute \"${def.name}\" allows only one selection`);\n    }\n\n    if (def.minSelections && count < def.minSelections) {\n      errors.push(\n        `Attribute \"${def.name}\" requires at least ${def.minSelections} selections`\n      );\n    }\n\n    if (def.maxSelections && count > def.maxSelections) {\n      errors.push(\n        `Attribute \"${def.name}\" allows at most ${def.maxSelections} selections`\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport type ServiceType = 'MENU' | 'APPOINTMENT' | 'CREDIT_BUNDLE';\n\n// ZATCA-compliant buyer identification schemes for BR-KSA-81\nexport type BuyerIdentificationScheme = 'TIN'|'CRN'|'MOM'|'MLS'|'700'|'SAG'|'NAT'|'GCC'|'IQA'|'PAS'|'OTH';\n\nexport interface OrderItemForInvoice {\n  idInService: string;\n  name: string;\n  description?: string;\n  price: number;\n  quantity: number;\n  vatRate?: number;\n  invoicable?: boolean;  // defaults to true; set to false for items already paid (e.g., package redemptions)\n  orderAttributes?: { id?: string; name: string; price: number; quantity?: number }[];\n}\n\nexport interface PaymentInfo {\n  type: string;\n  amount: number;\n  reference?: string;\n}\n\n// Fee information for ZATCA invoice charges\nexport interface OrderFeeInfo {\n  feeId?: string;\n  name: string;\n  type: string;\n  value: number;\n  calculatedAmount: number; // VAT-inclusive amount\n}\n\nexport interface CustomerInfo {\n  name?: string;\n  phoneNumber?: string;\n  countryCode?: string;\n  email?: string;\n  vatNumber?: string;\n  crNumber?: string;\n  streetName?: string;\n  buildingNumber?: string;\n  cityName?: string;\n  postalZone?: string;\n  district?: string;\n  identificationNumber?: string;\n  identificationScheme?: BuyerIdentificationScheme;\n}\n\nexport interface OrderCreatedEvent {\n  orderId: string;\n  brandId: string;\n  branchId?: string;\n  source: ServiceType;\n  subtotal: number;\n  vatAmount: number;\n  vatPercentage?: number;\n  total: number;\n  items: OrderItemForInvoice[];\n  payments: PaymentInfo[];\n  customerInfo?: CustomerInfo;\n  dailyOrderNumber?: number;\n  yearlyOrderNumber?: number;\n  createdAt: Date;\n  additionalFees?: OrderFeeInfo[]; // Order-level fees (minimum order, service, delivery, etc.)\n}\n\nexport class MiaOrders {\n  static async publishOrderCreated(event: OrderCreatedEvent): Promise<void> {\n    await MessagingBus.publish('mia.orders.created', event);\n  }\n}\n\nexport interface PreorderPaymentEvent {\n  preorderId: string;\n  sourceId: string;\n  source: ServiceType;\n  brandId: string;\n  branchId?: string;\n  payment: PaymentInfo;\n  totalPaid: number;\n  total: number;\n  isFullyPaid: boolean;\n  orderId?: string;\n}\n\nexport class MiaPreorders {\n  static async publishPaymentAdded(event: PreorderPaymentEvent): Promise<void> {\n    await MessagingBus.publish('mia.preorders.payment-added', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface ShiftClosedEvent {\n  shiftId: string;\n  brandId: string;\n  branchId: string;\n  staffId: string;\n  openedAt: string;\n  closedAt: string;\n  initialCash: number;\n  expectedCash: number;\n  closingCash: number;\n  paymentSummary: Array<{ type: string; total: number; count: number }>;\n  refundSummary: Array<{ type: string; total: number; count: number }>;\n  totalRefunds: number;\n  closingNotes?: string;\n  staffName?: string;\n}\n\nexport class MiaShifts {\n  static async publishShiftClosed(event: ShiftClosedEvent): Promise<void> {\n    await MessagingBus.publish('mia.shifts.closed', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface CriticalErrorEvent {\n  brandId: string;\n  branchId?: string;\n  service: string;\n  errorType: string;\n  summary: string;\n  details: string;\n  resourceId?: string;\n  resourceType?: string;\n  occurredAt: string;\n}\n\nexport class MiaCriticalErrors {\n  static async publish(event: CriticalErrorEvent): Promise<void> {\n    await MessagingBus.publish('mia.errors.critical', event);\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport type AuditRiskLevel = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';\n\nexport interface AuditTraceEvent {\n  action: string;\n  riskLevel: AuditRiskLevel;\n  service: string;\n  staffId?: string;\n  staffRole?: string;\n  brandId: string;\n  branchId?: string;\n  financialImpact?: {\n    amount: number;\n    currency: string;\n  };\n  objectRef?: {\n    collection: string;\n    id: string;\n    snapshot?: Record<string, any>;\n  };\n  details?: string;\n  metadata?: Record<string, any>;\n  performedAt?: string;\n}\n\nexport class MiaAuditTrace {\n  static async publish(event: AuditTraceEvent): Promise<void> {\n    await MessagingBus.publish('mia.audit.trace', {\n      ...event,\n      performedAt: event.performedAt || new Date().toISOString(),\n    });\n  }\n}\n","import { MessagingBus } from \"./messaging-bus\";\n\nexport interface LowStockEvent {\n  brandId: string;\n  branchId: string;\n  rawMaterialId: string;\n  materialName: string;\n  currentQuantity: number;\n  lowThreshold: number;\n  unit: string;\n}\n\nexport class MiaStock {\n  static async publishLowStockAlert(event: LowStockEvent): Promise<void> {\n    await MessagingBus.publish('mia.menu.stock.low', event);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAO,IAAM,oBAAN,MAAwB;AA6B/B;AA7Ba,kBAKJ,OAAO,CAAC,QAAgB,SAAiB,SAAc;AAC5D,QAAM,WAA8B;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,SAAO;AACT;AAZW,kBAaJ,WAAW,CAAC,MAAW,SAAiB,QAAQ;AACrD,QAAM,WAA8B;AAAA,IAClC;AAAA,IACA,SAAS;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AApBW,kBAqBJ,YAAY,CAAC,OAAY,SAAiB,QAAQ;AACvD,QAAM,WAA8B;AAAA,IAClC;AAAA,IACA,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AACA,SAAO;AACT;;;AC5BF,SAAS,SAAS,iBAAiB;AAE5B,IAAM,eAAN,MAAmB;AAAA,EACxB,OAAa,UAAU,SAAiB,OAAe,WAAqB;AAAA;AAC1E,UAAI,CAAC,QAAQ,IAAI,WAAW;AAC1B,cAAM,IAAI,MAAM,8BAA8B;AAAA,MAChD;AACA,YAAM,KAAK,MAAM,QAAQ,EAAE,SAAS,QAAQ,IAAI,UAAU,CAAC;AAC3D,YAAM,KAAK,UAAU;AACrB,YAAM,eAAe,GAAG,UAAU,SAAS,EAAE,MAAa,CAAC;AAE3D,OAAC,CAAO,QAAQ;AAEd,gBAAQ,IAAI,iBAAiB,IAAI,WAAW,CAAC,cAAc;AAE3D;AAAA,qCAAsB,MAAtB,0EAA2B;AAAhB,kBAAM,IAAjB;AACE,kBAAM,MAAM,GAAG,OAAO,EAAE,IAAI;AAC5B,sBAAU,GAAG;AAAA,UACf;AAAA,iBAHA,MAfN;AAeM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,gBAAQ,IAAI,gBAAgB,IAAI,WAAW,CAAC,WAAW;AAAA,MACzD,IAAG,YAAY;AAAA,IACjB;AAAA;AAAA,EAEA,OAAa,QAAQ,SAAiB,SAAc;AAAA;AAClD,UAAI,CAAC,QAAQ,IAAI,WAAW;AAC1B,cAAM,IAAI,MAAM,8BAA8B;AAAA,MAChD;AACA,YAAM,KAAK,MAAM,QAAQ,EAAE,SAAS,QAAQ,IAAI,UAAU,CAAC;AAC3D,YAAM,KAAK,UAAU;AACrB,SAAG,QAAQ,SAAS,GAAG,OAAO,OAAO,CAAC;AACtC,YAAM,GAAG,MAAM;AAAA,IACjB;AAAA;AACF;;;ACoBO,IAAM,oBAAN,MAAM,kBAAiB;AAAA,EAC5B,OAAa,aAAa,SAA6B;AAAA;AACrD,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC9F;AAAA;AAAA,EACA,OAAa,kBAAkB,SAA2B;AAAA;AACxD,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC9F;AAAA;AAAA,EACA,OAAa,YAAY,SAA4B;AAAA;AACnD,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC9F;AAAA;AAAA,EACA,OAAa,UAAU,SAA0B;AAAA;AAC/C,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC9F;AAAA;AAAA,EACA,OAAa,YAAY,SAA4B;AAAA;AACnD,YAAM,QAAQ,kBAAiB,oBAAoB,QAAQ,SAAS,QAAQ,OAAO;AACnF,YAAM,kBAAiB,YAAY;AAAA,QACjC;AAAA,QACA,OAAO,QAAQ;AAAA,QACf,MAAM,QAAQ;AAAA,QACd,OAAO,QAAQ;AAAA,QACf,SAAS,QAAQ;AAAA,QACjB,QAAQ,QAAQ;AAAA,MAClB,CAAC;AAAA,IACH;AAAA;AAAA,EACA,OAAa,6BAA6B,SAAmC;AAAA;AAC3E,YAAM,aAAa,QAAQ,qBAAqB,QAAQ,IAAI,YAAY,SAAS,IAAI,iCAChF,UADgF;AAAA,QAEnF,MAAM;AAAA,MACR,EAAC;AAAA,IACH;AAAA;AAMF;AAnCa,kBA8BJ,iBAAiB,CAAC,UAAkB,aAAa,MAAM,QAAQ,OAAO,GAAG;AA9BrE,kBA+BJ,6BAA6B,CAAC,SAAiB,aACpD,mBAAmB,OAAO,IAAI,QAAQ;AAhC7B,kBAiCJ,sBAAsB,CAAC,SAAiB,YAC7C,kBAAkB,OAAO,IAAI,OAAO;AAlCjC,IAAM,mBAAN;;;ACzBA,IAAM,oBAAN,MAAwB;AAAA,EAC7B,OAAa,eAAe,SAAwC;AAAA;AAClE,YAAM,aAAa,QAAQ,iBAAiB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC1F;AAAA;AAAA,EAEA,OAAa,OAAO,SAAgC;AAAA;AAClD,YAAM,aAAa,QAAQ,iBAAiB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC1F;AAAA;AAAA,EAEA,OAAa,OAAO,SAAgC;AAAA;AAClD,YAAM,aAAa,QAAQ,iBAAiB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC1F;AAAA;AAAA,EAEA,OAAa,YAAY,SAAqC;AAAA;AAC5D,YAAM,aAAa,QAAQ,iBAAiB,QAAQ,IAAI,YAAY,SAAS,IAAI,OAAO;AAAA,IAC1F;AAAA;AACF;;;AClBO,SAAS,iBACd,MACA,WAAwB,MAChB;AACR,MAAI,aAAa,QAAQ,KAAK,IAAI;AAChC,WAAO,KAAK;AAAA,EACd;AACA,SAAO,KAAK;AACd;AASO,SAAS,0BACd,QACA,QACqB;AACrB,QAAM,SAA8B,EAAE,IAAI,OAAO;AACjD,MAAI,QAAQ;AACV,WAAO,KAAK;AAAA,EACd;AACA,SAAO;AACT;;;AC2EO,SAAS,yBACd,YACQ;AACR,SAAO,WAAW,OAAO,CAAC,OAAO,SAAS,QAAQ,KAAK,YAAY,CAAC;AACtE;AASO,SAAS,2BACd,UACA,aACsC;AACtC,QAAM,SAAmB,CAAC;AAG1B,aAAW,OAAO,aAAa;AAC7B,QAAI,IAAI,UAAU;AAChB,YAAM,eAAe,SAAS,KAAK,CAAC,MAAM,EAAE,gBAAgB,IAAI,EAAE;AAClE,UAAI,CAAC,gBAAgB,aAAa,eAAe,WAAW,GAAG;AAC7D,eAAO,KAAK,cAAc,IAAI,IAAI,eAAe;AAAA,MACnD;AAAA,IACF;AAAA,EACF;AAGA,aAAW,gBAAgB,UAAU;AACnC,UAAM,MAAM,YAAY,KAAK,CAAC,MAAM,EAAE,OAAO,aAAa,WAAW;AACrE,QAAI,CAAC,KAAK;AACR,aAAO,KAAK,sBAAsB,aAAa,aAAa,EAAE;AAC9D;AAAA,IACF;AAEA,UAAM,QAAQ,aAAa,eAAe;AAE1C,QAAI,CAAC,IAAI,iBAAiB,QAAQ,GAAG;AACnC,aAAO,KAAK,cAAc,IAAI,IAAI,6BAA6B;AAAA,IACjE;AAEA,QAAI,IAAI,iBAAiB,QAAQ,IAAI,eAAe;AAClD,aAAO;AAAA,QACL,cAAc,IAAI,IAAI,uBAAuB,IAAI,aAAa;AAAA,MAChE;AAAA,IACF;AAEA,QAAI,IAAI,iBAAiB,QAAQ,IAAI,eAAe;AAClD,aAAO;AAAA,QACL,cAAc,IAAI,IAAI,oBAAoB,IAAI,aAAa;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,OAAO,WAAW;AAAA,IACzB;AAAA,EACF;AACF;;;ACxHO,IAAM,YAAN,MAAgB;AAAA,EACrB,OAAa,oBAAoB,OAAyC;AAAA;AACxE,YAAM,aAAa,QAAQ,sBAAsB,KAAK;AAAA,IACxD;AAAA;AACF;AAeO,IAAM,eAAN,MAAmB;AAAA,EACxB,OAAa,oBAAoB,OAA4C;AAAA;AAC3E,YAAM,aAAa,QAAQ,+BAA+B,KAAK;AAAA,IACjE;AAAA;AACF;;;ACvEO,IAAM,YAAN,MAAgB;AAAA,EACrB,OAAa,mBAAmB,OAAwC;AAAA;AACtE,YAAM,aAAa,QAAQ,qBAAqB,KAAK;AAAA,IACvD;AAAA;AACF;;;ACTO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,OAAa,QAAQ,OAA0C;AAAA;AAC7D,YAAM,aAAa,QAAQ,uBAAuB,KAAK;AAAA,IACzD;AAAA;AACF;;;ACQO,IAAM,gBAAN,MAAoB;AAAA,EACzB,OAAa,QAAQ,OAAuC;AAAA;AAC1D,YAAM,aAAa,QAAQ,mBAAmB,iCACzC,QADyC;AAAA,QAE5C,aAAa,MAAM,gBAAe,oBAAI,KAAK,GAAE,YAAY;AAAA,MAC3D,EAAC;AAAA,IACH;AAAA;AACF;;;ACrBO,IAAM,WAAN,MAAe;AAAA,EACpB,OAAa,qBAAqB,OAAqC;AAAA;AACrE,YAAM,aAAa,QAAQ,sBAAsB,KAAK;AAAA,IACxD;AAAA;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aghamdi/shared-types",
-  "version": "0.2.35",
+  "version": "0.2.37",
   "description": "Provide typescript interfaces for common types and some classes",
   "main": "dist/index.js",
   "types": "dist/index.d.js",