universal-agent-memory 0.7.3 → 0.8.0

package/dist/utils/order-processor.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Order Processing System - SOLID Principles Implementation
+ *
+ * This module demonstrates a refactored order processing system using:
+ * - Single Responsibility Principle: Each strategy handles one order type
+ * - Open/Closed Principle: New order types can be added without modifying existing code
+ * - Liskov Substitution Principle: All strategies can be used interchangeably
+ * - Interface Segregation Principle: Focused interfaces for specific needs
+ * - Dependency Inversion Principle: Depends on abstractions (interfaces) not concretions
+ */
+import { z } from 'zod';
+/**
+ * Order type enum
+ */
+export declare enum OrderType {
+    DIGITAL = "digital",
+    PHYSICAL = "physical",
+    SUBSCRIPTION = "subscription"
+}
+/**
+ * Order status enum
+ */
+export declare enum OrderStatus {
+    PENDING = "pending",
+    DELIVERED = "delivered",
+    SHIPPED = "shipped",
+    ACTIVE = "active"
+}
+/**
+ * Order interface
+ */
+export interface Order {
+    id: string;
+    type: OrderType;
+    status: OrderStatus;
+    customerId: string;
+    items: Array<{
+        productId: string;
+        quantity: number;
+        price: number;
+    }>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Order processing result interface
+ */
+export interface ProcessingResult {
+    success: boolean;
+    order: Order;
+    message: string;
+}
+/**
+ * Order validation schema using Zod
+ */
+export declare const OrderSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodNativeEnum<typeof OrderType>;
+    status: z.ZodDefault<z.ZodNativeEnum<typeof OrderStatus>>;
+    customerId: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        quantity: z.ZodNumber;
+        price: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        price: number;
+        productId: string;
+        quantity: number;
+    }, {
+        price: number;
+        productId: string;
+        quantity: number;
+    }>, "many">;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    type: OrderType;
+    status: OrderStatus;
+    id: string;
+    createdAt: Date;
+    customerId: string;
+    items: {
+        price: number;
+        productId: string;
+        quantity: number;
+    }[];
+    updatedAt: Date;
+}, {
+    type: OrderType;
+    id: string;
+    createdAt: Date;
+    customerId: string;
+    items: {
+        price: number;
+        productId: string;
+        quantity: number;
+    }[];
+    updatedAt: Date;
+    status?: OrderStatus | undefined;
+}>;
+/**
+ * OrderProcessor strategy interface
+ * All order processors must implement this interface
+ */
+export interface OrderProcessor {
+    /**
+     * Process an order according to its type
+     * @param order - The order to process
+     * @returns Processing result with updated order status
+     * @throws {Error} If processing fails
+     */
+    process(order: Order): Promise<ProcessingResult>;
+    /**
+     * Validate that the order can be processed
+     * @param order - The order to validate
+     * @returns true if valid, false otherwise
+     */
+    validate(order: Order): boolean;
+}
+/**
+ * Digital order processor strategy
+ * Handles delivery of digital products via email
+ */
+export declare class DigitalOrderProcessor implements OrderProcessor {
+    /**
+     * Process a digital order
+     * @param order - The digital order to process
+     * @returns Processing result with delivered status
+     * @throws {Error} If email delivery fails
+     */
+    process(order: Order): Promise<ProcessingResult>;
+    /**
+     * Validate digital order requirements
+     * @param order - The order to validate
+     * @returns true if valid for digital processing
+     */
+    validate(order: Order): boolean;
+    /**
+     * Send download link email to customer
+     * @param order - The order containing customer information
+     * @throws {Error} If email cannot be sent
+     */
+    private sendDownloadLinkEmail;
+}
+/**
+ * Physical order processor strategy
+ * Handles shipping of physical products
+ */
+export declare class PhysicalOrderProcessor implements OrderProcessor {
+    /**
+     * Process a physical order
+     * @param order - The physical order to process
+     * @returns Processing result with shipped status
+     * @throws {Error} If shipping label creation fails
+     */
+    process(order: Order): Promise<ProcessingResult>;
+    /**
+     * Validate physical order requirements
+     * @param order - The order to validate
+     * @returns true if valid for physical processing
+     */
+    validate(order: Order): boolean;
+    /**
+     * Create shipping label for the order
+     * @param order - The order to create label for
+     * @throws {Error} If shipping label cannot be created
+     */
+    private createShippingLabel;
+}
+/**
+ * Subscription order processor strategy
+ * Handles activation of subscription services
+ */
+export declare class SubscriptionOrderProcessor implements OrderProcessor {
+    /**
+     * Process a subscription order
+     * @param order - The subscription order to process
+     * @returns Processing result with active status
+     * @throws {Error} If subscription activation fails
+     */
+    process(order: Order): Promise<ProcessingResult>;
+    /**
+     * Validate subscription order requirements
+     * @param order - The order to validate
+     * @returns true if valid for subscription processing
+     */
+    validate(order: Order): boolean;
+    /**
+     * Activate subscription service
+     * @param order - The order containing subscription details
+     * @throws {Error} If subscription cannot be activated
+     */
+    private activateSubscription;
+}
+/**
+ * OrderProcessor factory
+ * Responsible for selecting the appropriate processor based on order type
+ * Follows Factory pattern for dependency injection
+ */
+export declare class OrderProcessorFactory {
+    private readonly processors;
+    constructor();
+    /**
+     * Get the appropriate processor for the given order type
+     * @param orderType - The type of order
+     * @returns The appropriate order processor
+     * @throws {Error} If no processor is found for the order type
+     */
+    getProcessor(orderType: OrderType): OrderProcessor;
+    /**
+     * Register a new processor for a specific order type
+     * @param orderType - The order type to handle
+     * @param processor - The processor implementation
+     */
+    registerProcessor(orderType: OrderType, processor: OrderProcessor): void;
+    /**
+     * Check if a processor is registered for the given order type
+     * @param orderType - The order type to check
+     * @returns true if a processor exists
+     */
+    hasProcessor(orderType: OrderType): boolean;
+}
+/**
+ * OrderProcessingService
+ * Main service that coordinates order processing using the appropriate strategy
+ */
+export declare class OrderProcessingService {
+    private readonly processorFactory;
+    constructor(processorFactory?: OrderProcessorFactory);
+    /**
+     * Process an order using the appropriate strategy
+     * @param orderInput - The order data to process (may be unvalidated)
+     * @returns Processing result with updated order
+     * @throws {Error} If validation fails or processing encounters an error
+     */
+    processOrder(orderInput: unknown): Promise<ProcessingResult>;
+}
+/**
+ * Example usage demonstrating the refactored code
+ */
+export declare function exampleUsage(): Promise<void>;
+//# sourceMappingURL=order-processor.d.ts.map

