@axova/shared 1.0.0

package/src/schemas/product/discount-relations.ts

@@ -0,0 +1,44 @@
+import { relations } from "drizzle-orm";
+import { 
+	discounts, 
+	discountUsages, 
+	discountRules, 
+	customerSegments, 
+	discountAnalytics 
+} from "./discount-schema";
+import { products, productVariants, collections } from "./product-schema";
+
+// =====================================================
+// DISCOUNT RELATIONS
+// =====================================================
+
+export const discountsRelations = relations(discounts, ({ many }) => ({
+	usages: many(discountUsages),
+	rules: many(discountRules),
+	analytics: many(discountAnalytics),
+}));
+
+export const discountUsagesRelations = relations(discountUsages, ({ one }) => ({
+	discount: one(discounts, {
+		fields: [discountUsages.discountId],
+		references: [discounts.id],
+	}),
+}));
+
+export const discountRulesRelations = relations(discountRules, ({ one }) => ({
+	discount: one(discounts, {
+		fields: [discountRules.discountId],
+		references: [discounts.id],
+	}),
+}));
+
+export const discountAnalyticsRelations = relations(discountAnalytics, ({ one }) => ({
+	discount: one(discounts, {
+		fields: [discountAnalytics.discountId],
+		references: [discounts.id],
+	}),
+}));
+
+export const customerSegmentsRelations = relations(customerSegments, ({ many }) => ({
+	// Relations can be added here for customer segment memberships if needed
+}));

package/src/schemas/product/discount-schema.ts

