@axova/shared 1.0.0

package/dist/interfaces/inventory-types.js

@@ -0,0 +1,3 @@
+"use strict";
+// Comprehensive inventory management types and interfaces
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/order-events.d.ts

@@ -0,0 +1,320 @@
+export interface OrderServiceConfig {
+    serviceName: string;
+    version: string;
+    kafkaTopics: {
+        orderCreated: string;
+        orderUpdated: string;
+        orderStatusChanged: string;
+        orderPaymentProcessed: string;
+        orderShipped: string;
+        orderDelivered: string;
+        orderCancelled: string;
+        orderRefunded: string;
+        orderNoteAdded: string;
+        orderItemAdded: string;
+        orderItemRemoved: string;
+        orderDiscountApplied: string;
+    };
+    features: {
+        multiOrderTypes: boolean;
+        advancedPayments: boolean;
+        realTimeTracking: boolean;
+        inventoryIntegration: boolean;
+        advancedDiscounts: boolean;
+        fraudDetection: boolean;
+        subscriptionSupport: boolean;
+        marketplaceIntegration: boolean;
+    };
+    limits: {
+        maxOrderValue: number;
+        maxItemsPerOrder: number;
+        maxAddressesPerOrder: number;
+        maxNotesPerOrder: number;
+        orderRetentionDays: number;
+    };
+}
+export interface OrderCreatedEvent {
+    orderId: string;
+    orderNumber: string;
+    storeId: string;
+    customerId?: string;
+    userId?: string;
+    orderType: string;
+    orderSource: string;
+    status: string;
+    totalAmount: string;
+    currency: string;
+    itemCount: number;
+    isGuestOrder: boolean;
+    paymentMethod?: string;
+    shippingRequired: boolean;
+    priority: string;
+}
+export interface OrderUpdatedEvent {
+    orderId: string;
+    orderNumber: string;
+    storeId: string;
+    customerId?: string;
+    changes: Record<string, unknown>;
+    previousValues: Record<string, unknown>;
+    statusChanged: boolean;
+    paymentStatusChanged: boolean;
+    fulfillmentStatusChanged: boolean;
+    amountChanged: boolean;
+}
+export interface OrderStatusChangedEvent {
+    orderId: string;
+    orderNumber: string;
+    storeId: string;
+    customerId?: string;
+    fromStatus: string;
+    toStatus: string;
+    reason?: string;
+    actorId: string;
+    actorType: string;
+    timestamp: string;
+}
+export interface OrderPaymentProcessedEvent {
+    orderId: string;
+    paymentId: string;
+    transactionId?: string;
+    paymentMethod: string;
+    paymentProvider?: string;
+    amount: string;
+    currency: string;
+    status: string;
+    isSuccessful: boolean;
+    failureReason?: string;
+}
+export interface OrderShippedEvent {
+    orderId: string;
+    fulfillmentId: string;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    shippingCarrier?: string;
+    shippingService?: string;
+    estimatedDeliveryDate?: string;
+    packedBy?: string;
+    shippedBy?: string;
+}
+export interface OrderDeliveredEvent {
+    orderId: string;
+    fulfillmentId: string;
+    deliveredAt: string;
+    deliveredBy?: string;
+    signedBy?: string;
+    deliveryLocation?: string;
+    proofOfDelivery?: Record<string, unknown>;
+}
+export interface OrderCancelledEvent {
+    orderId: string;
+    orderNumber: string;
+    storeId: string;
+    customerId?: string;
+    cancellationReason: string;
+    cancelledBy: string;
+    cancelledByType: string;
+    refundRequired: boolean;
+    refundAmount?: string;
+    inventoryReleased: boolean;
+}
+export interface OrderRefundedEvent {
+    orderId: string;
+    paymentId: string;
+    refundId: string;
+    refundAmount: string;
+    refundReason: string;
+    refundMethod: string;
+    isPartialRefund: boolean;
+    processedBy: string;
+    customerNotified: boolean;
+}
+export interface OrderNoteAddedEvent {
+    orderId: string;
+    noteId: string;
+    noteType: string;
+    content: string;
+    isCustomerVisible: boolean;
+    priority: string;
+    createdBy: string;
+    createdByName: string;
+    requiresFollowUp: boolean;
+}
+export interface OrderItemAddedEvent {
+    orderId: string;
+    itemId: string;
+    productId: string;
+    variantId?: string;
+    sku: string;
+    productTitle: string;
+    quantity: number;
+    unitPrice: string;
+    totalPrice: string;
+    addedBy: string;
+}
+export interface OrderItemRemovedEvent {
+    orderId: string;
+    itemId: string;
+    productId: string;
+    sku: string;
+    productTitle: string;
+    quantity: number;
+    removedBy: string;
+    removalReason?: string;
+}
+export interface OrderDiscountAppliedEvent {
+    orderId: string;
+    discountId: string;
+    discountCode?: string;
+    discountType: string;
+    discountAmount: string;
+    discountPercentage?: number;
+    appliedBy?: string;
+    campaignId?: string;
+}
+export type OrderServiceEvent = OrderCreatedEvent | OrderUpdatedEvent | OrderStatusChangedEvent | OrderPaymentProcessedEvent | OrderShippedEvent | OrderDeliveredEvent | OrderCancelledEvent | OrderRefundedEvent | OrderNoteAddedEvent | OrderItemAddedEvent | OrderItemRemovedEvent | OrderDiscountAppliedEvent;
+export interface OrderEventHandler<T = OrderServiceEvent> {
+    handle(event: T): Promise<void>;
+    canHandle(eventType: string): boolean;
+    priority: number;
+}
+export interface OrderEventEmitter {
+    emit(eventType: string, data: OrderServiceEvent): Promise<void>;
+    on(eventType: string, handler: OrderEventHandler): void;
+    off(eventType: string, handler: OrderEventHandler): void;
+    removeAllListeners(): void;
+}
+export interface OrderCalculation {
+    subtotal: string;
+    taxAmount: string;
+    shippingAmount: string;
+    discountAmount: string;
+    totalAmount: string;
+    currency: string;
+}
+export interface OrderValidation {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface OrderInventoryCheck {
+    isAvailable: boolean;
+    unavailableItems: Array<{
+        productId: string;
+        variantId?: string;
+        requestedQuantity: number;
+        availableQuantity: number;
+        reason: string;
+    }>;
+}
+export interface OrderFraudCheck {
+    riskScore: number;
+    riskLevel: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    fraudIndicators: string[];
+    recommendation: "APPROVE" | "REVIEW" | "DECLINE";
+    requiresManualReview: boolean;
+}
+export interface OrderShippingCalculation {
+    rates: Array<{
+        carrier: string;
+        service: string;
+        cost: string;
+        estimatedDays: number;
+        estimatedDeliveryDate: string;
+    }>;
+    recommendedRate?: {
+        carrier: string;
+        service: string;
+        cost: string;
+    };
+}
+export interface OrderSplitRequest {
+    originalOrderId: string;
+    splitReason: string;
+    splits: Array<{
+        items: Array<{
+            orderItemId: string;
+            quantity: number;
+        }>;
+        shippingAddress?: Record<string, unknown>;
+        fulfillmentType?: string;
+        priority?: string;
+    }>;
+}
+export interface OrderMergeRequest {
+    orderIds: string[];
+    mergeReason: string;
+    newShippingAddress?: Record<string, unknown>;
+    newPaymentMethod?: string;
+}
+export interface OrderModificationRequest {
+    orderId: string;
+    modificationType: "ADD_ITEM" | "REMOVE_ITEM" | "UPDATE_QUANTITY" | "CHANGE_ADDRESS" | "CHANGE_PAYMENT";
+    modifications: Record<string, unknown>;
+    reason: string;
+    requestedBy: string;
+}
+export interface OrderEscalationRequest {
+    orderId: string;
+    escalationType: "PAYMENT_ISSUE" | "SHIPPING_DELAY" | "QUALITY_ISSUE" | "CUSTOMER_COMPLAINT" | "FRAUD_ALERT";
+    priority: "LOW" | "MEDIUM" | "HIGH" | "URGENT";
+    description: string;
+    assignedTo?: string;
+    department?: string;
+}
+export interface OrderMetrics {
+    totalOrders: number;
+    totalRevenue: string;
+    averageOrderValue: string;
+    ordersByStatus: Record<string, number>;
+    ordersByType: Record<string, number>;
+    ordersBySource: Record<string, number>;
+    conversionRate: number;
+    cancelationRate: number;
+    refundRate: number;
+    averageProcessingTime: number;
+    customerSatisfactionScore?: number;
+}
+export interface OrderReportFilter {
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+    storeIds?: string[];
+    orderTypes?: string[];
+    orderSources?: string[];
+    customerTypes?: string[];
+    paymentMethods?: string[];
+    statuses?: string[];
+    minAmount?: number;
+    maxAmount?: number;
+    includeTestOrders?: boolean;
+}
+export interface MarketplaceOrderSync {
+    marketplacePlatform: string;
+    externalOrderId: string;
+    syncStatus: "PENDING" | "SUCCESS" | "FAILED";
+    lastSyncAt?: string;
+    syncErrors?: string[];
+    marketplaceData?: Record<string, unknown>;
+}
+export interface InventoryReservation {
+    orderId: string;
+    reservations: Array<{
+        productId: string;
+        variantId?: string;
+        quantity: number;
+        locationId: string;
+        reservedAt: string;
+        expiresAt: string;
+    }>;
+}
+export interface PaymentIntentRequest {
+    orderId: string;
+    amount: string;
+    currency: string;
+    paymentMethod: string;
+    customerInfo: Record<string, unknown>;
+    billingAddress: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}

package/dist/interfaces/order-events.js

@@ -0,0 +1,3 @@
+"use strict";
+// Order Service Event Interfaces
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/auditLogger.d.ts

@@ -0,0 +1,162 @@
+export interface AuditLogEntry {
+    eventType: "CREATE" | "UPDATE" | "DELETE" | "LOGIN" | "LOGOUT" | "ACCESS" | "PERMISSION_CHANGE" | "SYSTEM_ACTION" | "COMPLIANCE_ACTION" | "SECURITY_EVENT";
+    eventCategory: "USER_ACTION" | "SYSTEM_ACTION" | "ADMIN_ACTION" | "COMPLIANCE_ACTION" | "SECURITY_ACTION" | "DATA_ACTION" | "NOTIFICATION_ACTION";
+    action: string;
+    resource: string;
+    resourceId: string;
+    resourceType?: "STORE" | "USER" | "PRODUCT" | "ORDER" | "COMPLIANCE" | "POLICY" | "VIOLATION" | "APPEAL" | "NOTIFICATION" | "SYSTEM" | "OTHER";
+    performedBy: string;
+    performedByType: "USER" | "SYSTEM" | "ADMIN" | "SERVICE" | "AI" | "AUTOMATION" | "ANONYMOUS";
+    performedByName?: string;
+    sessionId?: string;
+    requestId?: string;
+    correlationId?: string;
+    ipAddress?: string;
+    userAgent?: string;
+    clientType?: "WEB" | "MOBILE_APP" | "API" | "ADMIN_PANEL" | "SYSTEM" | "WEBHOOK" | "CRON_JOB";
+    clientId?: string;
+    clientVersion?: string;
+    location?: {
+        country?: string;
+        region?: string;
+        city?: string;
+        coordinates?: {
+            lat: number;
+            lng: number;
+        };
+        timezone?: string;
+    };
+    changes?: {
+        before?: Record<string, unknown>;
+        after?: Record<string, unknown>;
+        fields?: string[];
+    };
+    metadata?: {
+        businessImpact?: string;
+        severity?: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        tags?: string[];
+        department?: string;
+        project?: string;
+        feature?: string;
+        version?: string;
+        environment?: "DEVELOPMENT" | "STAGING" | "PRODUCTION";
+        customFields?: Record<string, unknown>;
+    };
+    success?: boolean;
+    errorCode?: string;
+    errorMessage?: string;
+    stackTrace?: string;
+    duration?: number;
+    size?: number;
+    sensitiveData?: boolean;
+    piiInvolved?: boolean;
+    complianceRelevant?: boolean;
+    retentionPeriod?: number;
+    riskLevel?: "NONE" | "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    securityImpact?: "NONE" | "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    workflowId?: string;
+    workflowStep?: string;
+    parentEventId?: string;
+    storeId?: string;
+    storeName?: string;
+    storeSubdomain?: string;
+}
+export interface AuditContext {
+    serviceName: string;
+    serviceVersion?: string;
+    requestId?: string;
+    correlationId?: string;
+    sessionId?: string;
+    userId?: string;
+    userType?: "USER" | "ADMIN" | "SYSTEM" | "SERVICE";
+    ipAddress?: string;
+    userAgent?: string;
+    clientId?: string;
+    clientType?: "WEB" | "MOBILE_APP" | "API" | "ADMIN_PANEL" | "SYSTEM" | "WEBHOOK" | "CRON_JOB";
+    storeId?: string;
+    storeName?: string;
+    environment?: "DEVELOPMENT" | "STAGING" | "PRODUCTION";
+    features?: string[];
+    tags?: string[];
+    customMetadata?: Record<string, unknown>;
+}
+export interface PerformanceTracker {
+    start: number;
+    end(): number;
+    duration(): number;
+}
+export interface AuditLoggerConfig {
+    serviceName: string;
+    serviceVersion?: string;
+    environment?: "DEVELOPMENT" | "STAGING" | "PRODUCTION";
+    auditServiceUrl?: string;
+    auditServiceApiKey?: string;
+    enableLocalLogging?: boolean;
+    enableRemoteLogging?: boolean;
+    bufferSize?: number;
+    flushInterval?: number;
+    defaultRetentionDays?: number;
+    autoEnrichment?: boolean;
+    sensitiveFieldMasking?: boolean;
+    geoLocationEnabled?: boolean;
+}
+export interface QuickActionBuilders {
+    userLogin: (userId: string, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    userLogout: (userId: string, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    dataAccess: (resource: string, resourceId: string, userId: string, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    dataCreate: (resource: string, resourceId: string, userId: string, data?: unknown, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    dataUpdate: (resource: string, resourceId: string, userId: string, changes?: unknown, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    dataDelete: (resource: string, resourceId: string, userId: string, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    permissionChange: (targetUserId: string, changedBy: string, changes: unknown, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    securityEvent: (eventType: string, description: string, severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL", additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    complianceEvent: (framework: string, requirement: string, status: "MET" | "NOT_MET", additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    systemAction: (action: string, resource: string, resourceId: string, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+    storeAction: (storeId: string, action: string, resource: string, resourceId: string, userId?: string, additionalData?: Partial<AuditLogEntry>) => AuditLogEntry;
+}
+export declare class AuditLogger {
+    private config;
+    private context;
+    private buffer;
+    private flushTimer;
+    private performanceTrackers;
+    constructor(config: AuditLoggerConfig, initialContext?: Partial<AuditContext>);
+    updateContext(contextUpdate: Partial<AuditContext>): void;
+    getContext(): AuditContext;
+    log(entry: Partial<AuditLogEntry>): Promise<string>;
+    startPerformanceTracking(operationId?: string): string;
+    endPerformanceTracking(operationId: string): number;
+    get quick(): QuickActionBuilders;
+    logUserLogin(userId: string, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+    logUserLogout(userId: string, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+    logDataAccess(resource: string, resourceId: string, userId: string, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+    logDataCreate(resource: string, resourceId: string, userId: string, data?: unknown, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+    logDataUpdate(resource: string, resourceId: string, userId: string, changes?: unknown, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+    logDataDelete(resource: string, resourceId: string, userId: string, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+    logSecurityEvent(eventType: string, description: string, severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL", additionalData?: Partial<AuditLogEntry>): Promise<string>;
+    logStoreAction(storeId: string, action: string, resource: string, resourceId: string, userId?: string, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+    auditedOperation<T>(operationName: string, operation: () => Promise<T>, auditData: Partial<AuditLogEntry>): Promise<{
+        result: T;
+        auditId: string;
+        duration: number;
+    }>;
+    logBatch(entries: Partial<AuditLogEntry>[]): Promise<string[]>;
+    flush(): Promise<void>;
+    private enrichEntry;
+    private addToBuffer;
+    private logLocally;
+    private getLogLevel;
+    private isCriticalEvent;
+    private sendToAuditService;
+    private maskSensitiveData;
+    private setupAutoFlush;
+    shutdown(): Promise<void>;
+}
+export declare function createAuditLogger(config: AuditLoggerConfig, initialContext?: Partial<AuditContext>): AuditLogger;
+export declare function createAuditMiddleware(logger: AuditLogger): (req: any, _res: unknown, next: () => void) => void;
+export declare function logAuditEvent(serviceName: string, entry: Partial<AuditLogEntry>, context?: Partial<AuditContext>): Promise<string>;
+export declare function logStoreAuditEvent(serviceName: string, storeId: string, action: string, resource: string, resourceId: string, userId?: string, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+export declare function setDefaultAuditLogger(logger: AuditLogger): void;
+export declare function getDefaultAuditLogger(): AuditLogger;
+export declare function quickLog(entry: Partial<AuditLogEntry>): Promise<string>;
+export declare function quickLogUserAction(action: string, resource: string, resourceId: string, userId: string, additionalData?: Partial<AuditLogEntry>): Promise<string>;
+export declare function quickLogSystemAction(action: string, resource: string, resourceId: string, additionalData?: Partial<AuditLogEntry>): Promise<string>;