package/dist/utils/order-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-processor.d.ts","sourceRoot":"","sources":["../../src/utils/order-processor.ts"],"names":[],"mappings":"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"}

package/dist/utils/order-processor.js

@@ -0,0 +1,370 @@
+/**
+ * Order Processing System - SOLID Principles Implementation
+ *
+ * This module demonstrates a refactored order processing system using:
+ * - Single Responsibility Principle: Each strategy handles one order type
+ * - Open/Closed Principle: New order types can be added without modifying existing code
+ * - Liskov Substitution Principle: All strategies can be used interchangeably
+ * - Interface Segregation Principle: Focused interfaces for specific needs
+ * - Dependency Inversion Principle: Depends on abstractions (interfaces) not concretions
+ */
+import { z } from 'zod';
+/**
+ * Order type enum
+ */
+export var OrderType;
+(function (OrderType) {
+    OrderType["DIGITAL"] = "digital";
+    OrderType["PHYSICAL"] = "physical";
+    OrderType["SUBSCRIPTION"] = "subscription";
+})(OrderType || (OrderType = {}));
+/**
+ * Order status enum
+ */
+export var OrderStatus;
+(function (OrderStatus) {
+    OrderStatus["PENDING"] = "pending";
+    OrderStatus["DELIVERED"] = "delivered";
+    OrderStatus["SHIPPED"] = "shipped";
+    OrderStatus["ACTIVE"] = "active";
+})(OrderStatus || (OrderStatus = {}));
+/**
+ * Order validation schema using Zod
+ */
+export const OrderSchema = z.object({
+    id: z.string().min(1, 'Order ID is required'),
+    type: z.nativeEnum(OrderType),
+    status: z.nativeEnum(OrderStatus).default(OrderStatus.PENDING),
+    customerId: z.string().min(1, 'Customer ID is required'),
+    items: z.array(z.object({
+        productId: z.string().min(1, 'Product ID is required'),
+        quantity: z.number().int().positive('Quantity must be positive'),
+        price: z.number().positive('Price must be positive'),
+    })).min(1, 'At least one item is required'),
+    createdAt: z.date(),
+    updatedAt: z.date(),
+});
+/**
+ * Digital order processor strategy
+ * Handles delivery of digital products via email
+ */
+export class DigitalOrderProcessor {
+    /**
+     * Process a digital order
+     * @param order - The digital order to process
+     * @returns Processing result with delivered status
+     * @throws {Error} If email delivery fails
+     */
+    async process(order) {
+        try {
+            // Send email with download link
+            await this.sendDownloadLinkEmail(order);
+            const processedOrder = {
+                ...order,
+                status: OrderStatus.DELIVERED,
+                updatedAt: new Date(),
+            };
+            console.log(`Digital order ${order.id} delivered successfully`);
+            return {
+                success: true,
+                order: processedOrder,
+                message: `Digital order ${order.id} has been delivered via email`,
+            };
+        }
+        catch (error) {
+            console.error(`Failed to process digital order ${order.id}:`, error);
+            throw new Error(`Failed to process digital order: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Validate digital order requirements
+     * @param order - The order to validate
+     * @returns true if valid for digital processing
+     */
+    validate(order) {
+        return order.type === OrderType.DIGITAL && order.status === OrderStatus.PENDING;
+    }
+    /**
+     * Send download link email to customer
+     * @param order - The order containing customer information
+     * @throws {Error} If email cannot be sent
+     */
+    async sendDownloadLinkEmail(order) {
+        // Simulate email sending
+        console.log(`Sending email with download link for order ${order.id} to customer ${order.customerId}`);
+        // In production: await emailService.sendDownloadLink(order.customerId, order.items);
+    }
+}
+/**
+ * Physical order processor strategy
+ * Handles shipping of physical products
+ */
+export class PhysicalOrderProcessor {
+    /**
+     * Process a physical order
+     * @param order - The physical order to process
+     * @returns Processing result with shipped status
+     * @throws {Error} If shipping label creation fails
+     */
+    async process(order) {
+        try {
+            // Create shipping label
+            await this.createShippingLabel(order);
+            const processedOrder = {
+                ...order,
+                status: OrderStatus.SHIPPED,
+                updatedAt: new Date(),
+            };
+            console.log(`Physical order ${order.id} shipped successfully`);
+            return {
+                success: true,
+                order: processedOrder,
+                message: `Physical order ${order.id} has been shipped`,
+            };
+        }
+        catch (error) {
+            console.error(`Failed to process physical order ${order.id}:`, error);
+            throw new Error(`Failed to process physical order: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Validate physical order requirements
+     * @param order - The order to validate
+     * @returns true if valid for physical processing
+     */
+    validate(order) {
+        return order.type === OrderType.PHYSICAL && order.status === OrderStatus.PENDING;
+    }
+    /**
+     * Create shipping label for the order
+     * @param order - The order to create label for
+     * @throws {Error} If shipping label cannot be created
+     */
+    async createShippingLabel(_order) {
+        // Intentionally unused in this stub implementation
+        console.log('Creating shipping label');
+        // In production: await shippingService.createLabel(order);
+    }
+}
+/**
+ * Subscription order processor strategy
+ * Handles activation of subscription services
+ */
+export class SubscriptionOrderProcessor {
+    /**
+     * Process a subscription order
+     * @param order - The subscription order to process
+     * @returns Processing result with active status
+     * @throws {Error} If subscription activation fails
+     */
+    async process(order) {
+        try {
+            // Activate subscription
+            await this.activateSubscription(order);
+            const processedOrder = {
+                ...order,
+                status: OrderStatus.ACTIVE,
+                updatedAt: new Date(),
+            };
+            console.log(`Subscription order ${order.id} activated successfully`);
+            return {
+                success: true,
+                order: processedOrder,
+                message: `Subscription order ${order.id} has been activated`,
+            };
+        }
+        catch (error) {
+            console.error(`Failed to process subscription order ${order.id}:`, error);
+            throw new Error(`Failed to process subscription order: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Validate subscription order requirements
+     * @param order - The order to validate
+     * @returns true if valid for subscription processing
+     */
+    validate(order) {
+        return order.type === OrderType.SUBSCRIPTION && order.status === OrderStatus.PENDING;
+    }
+    /**
+     * Activate subscription service
+     * @param order - The order containing subscription details
+     * @throws {Error} If subscription cannot be activated
+     */
+    async activateSubscription(_order) {
+        // Intentionally unused in this stub implementation
+        console.log('Activating subscription');
+        // In production: await subscriptionService.activate(order.customerId, order.items);
+    }
+}
+/**
+ * OrderProcessor factory
+ * Responsible for selecting the appropriate processor based on order type
+ * Follows Factory pattern for dependency injection
+ */
+export class OrderProcessorFactory {
+    processors;
+    constructor() {
+        // Register all available processors
+        this.processors = newMap([
+            [OrderType.DIGITAL, new DigitalOrderProcessor()],
+            [OrderType.PHYSICAL, new PhysicalOrderProcessor()],
+            [OrderType.SUBSCRIPTION, new SubscriptionOrderProcessor()],
+        ]);
+    }
+    /**
+     * Get the appropriate processor for the given order type
+     * @param orderType - The type of order
+     * @returns The appropriate order processor
+     * @throws {Error} If no processor is found for the order type
+     */
+    getProcessor(orderType) {
+        const processor = this.processors.get(orderType);
+        if (!processor) {
+            throw new Error(`No processor found for order type: ${orderType}`);
+        }
+        return processor;
+    }
+    /**
+     * Register a new processor for a specific order type
+     * @param orderType - The order type to handle
+     * @param processor - The processor implementation
+     */
+    registerProcessor(orderType, processor) {
+        this.processors.set(orderType, processor);
+    }
+    /**
+     * Check if a processor is registered for the given order type
+     * @param orderType - The order type to check
+     * @returns true if a processor exists
+     */
+    hasProcessor(orderType) {
+        return this.processors.has(orderType);
+    }
+}
+/**
+ * Helper function to create a typed Map
+ * @param entries - Initial entries for the Map
+ * @returns A new Map with the specified entries
+ */
+function newMap(entries) {
+    return new Map(entries);
+}
+/**
+ * OrderProcessingService
+ * Main service that coordinates order processing using the appropriate strategy
+ */
+export class OrderProcessingService {
+    processorFactory;
+    constructor(processorFactory) {
+        this.processorFactory = processorFactory || new OrderProcessorFactory();
+    }
+    /**
+     * Process an order using the appropriate strategy
+     * @param orderInput - The order data to process (may be unvalidated)
+     * @returns Processing result with updated order
+     * @throws {Error} If validation fails or processing encounters an error
+     */
+    async processOrder(orderInput) {
+        try {
+            // Validate input using Zod schema
+            const order = OrderSchema.parse(orderInput);
+            console.log(`Processing order ${order.id} of type ${order.type}`);
+            // Get the appropriate processor
+            const processor = this.processorFactory.getProcessor(order.type);
+            // Validate that the order can be processed
+            if (!processor.validate(order)) {
+                throw new Error(`Order ${order.id} with status ${order.status} cannot be processed`);
+            }
+            // Process the order using the selected strategy
+            const result = await processor.process(order);
+            console.log(result.message);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                console.error('Validation error:', error.errors);
+                throw new Error(`Order validation failed: ${error.errors.map(e => e.message).join(', ')}`);
+            }
+            console.error('Order processing error:', error);
+            throw error;
+        }
+    }
+}
+/**
+ * Example usage demonstrating the refactored code
+ */
+export async function exampleUsage() {
+    // Initialize the service
+    const orderService = new OrderProcessingService();
+    // Example 1: Digital order
+    const digitalOrder = {
+        id: 'ORD-001',
+        type: OrderType.DIGITAL,
+        status: OrderStatus.PENDING,
+        customerId: 'CUST-123',
+        items: [
+            {
+                productId: 'PROD-DIG-001',
+                quantity: 1,
+                price: 29.99,
+            },
+        ],
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    };
+    try {
+        const result1 = await orderService.processOrder(digitalOrder);
+        console.log('Result:', result1);
+    }
+    catch (error) {
+        console.error('Error:', error);
+    }
+    // Example 2: Physical order
+    const physicalOrder = {
+        id: 'ORD-002',
+        type: OrderType.PHYSICAL,
+        status: OrderStatus.PENDING,
+        customerId: 'CUST-456',
+        items: [
+            {
+                productId: 'PROD-PHY-001',
+                quantity: 2,
+                price: 49.99,
+            },
+        ],
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    };
+    try {
+        const result2 = await orderService.processOrder(physicalOrder);
+        console.log('Result:', result2);
+    }
+    catch (error) {
+        console.error('Error:', error);
+    }
+    // Example 3: Subscription order
+    const subscriptionOrder = {
+        id: 'ORD-003',
+        type: OrderType.SUBSCRIPTION,
+        status: OrderStatus.PENDING,
+        customerId: 'CUST-789',
+        items: [
+            {
+                productId: 'PROD-SUB-001',
+                quantity: 1,
+                price: 19.99,
+            },
+        ],
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    };
+    try {
+        const result3 = await orderService.processOrder(subscriptionOrder);
+        console.log('Result:', result3);
+    }
+    catch (error) {
+        console.error('Error:', error);
+    }
+}
+//# sourceMappingURL=order-processor.js.map

package/dist/utils/order-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-processor.js","sourceRoot":"","sources":["../../src/utils/order-processor.ts"],"names":[],"mappings":"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"}

package/dist/utils/rate-limiter-simple.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Configuration options for the RateLimiter.
+ */
+export interface RateLimiterConfig {
+    /** Maximum number of requests allowed within the time window */
+    maxRequests: number;
+    /** Time window in milliseconds */
+    windowMs: number;
+}
+/**
+ * A sliding-window rate limiter that tracks requests per client.
+ * Uses a Map to store request timestamps for each client and
+ * automatically cleans up expired entries.
+ */
+export declare class RateLimiter {
+    private readonly maxRequests;
+    private readonly windowMs;
+    private readonly clients;
+    /**
+     * Creates a new RateLimiter instance.
+     *
+     * @param config - Configuration for request limits and time window
+     * @throws Error if maxRequests or windowMs are not positive numbers
+     */
+    constructor(config: RateLimiterConfig);
+    /**
+     * Checks if a request from the given client is allowed.
+     * If allowed, records the request timestamp.
+     *
+     * @param clientId - Unique identifier for the client
+     * @returns True if the request is allowed, false if rate limited
+     */
+    isAllowed(clientId: string): boolean;
+    /**
+     * Returns the number of remaining requests for a client within the current window.
+     *
+     * @param clientId - Unique identifier for the client
+     * @returns Number of remaining allowed requests
+     */
+    getRemainingRequests(clientId: string): number;
+    /**
+     * Resets rate limiting state.
+     * If clientId is provided, resets only that client.
+     * Otherwise, resets all clients.
+     *
+     * @param clientId - Optional client identifier to reset
+     */
+    reset(clientId?: string): void;
+    /**
+     * Removes expired timestamps from a client's entry.
+     * Deletes the entry entirely if no valid timestamps remain.
+     *
+     * @param clientId - Client identifier to clean up
+     * @param now - Current timestamp for expiration calculation
+     */
+    private cleanupExpiredEntries;
+}
+//# sourceMappingURL=rate-limiter-simple.d.ts.map

package/dist/utils/rate-limiter-simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter-simple.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter-simple.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D;;;;;OAKG;gBACS,MAAM,EAAE,iBAAiB;IAqBrC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAmBpC;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAa9C;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAgB9B"}