@@ -0,0 +1,464 @@
+import { createId } from "@paralleldrive/cuid2";
+import {
+	boolean,
+	decimal,
+	index,
+	integer,
+	jsonb,
+	pgEnum,
+	pgTable,
+	text,
+	timestamp,
+	unique,
+	varchar,
+} from "drizzle-orm/pg-core";
+
+// =====================================================
+// DISCOUNT ENUMS
+// =====================================================
+
+export const discountTypeEnum = pgEnum("discount_type", [
+	"PERCENTAGE",
+	"FIXED_AMOUNT",
+	"FREE_SHIPPING",
+	"BOGO", // Buy one get one
+	"TIERED", // Volume-based tiered discounts
+	"LOYALTY_POINTS", // Loyalty points redemption
+	"REFERRAL", // Referral rewards
+	"MEMBER_ONLY", // Membership-exclusive discounts
+]);
+
+export const discountStatusEnum = pgEnum("discount_status", [
+	"DRAFT",
+	"ACTIVE",
+	"PAUSED",
+	"SCHEDULED",
+	"EXPIRED",
+	"DISABLED",
+]);
+
+export const discountTargetTypeEnum = pgEnum("discount_target_type", [
+	"STORE", // Store-wide discount
+	"COLLECTION", // Collection-specific discount
+	"PRODUCT", // Product-specific discount
+	"VARIANT", // Variant-specific discount
+	"CATEGORY", // Category-specific discount
+	"CUSTOMER_SEGMENT", // Customer segment-specific
+]);
+
+export const discountApplicationTypeEnum = pgEnum("discount_application_type", [
+	"AUTOMATIC", // Automatically applied
+	"CODE", // Requires coupon code
+	"MANUAL", // Manually applied by staff
+]);
+
+export const customerSegmentTypeEnum = pgEnum("customer_segment_type", [
+	"NEW_CUSTOMER",
+	"RETURNING_CUSTOMER",
+	"VIP",
+	"LOYALTY_TIER_1",
+	"LOYALTY_TIER_2",
+	"LOYALTY_TIER_3",
+	"GEOGRAPHIC",
+	"PURCHASE_HISTORY",
+	"CUSTOM",
+]);
+
+export const discountStackingModeEnum = pgEnum("discount_stacking_mode", [
+	"NONE", // Cannot stack with other discounts
+	"ADDITIVE", // Add discount values together
+	"MULTIPLICATIVE", // Apply discounts multiplicatively
+	"BEST_ONLY", // Apply only the best discount
+	"CUSTOM", // Custom stacking logic
+]);
+
+// =====================================================
+// MAIN DISCOUNTS TABLE
+// =====================================================
+
+export const discounts = pgTable(
+	"discounts",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+
+		// Basic Information
+		name: varchar("name", { length: 255 }).notNull(),
+		description: text("description"),
+		internalNotes: text("internal_notes"), // Staff notes
+		
+		// Discount Configuration
+		type: discountTypeEnum("type").notNull(),
+		status: discountStatusEnum("status").notNull().default("DRAFT"),
+		applicationType: discountApplicationTypeEnum("application_type")
+			.notNull()
+			.default("AUTOMATIC"),
+		
+		// Discount Values
+		value: decimal("value", { precision: 12, scale: 4 }).notNull(), // Main discount value
+		maxDiscountAmount: decimal("max_discount_amount", { precision: 12, scale: 2 }), // Cap for percentage discounts
+		
+		// Coupon Code (for CODE application type)
+		couponCode: varchar("coupon_code", { length: 100 }),
+		codePrefix: varchar("code_prefix", { length: 20 }), // For auto-generated codes
+		
+		// Targeting Configuration
+		targetType: discountTargetTypeEnum("target_type").notNull().default("STORE"),
+		targetIds: jsonb("target_ids").$type<string[]>().default([]), // IDs of targeted items
+		
+		// Customer Eligibility
+		customerSegments: jsonb("customer_segments")
+			.$type<string[]>()
+			.default([]),
+		excludedCustomerIds: jsonb("excluded_customer_ids")
+			.$type<string[]>()
+			.default([]),
+		
+		// Usage Limits
+		usageLimit: integer("usage_limit"), // Total usage limit
+		usageLimitPerCustomer: integer("usage_limit_per_customer"),
+		currentUsageCount: integer("current_usage_count").notNull().default(0),
+		
+		// Minimum Requirements
+		minPurchaseAmount: decimal("min_purchase_amount", { precision: 12, scale: 2 }),
+		minQuantity: integer("min_quantity"),
+		minItems: integer("min_items"), // Minimum number of different items
+		
+		// Time Constraints
+		startsAt: timestamp("starts_at", { withTimezone: true }),
+		endsAt: timestamp("ends_at", { withTimezone: true }),
+		timeZone: varchar("time_zone", { length: 50 }).default("UTC"),
+		
+		// Schedule Configuration
+		scheduleConfig: jsonb("schedule_config").$type<{
+			recurringType?: "DAILY" | "WEEKLY" | "MONTHLY" | "YEARLY";
+			daysOfWeek?: number[]; // 0-6 (Sunday to Saturday)
+			hoursOfDay?: { start: number; end: number }; // 0-23
+			datesOfMonth?: number[]; // 1-31
+			monthsOfYear?: number[]; // 1-12
+		}>(),
+		
+		// Geographic Restrictions
+		geoRestrictions: jsonb("geo_restrictions").$type<{
+			includedCountries?: string[];
+			excludedCountries?: string[];
+			includedStates?: string[];
+			excludedStates?: string[];
+			includedCities?: string[];
+			excludedCities?: string[];
+			includedZipCodes?: string[];
+			excludedZipCodes?: string[];
+		}>(),
+		
+		// Sales Channel Configuration
+		salesChannels: jsonb("sales_channels")
+			.$type<("POS" | "MARKETPLACE" | "STOREFRONT")[]>()
+			.default(["POS", "MARKETPLACE", "STOREFRONT"]),
+		
+		// Stacking Configuration
+		stackingMode: discountStackingModeEnum("stacking_mode")
+			.notNull()
+			.default("NONE"),
+		priority: integer("priority").notNull().default(0), // Higher number = higher priority
+		excludeOtherDiscounts: boolean("exclude_other_discounts")
+			.notNull()
+			.default(false),
+		
+		// Advanced Configuration
+		customRules: jsonb("custom_rules").$type<{
+			conditions?: Array<{
+				field: string;
+				operator: "EQUALS" | "NOT_EQUALS" | "GREATER_THAN" | "LESS_THAN" | "CONTAINS" | "NOT_CONTAINS";
+				value: any;
+				logicalOperator?: "AND" | "OR";
+			}>;
+			actions?: Array<{
+				type: string;
+				parameters: Record<string, any>;
+			}>;
+		}>(),
+		
+		// BOGO Configuration
+		bogoConfig: jsonb("bogo_config").$type<{
+			buyQuantity: number;
+			getQuantity: number;
+			getDiscountPercentage?: number; // 100 = free, 50 = 50% off
+			applicableToSameProduct?: boolean;
+			applicableToCollection?: string;
+		}>(),
+		
+		// Tiered Discount Configuration
+		tieredConfig: jsonb("tiered_config").$type<Array<{
+			minQuantity: number;
+			discountPercentage?: number;
+			discountAmount?: number;
+		}>>(),
+		
+		// Loyalty Points Configuration
+		loyaltyPointsConfig: jsonb("loyalty_points_config").$type<{
+			pointsRequired: number;
+			pointsValue: number; // Value of points in currency
+			allowPartialRedemption?: boolean;
+		}>(),
+		
+		// Performance Tracking
+		totalSavings: decimal("total_savings", { precision: 12, scale: 2 })
+			.notNull()
+			.default("0"),
+		totalRevenue: decimal("total_revenue", { precision: 12, scale: 2 })
+			.notNull()
+			.default("0"),
+		conversionRate: decimal("conversion_rate", { precision: 5, scale: 4 }),
+		
+		// Metadata
+		createdBy: text("created_by"), // User ID who created the discount
+		lastModifiedBy: text("last_modified_by"),
+		tags: jsonb("tags").$type<string[]>().default([]),
+		
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		deletedAt: timestamp("deleted_at", { withTimezone: true }),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_discounts_store_id").on(table.storeId),
+		statusIndex: index("idx_discounts_status").on(table.status),
+		typeIndex: index("idx_discounts_type").on(table.type),
+		couponCodeIndex: index("idx_discounts_coupon_code").on(table.couponCode),
+		targetTypeIndex: index("idx_discounts_target_type").on(table.targetType),
+		priorityIndex: index("idx_discounts_priority").on(table.priority),
+		timeRangeIndex: index("idx_discounts_time_range").on(table.startsAt, table.endsAt),
+		usageIndex: index("idx_discounts_usage").on(table.currentUsageCount, table.usageLimit),
+		salesChannelsIndex: index("idx_discounts_sales_channels").on(table.salesChannels),
+		
+		// Unique constraints
+		couponCodeUniquePerStore: unique("idx_discounts_coupon_store_unique").on(
+			table.storeId,
+			table.couponCode,
+		),
+	}),
+);
+
+// =====================================================
+// DISCOUNT USAGE TRACKING
+// =====================================================
+
+export const discountUsages = pgTable(
+	"discount_usages",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		discountId: text("discount_id").notNull(),
+		storeId: text("store_id").notNull(),
+		
+		// Usage Context
+		orderId: text("order_id"), // Reference to order if applicable
+		customerId: text("customer_id"),
+		sessionId: text("session_id"), // For anonymous users
+		
+		// Applied Discount Details
+		originalAmount: decimal("original_amount", { precision: 12, scale: 2 }).notNull(),
+		discountAmount: decimal("discount_amount", { precision: 12, scale: 2 }).notNull(),
+		finalAmount: decimal("final_amount", { precision: 12, scale: 2 }).notNull(),
+		
+		// Context Information
+		appliedProducts: jsonb("applied_products").$type<Array<{
+			productId: string;
+			variantId?: string;
+			quantity: number;
+			originalPrice: number;
+			discountedPrice: number;
+		}>>(),
+		
+		salesChannel: varchar("sales_channel", { length: 20 }), // POS, MARKETPLACE, STOREFRONT
+		locationId: text("location_id"), // Store location or warehouse
+		
+		// Metadata
+		ipAddress: varchar("ip_address", { length: 45 }),
+		userAgent: text("user_agent"),
+		deviceType: varchar("device_type", { length: 20 }),
+		
+		// Timestamps
+		appliedAt: timestamp("applied_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		discountIdIndex: index("idx_discount_usages_discount_id").on(table.discountId),
+		storeIdIndex: index("idx_discount_usages_store_id").on(table.storeId),
+		customerIdIndex: index("idx_discount_usages_customer_id").on(table.customerId),
+		orderIdIndex: index("idx_discount_usages_order_id").on(table.orderId),
+		appliedAtIndex: index("idx_discount_usages_applied_at").on(table.appliedAt),
+		salesChannelIndex: index("idx_discount_usages_sales_channel").on(table.salesChannel),
+	}),
+);
+
+// =====================================================
+// DISCOUNT RULES ENGINE
+// =====================================================
+
+export const discountRules = pgTable(
+	"discount_rules",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		discountId: text("discount_id").notNull(),
+		storeId: text("store_id").notNull(),
+		
+		// Rule Configuration
+		name: varchar("name", { length: 255 }).notNull(),
+		description: text("description"),
+		ruleType: varchar("rule_type", { length: 50 }).notNull(), // CONDITION, ACTION, VALIDATION
+		
+		// Rule Logic
+		conditions: jsonb("conditions").$type<Array<{
+			field: string; // e.g., "cart.total", "customer.orderCount", "product.category"
+			operator: "EQUALS" | "NOT_EQUALS" | "GREATER_THAN" | "LESS_THAN" | "IN" | "NOT_IN" | "CONTAINS" | "NOT_CONTAINS";
+			value: any;
+			logicalOperator?: "AND" | "OR";
+		}>>().notNull(),
+		
+		actions: jsonb("actions").$type<Array<{
+			type: string; // e.g., "APPLY_DISCOUNT", "ADD_FREE_PRODUCT", "UPGRADE_SHIPPING"
+			parameters: Record<string, any>;
+		}>>().default([]),
+		
+		// Execution Configuration
+		priority: integer("priority").notNull().default(0),
+		isActive: boolean("is_active").notNull().default(true),
+		
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		discountIdIndex: index("idx_discount_rules_discount_id").on(table.discountId),
+		storeIdIndex: index("idx_discount_rules_store_id").on(table.storeId),
+		priorityIndex: index("idx_discount_rules_priority").on(table.priority),
+		activeIndex: index("idx_discount_rules_active").on(table.isActive),
+	}),
+);
+
+// =====================================================
+// CUSTOMER SEGMENTS
+// =====================================================
+
+export const customerSegments = pgTable(
+	"customer_segments",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		storeId: text("store_id").notNull(),
+		
+		// Segment Information
+		name: varchar("name", { length: 255 }).notNull(),
+		description: text("description"),
+		segmentType: customerSegmentTypeEnum("segment_type").notNull(),
+		
+		// Segment Criteria
+		criteria: jsonb("criteria").$type<{
+			orderCount?: { min?: number; max?: number };
+			totalSpent?: { min?: number; max?: number };
+			lastOrderDate?: { before?: string; after?: string };
+			avgOrderValue?: { min?: number; max?: number };
+			productCategories?: string[];
+			geoLocation?: {
+				countries?: string[];
+				states?: string[];
+				cities?: string[];
+			};
+			loyaltyTier?: string;
+			registrationDate?: { before?: string; after?: string };
+			customFields?: Record<string, any>;
+		}>(),
+		
+		// Segment Statistics
+		memberCount: integer("member_count").notNull().default(0),
+		lastCalculatedAt: timestamp("last_calculated_at", { withTimezone: true }),
+		
+		// Configuration
+		isActive: boolean("is_active").notNull().default(true),
+		autoUpdate: boolean("auto_update").notNull().default(true), // Auto-recalculate membership
+		
+		// Timestamps
+		createdAt: timestamp("created_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+		updatedAt: timestamp("updated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		storeIdIndex: index("idx_customer_segments_store_id").on(table.storeId),
+		segmentTypeIndex: index("idx_customer_segments_type").on(table.segmentType),
+		activeIndex: index("idx_customer_segments_active").on(table.isActive),
+		memberCountIndex: index("idx_customer_segments_member_count").on(table.memberCount),
+	}),
+);
+
+// =====================================================
+// DISCOUNT ANALYTICS
+// =====================================================
+
+export const discountAnalytics = pgTable(
+	"discount_analytics",
+	{
+		id: text("id")
+			.primaryKey()
+			.$defaultFn(() => createId()),
+		discountId: text("discount_id").notNull(),
+		storeId: text("store_id").notNull(),
+		
+		// Time Period
+		periodType: varchar("period_type", { length: 20 }).notNull(), // DAILY, WEEKLY, MONTHLY, YEARLY
+		periodStart: timestamp("period_start", { withTimezone: true }).notNull(),
+		periodEnd: timestamp("period_end", { withTimezone: true }).notNull(),
+		
+		// Usage Metrics
+		totalUsages: integer("total_usages").notNull().default(0),
+		uniqueCustomers: integer("unique_customers").notNull().default(0),
+		totalSavings: decimal("total_savings", { precision: 12, scale: 2 }).notNull().default("0"),
+		totalRevenue: decimal("total_revenue", { precision: 12, scale: 2 }).notNull().default("0"),
+		avgOrderValue: decimal("avg_order_value", { precision: 12, scale: 2 }),
+		
+		// Performance Metrics
+		conversionRate: decimal("conversion_rate", { precision: 5, scale: 4 }),
+		roi: decimal("roi", { precision: 8, scale: 4 }), // Return on Investment
+		customerAcquisitionCost: decimal("customer_acquisition_cost", { precision: 12, scale: 2 }),
+		
+		// Channel Breakdown
+		channelBreakdown: jsonb("channel_breakdown").$type<Record<string, {
+			usages: number;
+			revenue: number;
+			savings: number;
+		}>>(),
+		
+		// Timestamps
+		calculatedAt: timestamp("calculated_at", { withTimezone: true })
+			.defaultNow()
+			.notNull(),
+	},
+	(table) => ({
+		discountIdIndex: index("idx_discount_analytics_discount_id").on(table.discountId),
+		storeIdIndex: index("idx_discount_analytics_store_id").on(table.storeId),
+		periodIndex: index("idx_discount_analytics_period").on(
+			table.periodType,
+			table.periodStart,
+			table.periodEnd,
+		),
+		calculatedAtIndex: index("idx_discount_analytics_calculated_at").on(table.calculatedAt),
+	}),
+);

