@liiift-studio/sales-portal 1.2.1

package/utils/currencyUtils.d.ts

@@ -0,0 +1,20 @@
+// Type definitions for currency utility functions
+
+export function formatCurrency(
+	amount: number,
+	currencyCode?: string,
+	locale?: string
+): string;
+
+export function parseCurrency(
+	formattedAmount: string,
+	currencyCode?: string
+): number;
+
+export function getCurrencySymbol(currencyCode: string): string;
+
+export function convertCurrency(
+	amount: number,
+	fromCurrency: string,
+	toCurrency: string
+): number;

package/utils/currencyUtils.js

@@ -0,0 +1,79 @@
+/**
+ * Currency formatting utility functions
+ * All sales data from API is in cents, these utilities help with proper formatting
+ */
+
+/**
+ * Format currency value in USD
+ * @param {number} value - Value in dollars to format as currency
+ * @param {Object} options - Formatting options
+ * @param {number} options.minimumFractionDigits - Minimum fraction digits (default: 2)
+ * @param {number} options.maximumFractionDigits - Maximum fraction digits (default: 2)
+ * @returns {string} Formatted currency string
+ */
+export const formatCurrency = (
+  value, 
+  { minimumFractionDigits = 2, maximumFractionDigits = 2 } = {}
+) => {
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD',
+    minimumFractionDigits,
+    maximumFractionDigits,
+  }).format(value);
+};
+
+/**
+ * Convert cents to dollars
+ * @param {number} cents - Value in cents
+ * @returns {number} Value in dollars
+ */
+export const centsToDollars = (cents) => {
+  if (typeof cents !== 'number') {
+    return 0;
+  }
+  return cents / 100;
+};
+
+/**
+ * Format cents as currency
+ * @param {number} cents - Value in cents
+ * @param {Object} options - Formatting options
+ * @returns {string} Formatted currency string
+ */
+export const formatCentsAsCurrency = (cents, options = {}) => {
+  return formatCurrency(centsToDollars(cents), options);
+};
+
+/**
+ * Calculate percentage change between two values
+ * @param {number} current - Current value
+ * @param {number} previous - Previous value
+ * @returns {number|null} Percentage change or null if previous is zero
+ */
+export const calculatePercentageChange = (current, previous) => {
+  if (!previous || previous === 0) {
+    return null;
+  }
+  return ((current - previous) / previous) * 100;
+};
+
+/**
+ * Format percentage value
+ * @param {number} value - Percentage value
+ * @param {Object} options - Formatting options
+ * @param {number} options.decimals - Number of decimal places (default: 1)
+ * @param {boolean} options.showPlusSign - Whether to show plus sign for positive values (default: true)
+ * @returns {string} Formatted percentage string
+ */
+export const formatPercentage = (
+  value, 
+  { decimals = 1, showPlusSign = true } = {}
+) => {
+  if (value === null || value === undefined) {
+    return '';
+  }
+  
+  const sign = value > 0 && showPlusSign ? '+' : '';
+  return `${sign}${value.toFixed(decimals)}%`;
+};

package/utils/salesDataProcessing.d.ts

@@ -0,0 +1,44 @@
+// Type definitions for sales data processing utilities
+
+export interface SalesData {
+	id: string;
+	date: string;
+	customer?: string;
+	amount: number;
+	typeface: string;
+	licenseType: string;
+	country?: string;
+	currency?: string;
+	discount?: number;
+	refund?: number;
+	invoice_id?: string;
+	metadata?: Record<string, any>;
+}
+
+export interface SummaryData {
+	totalRevenue: number;
+	orderCount: number;
+	averageOrderValue: number;
+	refundAmount?: number;
+	discountAmount?: number;
+	netRevenue?: number;
+}
+
+export function processSalesData(rawData: any[]): SalesData[];
+
+export function aggregateSalesData(data: SalesData[]): SummaryData;
+
+export function filterSalesByDateRange(
+	data: SalesData[],
+	startDate: string,
+	endDate: string
+): SalesData[];
+
+export function groupSalesByTypeface(data: SalesData[]): Record<string, SalesData[]>;
+
+export function groupSalesByLicenseType(data: SalesData[]): Record<string, SalesData[]>;
+
+export function calculateRevenueByPeriod(
+	data: SalesData[],
+	period: 'daily' | 'weekly' | 'monthly'
+): any[];