package/src/schemas/product/product-relations.ts

@@ -0,0 +1,187 @@
+import { relations } from "drizzle-orm";
+import {
+	collections,
+	productAnalytics,
+	productCategories,
+	productCollections,
+	productImages,
+	productReviews,
+	products,
+	productVariants,
+	wholesalePricingTiers,
+} from "./product-schema";
+
+// =====================================================
+// PRODUCT RELATIONS
+// =====================================================
+
+export const productsRelations = relations(products, ({ many, one }) => ({
+	// One product has many variants
+	variants: many(productVariants),
+
+	// One product has many images
+	images: many(productImages),
+
+	// One product has many reviews
+	reviews: many(productReviews),
+
+	// One product has many analytics records
+	analytics: many(productAnalytics),
+
+	// One product belongs to many collections (many-to-many)
+	productCollections: many(productCollections),
+
+	// One product has many wholesale pricing tiers
+	wholesalePricingTiers: many(wholesalePricingTiers),
+
+	// One product belongs to one category (optional)
+	category: one(productCategories, {
+		fields: [products.category],
+		references: [productCategories.handle],
+	}),
+}));
+
+// =====================================================
+// PRODUCT VARIANTS RELATIONS
+// =====================================================
+
+export const productVariantsRelations = relations(
+	productVariants,
+	({ one, many }) => ({
+		// One variant belongs to one product
+		product: one(products, {
+			fields: [productVariants.productId],
+			references: [products.id],
+		}),
+
+		// One variant can have many images
+		images: many(productImages),
+
+		// One variant can have many reviews
+		reviews: many(productReviews),
+	}),
+);
+
+// =====================================================
+// COLLECTIONS RELATIONS
+// =====================================================
+
+export const collectionsRelations = relations(collections, ({ many }) => ({
+	// One collection has many products (many-to-many)
+	productCollections: many(productCollections),
+}));
+
+// =====================================================
+// PRODUCT COLLECTIONS JUNCTION RELATIONS
+// =====================================================
+
+export const productCollectionsRelations = relations(
+	productCollections,
+	({ one }) => ({
+		// Junction table relations
+		product: one(products, {
+			fields: [productCollections.productId],
+			references: [products.id],
+		}),
+
+		collection: one(collections, {
+			fields: [productCollections.collectionId],
+			references: [collections.id],
+		}),
+	}),
+);
+
+// =====================================================
+// PRODUCT IMAGES RELATIONS
+// =====================================================
+
+export const productImagesRelations = relations(productImages, ({ one }) => ({
+	// One image belongs to one product
+	product: one(products, {
+		fields: [productImages.productId],
+		references: [products.id],
+	}),
+
+	// One image can belong to one variant (optional)
+	variant: one(productVariants, {
+		fields: [productImages.variantId],
+		references: [productVariants.id],
+	}),
+}));
+
+// =====================================================
+// PRODUCT CATEGORIES RELATIONS
+// =====================================================
+
+export const productCategoriesRelations = relations(
+	productCategories,
+	({ one, many }) => ({
+		// Self-referencing relationship for hierarchy
+		parent: one(productCategories, {
+			fields: [productCategories.parentId],
+			references: [productCategories.id],
+			relationName: "CategoryParent",
+		}),
+
+		children: many(productCategories, {
+			relationName: "CategoryParent",
+		}),
+
+		// One category can have many products
+		products: many(products),
+	}),
+);
+
+// =====================================================
+// PRODUCT REVIEWS RELATIONS
+// =====================================================
+
+export const productReviewsRelations = relations(productReviews, ({ one }) => ({
+	// One review belongs to one product
+	product: one(products, {
+		fields: [productReviews.productId],
+		references: [products.id],
+	}),
+
+	// One review can belong to one variant (optional)
+	variant: one(productVariants, {
+		fields: [productReviews.variantId],
+		references: [productVariants.id],
+	}),
+}));
+
+// =====================================================
+// PRODUCT ANALYTICS RELATIONS
+// =====================================================
+
+export const productAnalyticsRelations = relations(
+	productAnalytics,
+	({ one }) => ({
+		// One analytics record belongs to one product
+		product: one(products, {
+			fields: [productAnalytics.productId],
+			references: [products.id],
+		}),
+	}),
+);
+
+// =====================================================
+// WHOLESALE PRICING TIERS RELATIONS
+// =====================================================
+
+export const wholesalePricingTiersRelations = relations(
+	wholesalePricingTiers,
+	({ one }) => ({
+		// One tier belongs to one product
+		product: one(products, {
+			fields: [wholesalePricingTiers.productId],
+			references: [products.id],
+		}),
+
+		// One tier can belong to one variant (optional)
+		variant: one(productVariants, {
+			fields: [wholesalePricingTiers.variantId],
+			references: [productVariants.id],
+		}),
+	}),
+);