@woltz/rich-domain 0.2.1

package/dist/domain-event-bus.js

@@ -0,0 +1,112 @@
+// ============================================================================
+// Domain Event Bus - Pub/Sub for Domain Events
+// ============================================================================
+/**
+ * Domain Event Bus - Singleton pattern for event pub/sub
+ */
+export class DomainEventBus {
+    constructor() {
+        this.handlers = new Map();
+        this.wildcardHandlers = new Set();
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!DomainEventBus.instance) {
+            DomainEventBus.instance = new DomainEventBus();
+        }
+        return DomainEventBus.instance;
+    }
+    /**
+     * Subscribe to a specific event type
+     */
+    subscribe(eventType, handler) {
+        const eventName = typeof eventType === "string" ? eventType : eventType.name;
+        if (!this.handlers.has(eventName)) {
+            this.handlers.set(eventName, new Set());
+        }
+        this.handlers.get(eventName).add(handler);
+    }
+    /**
+     * Subscribe to all events (wildcard)
+     */
+    subscribeAll(handler) {
+        this.wildcardHandlers.add(handler);
+    }
+    /**
+     * Unsubscribe from a specific event type
+     */
+    unsubscribe(eventType, handler) {
+        const eventName = typeof eventType === "string" ? eventType : eventType.name;
+        const handlers = this.handlers.get(eventName);
+        if (handlers) {
+            handlers.delete(handler);
+            if (handlers.size === 0) {
+                this.handlers.delete(eventName);
+            }
+        }
+    }
+    /**
+     * Unsubscribe from all events
+     */
+    unsubscribeAll(handler) {
+        this.wildcardHandlers.delete(handler);
+    }
+    /**
+     * Publish a single event
+     */
+    async publish(event) {
+        const eventName = event.eventName;
+        const handlers = this.handlers.get(eventName) || new Set();
+        // Execute specific handlers
+        const specificPromises = Array.from(handlers).map((handler) => this.executeHandler(handler, event));
+        // Execute wildcard handlers
+        const wildcardPromises = Array.from(this.wildcardHandlers).map((handler) => this.executeHandler(handler, event));
+        await Promise.all([...specificPromises, ...wildcardPromises]);
+    }
+    /**
+     * Publish multiple events
+     */
+    async publishAll(events) {
+        await Promise.all(events.map((event) => this.publish(event)));
+    }
+    /**
+     * Clear all handlers (useful for testing)
+     */
+    clearAllHandlers() {
+        this.handlers.clear();
+        this.wildcardHandlers.clear();
+    }
+    /**
+     * Get count of handlers for an event type
+     */
+    getHandlerCount(eventType) {
+        const eventName = typeof eventType === "string" ? eventType : eventType.name;
+        return this.handlers.get(eventName)?.size || 0;
+    }
+    /**
+     * Execute a handler (function or class)
+     */
+    async executeHandler(handler, event) {
+        try {
+            if (typeof handler === "function") {
+                await handler(event);
+            }
+            else {
+                await handler.handle(event);
+            }
+        }
+        catch (error) {
+            console.error(`Error handling event ${event.eventName}:`, error);
+            // Don't throw - we don't want one handler failure to break others
+        }
+    }
+}
+/**
+ * Convenience function to get the event bus instance
+ */
+export function getEventBus() {
+    return DomainEventBus.getInstance();
+}
+//# sourceMappingURL=domain-event-bus.js.map

package/dist/domain-event-bus.js.map

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

package/dist/domain-event.d.ts

@@ -0,0 +1,55 @@
+import { Id } from "./id";
+/**
+ * Interface for all domain events
+ */
+export interface IDomainEvent {
+    /**
+     * Unique identifier for this event occurrence
+     */
+    readonly eventId: string;
+    /**
+     * When the event occurred
+     */
+    readonly occurredOn: Date;
+    /**
+     * Name/type of the event (e.g., "UserCreated", "OrderPlaced")
+     */
+    readonly eventName: string;
+    /**
+     * ID of the aggregate that raised this event
+     */
+    readonly aggregateId: string;
+}
+/**
+ * Base class for domain events
+ */
+export declare abstract class DomainEvent implements IDomainEvent {
+    readonly eventId: string;
+    readonly occurredOn: Date;
+    readonly aggregateId: string;
+    constructor(aggregateId: Id | string);
+    /**
+     * Get the event name (defaults to class name)
+     */
+    get eventName(): string;
+    private generateEventId;
+    /**
+     * Convert event to JSON
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Override this to provide event-specific data
+     */
+    protected getPayload(): Record<string, any>;
+}
+/**
+ * Event handler function type
+ */
+export type DomainEventHandler<T extends IDomainEvent = IDomainEvent> = (event: T) => void | Promise<void>;
+/**
+ * Event handler class type
+ */
+export interface IDomainEventHandler<T extends IDomainEvent = IDomainEvent> {
+    handle(event: T): void | Promise<void>;
+}
+//# sourceMappingURL=domain-event.d.ts.map

package/dist/domain-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event.d.ts","sourceRoot":"","sources":["../src/domain-event.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,8BAAsB,WAAY,YAAW,YAAY;IACvD,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,UAAU,EAAE,IAAI,CAAC;IACjC,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,WAAW,EAAE,EAAE,GAAG,MAAM;IAMpC;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAU7B;;OAEG;IACH,SAAS,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAG5C;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,CACtE,KAAK,EAAE,CAAC,KACL,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACxE,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/domain-event.js

@@ -0,0 +1,42 @@
+// ============================================================================
+// Domain Events - Event-Driven Architecture Support
+// ============================================================================
+import { Id } from "./id";
+/**
+ * Base class for domain events
+ */
+export class DomainEvent {
+    constructor(aggregateId) {
+        this.eventId = this.generateEventId();
+        this.occurredOn = new Date();
+        this.aggregateId = aggregateId instanceof Id ? aggregateId.value : aggregateId;
+    }
+    /**
+     * Get the event name (defaults to class name)
+     */
+    get eventName() {
+        return this.constructor.name;
+    }
+    generateEventId() {
+        return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Convert event to JSON
+     */
+    toJSON() {
+        return {
+            eventId: this.eventId,
+            eventName: this.eventName,
+            occurredOn: this.occurredOn.toISOString(),
+            aggregateId: this.aggregateId,
+            ...this.getPayload(),
+        };
+    }
+    /**
+     * Override this to provide event-specific data
+     */
+    getPayload() {
+        return {};
+    }
+}
+//# sourceMappingURL=domain-event.js.map

package/dist/domain-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event.js","sourceRoot":"","sources":["../src/domain-event.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,oDAAoD;AACpD,+EAA+E;AAE/E,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AA2B1B;;GAEG;AACH,MAAM,OAAgB,WAAW;IAK/B,YAAY,WAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,YAAY,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAEO,eAAe;QACrB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;YACzC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,IAAI,CAAC,UAAU,EAAE;SACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,UAAU;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/entity.d.ts

@@ -0,0 +1,13 @@
+import { BaseEntity } from './base-entity';
+import { BaseProps } from './types';
+/**
+ * Entity - Has identity and lifecycle, but is not an aggregate root
+ */
+export declare class Entity<T extends BaseProps> extends BaseEntity<T> {
+}
+/**
+ * Aggregate - Aggregate root that manages a consistency boundary
+ */
+export declare class Aggregate<T extends BaseProps> extends BaseEntity<T> {
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;GAEG;AACH,qBAAa,MAAM,CAAC,CAAC,SAAS,SAAS,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;CAAG;AAEjE;;GAEG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,SAAS,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;CAAG"}

package/dist/entity.js

@@ -0,0 +1,15 @@
+// ============================================================================
+// Entity & Aggregate Classes
+// ============================================================================
+import { BaseEntity } from './base-entity';
+/**
+ * Entity - Has identity and lifecycle, but is not an aggregate root
+ */
+export class Entity extends BaseEntity {
+}
+/**
+ * Aggregate - Aggregate root that manages a consistency boundary
+ */
+export class Aggregate extends BaseEntity {
+}
+//# sourceMappingURL=entity.js.map

package/dist/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;GAEG;AACH,MAAM,OAAO,MAA4B,SAAQ,UAAa;CAAG;AAEjE;;GAEG;AACH,MAAM,OAAO,SAA+B,SAAQ,UAAa;CAAG"}

package/dist/filtering.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Supported filter operators
+ */
+export type FilterOperator = "equals" | "notEquals" | "greaterThan" | "greaterThanOrEquals" | "lessThan" | "lessThanOrEquals" | "in" | "notIn" | "contains" | "startsWith" | "endsWith" | "isNull" | "isNotNull";
+/**
+ * Configuration for a single filter
+ */
+export interface FilterConfig<T> {
+    field: keyof T | string;
+    operator: FilterOperator;
+    value?: any;
+}
+/**
+ * Represents a single filter condition
+ * Can be used for in-memory filtering or converted to database-specific queries
+ *
+ * @example
+ * ```typescript
+ * const filter = new Filter('age', 'greaterThan', 18);
+ * const adults = users.filter(filter.predicateFn());
+ * ```
+ */
+export declare class Filter<T> {
+    private readonly _field;
+    private readonly _operator;
+    private readonly _value?;
+    constructor(field: keyof T | string, operator: FilterOperator, value?: any);
+    /**
+     * Gets the field to filter
+     */
+    get field(): keyof T | string;
+    /**
+     * Gets the filter operator
+     */
+    get operator(): FilterOperator;
+    /**
+     * Gets the filter value
+     */
+    get value(): any;
+    /**
+     * Returns configuration object for serialization
+     */
+    toConfig(): FilterConfig<T>;
+    /**
+     * Checks if the operator requires a value
+     * @private
+     */
+    private requiresValue;
+    /**
+     * Creates a predicate function for in-memory filtering
+     * Handles nested properties using dot notation (e.g., "address.city")
+     *
+     * @example
+     * ```typescript
+     * const filter = new Filter<User>('age', 'greaterThan', 18);
+     * const adults = users.filter(filter.predicateFn());
+     * ```
+     */
+    predicateFn(): (item: T) => boolean;
+    /**
+     * Gets nested property value using dot notation
+     * @private
+     */
+    private getNestedValue;
+}
+/**
+ * Logical operator for combining filters
+ */
+export type LogicalOperator = "and" | "or";
+/**
+ * Represents a composite filter that combines multiple filters with AND/OR logic
+ *
+ * @example
+ * ```typescript
+ * const composite = new CompositeFilter<User>('and', [
+ *   new Filter('age', 'greaterThan', 18),
+ *   new Filter('status', 'equals', 'active')
+ * ]);
+ * const filtered = users.filter(composite.predicateFn());
+ * ```
+ */
+export declare class CompositeFilter<T> {
+    private readonly _operator;
+    private readonly _filters;
+    constructor(operator: LogicalOperator, filters: (Filter<T> | CompositeFilter<T>)[]);
+    /**
+     * Gets the logical operator
+     */
+    get operator(): LogicalOperator;
+    /**
+     * Gets all filters
+     */
+    get filters(): readonly (Filter<T> | CompositeFilter<T>)[];
+    /**
+     * Creates a predicate function that applies the logical operator
+     */
+    predicateFn(): (item: T) => boolean;
+    /**
+     * Adds another filter with AND logic
+     */
+    and(filter: Filter<T> | CompositeFilter<T>): CompositeFilter<T>;
+    /**
+     * Adds another filter with OR logic
+     */
+    or(filter: Filter<T> | CompositeFilter<T>): CompositeFilter<T>;
+}
+//# sourceMappingURL=filtering.d.ts.map

package/dist/filtering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["../src/filtering.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,aAAa,GACb,qBAAqB,GACrB,UAAU,GACV,kBAAkB,GAClB,IAAI,GACJ,OAAO,GACP,UAAU,GACV,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAMD;;;;;;;;;GASG;AACH,qBAAa,MAAM,CAAC,CAAC;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAM;gBAElB,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,GAAG;IAW1E;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAAC,GAAG,MAAM,CAE5B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,GAAG,CAEf;IAED;;OAEG;IACH,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC;IAQ3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;;;;;OASG;IACH,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO;IA+DnC;;;OAGG;IACH,OAAO,CAAC,cAAc;CAGvB;AAMD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,IAAI,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe,CAAC,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAElD,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE;IAQlF;;OAEG;IACH,IAAI,QAAQ,IAAI,eAAe,CAE9B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAEzD;IAED;;OAEG;IACH,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO;IAWnC;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAU/D;;OAEG;IACH,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;CAS/D"}

package/dist/filtering.js

@@ -0,0 +1,202 @@
+"use strict";
+// ============================================================================
+// Filtering System
+// ============================================================================
+// Provides filtering/where clause capabilities for queries and in-memory collections
+// Supports common comparison operators and can be extended for custom operators
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositeFilter = exports.Filter = void 0;
+// ============================================================================
+// Filter Class
+// ============================================================================
+/**
+ * Represents a single filter condition
+ * Can be used for in-memory filtering or converted to database-specific queries
+ *
+ * @example
+ * ```typescript
+ * const filter = new Filter('age', 'greaterThan', 18);
+ * const adults = users.filter(filter.predicateFn());
+ * ```
+ */
+class Filter {
+    constructor(field, operator, value) {
+        this._field = field;
+        this._operator = operator;
+        this._value = value;
+        // Validate that value is provided when required
+        if (this.requiresValue() && value === undefined) {
+            throw new Error(`Filter operator '${operator}' requires a value`);
+        }
+    }
+    /**
+     * Gets the field to filter
+     */
+    get field() {
+        return this._field;
+    }
+    /**
+     * Gets the filter operator
+     */
+    get operator() {
+        return this._operator;
+    }
+    /**
+     * Gets the filter value
+     */
+    get value() {
+        return this._value;
+    }
+    /**
+     * Returns configuration object for serialization
+     */
+    toConfig() {
+        return {
+            field: this._field,
+            operator: this._operator,
+            value: this._value,
+        };
+    }
+    /**
+     * Checks if the operator requires a value
+     * @private
+     */
+    requiresValue() {
+        return this._operator !== "isNull" && this._operator !== "isNotNull";
+    }
+    /**
+     * Creates a predicate function for in-memory filtering
+     * Handles nested properties using dot notation (e.g., "address.city")
+     *
+     * @example
+     * ```typescript
+     * const filter = new Filter<User>('age', 'greaterThan', 18);
+     * const adults = users.filter(filter.predicateFn());
+     * ```
+     */
+    predicateFn() {
+        return (item) => {
+            const fieldValue = this.getNestedValue(item, this._field);
+            switch (this._operator) {
+                case "equals":
+                    return fieldValue === this._value;
+                case "notEquals":
+                    return fieldValue !== this._value;
+                case "greaterThan":
+                    return fieldValue > this._value;
+                case "greaterThanOrEquals":
+                    return fieldValue >= this._value;
+                case "lessThan":
+                    return fieldValue < this._value;
+                case "lessThanOrEquals":
+                    return fieldValue <= this._value;
+                case "in":
+                    return Array.isArray(this._value) && this._value.includes(fieldValue);
+                case "notIn":
+                    return Array.isArray(this._value) && !this._value.includes(fieldValue);
+                case "contains":
+                    return (typeof fieldValue === "string" &&
+                        typeof this._value === "string" &&
+                        fieldValue.includes(this._value));
+                case "startsWith":
+                    return (typeof fieldValue === "string" &&
+                        typeof this._value === "string" &&
+                        fieldValue.startsWith(this._value));
+                case "endsWith":
+                    return (typeof fieldValue === "string" &&
+                        typeof this._value === "string" &&
+                        fieldValue.endsWith(this._value));
+                case "isNull":
+                    return fieldValue === null || fieldValue === undefined;
+                case "isNotNull":
+                    return fieldValue !== null && fieldValue !== undefined;
+                default:
+                    // This should never happen with proper typing
+                    throw new Error(`Unknown filter operator: ${this._operator}`);
+            }
+        };
+    }
+    /**
+     * Gets nested property value using dot notation
+     * @private
+     */
+    getNestedValue(obj, path) {
+        return path.split(".").reduce((current, prop) => current?.[prop], obj);
+    }
+}
+exports.Filter = Filter;
+/**
+ * Represents a composite filter that combines multiple filters with AND/OR logic
+ *
+ * @example
+ * ```typescript
+ * const composite = new CompositeFilter<User>('and', [
+ *   new Filter('age', 'greaterThan', 18),
+ *   new Filter('status', 'equals', 'active')
+ * ]);
+ * const filtered = users.filter(composite.predicateFn());
+ * ```
+ */
+class CompositeFilter {
+    constructor(operator, filters) {
+        if (filters.length === 0) {
+            throw new Error("At least one filter is required");
+        }
+        this._operator = operator;
+        this._filters = filters;
+    }
+    /**
+     * Gets the logical operator
+     */
+    get operator() {
+        return this._operator;
+    }
+    /**
+     * Gets all filters
+     */
+    get filters() {
+        return this._filters;
+    }
+    /**
+     * Creates a predicate function that applies the logical operator
+     */
+    predicateFn() {
+        return (item) => {
+            if (this._operator === "and") {
+                return this._filters.every((filter) => filter.predicateFn()(item));
+            }
+            else {
+                // OR
+                return this._filters.some((filter) => filter.predicateFn()(item));
+            }
+        };
+    }
+    /**
+     * Adds another filter with AND logic
+     */
+    and(filter) {
+        if (this._operator === "and") {
+            // Flatten if already AND
+            return new CompositeFilter("and", [...this._filters, filter]);
+        }
+        else {
+            // Wrap in new AND
+            return new CompositeFilter("and", [this, filter]);
+        }
+    }
+    /**
+     * Adds another filter with OR logic
+     */
+    or(filter) {
+        if (this._operator === "or") {
+            // Flatten if already OR
+            return new CompositeFilter("or", [...this._filters, filter]);
+        }
+        else {
+            // Wrap in new OR
+            return new CompositeFilter("or", [this, filter]);
+        }
+    }
+}
+exports.CompositeFilter = CompositeFilter;
+//# sourceMappingURL=filtering.js.map

package/dist/filtering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.js","sourceRoot":"","sources":["../src/filtering.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAC/E,qFAAqF;AACrF,gFAAgF;;;AA6BhF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAa,MAAM;IAKjB,YAAY,KAAuB,EAAE,QAAwB,EAAE,KAAW;QACxE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAEpB,gDAAgD;QAChD,IAAI,IAAI,CAAC,aAAa,EAAE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,oBAAoB,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAK,WAAW,CAAC;IACvE,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW;QACT,OAAO,CAAC,IAAO,EAAW,EAAE;YAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,MAAgB,CAAC,CAAC;YAEpE,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;gBACvB,KAAK,QAAQ;oBACX,OAAO,UAAU,KAAK,IAAI,CAAC,MAAM,CAAC;gBAEpC,KAAK,WAAW;oBACd,OAAO,UAAU,KAAK,IAAI,CAAC,MAAM,CAAC;gBAEpC,KAAK,aAAa;oBAChB,OAAO,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;gBAElC,KAAK,qBAAqB;oBACxB,OAAO,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC;gBAEnC,KAAK,UAAU;oBACb,OAAO,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;gBAElC,KAAK,kBAAkB;oBACrB,OAAO,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC;gBAEnC,KAAK,IAAI;oBACP,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAExE,KAAK,OAAO;oBACV,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAEzE,KAAK,UAAU;oBACb,OAAO,CACL,OAAO,UAAU,KAAK,QAAQ;wBAC9B,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;wBAC/B,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CACjC,CAAC;gBAEJ,KAAK,YAAY;oBACf,OAAO,CACL,OAAO,UAAU,KAAK,QAAQ;wBAC9B,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;wBAC/B,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CACnC,CAAC;gBAEJ,KAAK,UAAU;oBACb,OAAO,CACL,OAAO,UAAU,KAAK,QAAQ;wBAC9B,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;wBAC/B,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CACjC,CAAC;gBAEJ,KAAK,QAAQ;oBACX,OAAO,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,CAAC;gBAEzD,KAAK,WAAW;oBACd,OAAO,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,CAAC;gBAEzD;oBACE,8CAA8C;oBAC9C,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,GAAQ,EAAE,IAAY;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACzE,CAAC;CACF;AAxID,wBAwIC;AAWD;;;;;;;;;;;GAWG;AACH,MAAa,eAAe;IAI1B,YAAY,QAAyB,EAAE,OAA2C;QAChF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CAAC,IAAO,EAAW,EAAE;YAC1B,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACrE,CAAC;iBAAM,CAAC;gBACN,KAAK;gBACL,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACpE,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAsC;QACxC,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YAC7B,yBAAyB;YACzB,OAAO,IAAI,eAAe,CAAI,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,OAAO,IAAI,eAAe,CAAI,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,MAAsC;QACvC,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5B,wBAAwB;YACxB,OAAO,IAAI,eAAe,CAAI,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,iBAAiB;YACjB,OAAO,IAAI,eAAe,CAAI,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF;AAjED,0CAiEC"}

package/dist/id.d.ts

@@ -0,0 +1,51 @@
+export declare class Id {
+    private readonly _value;
+    private readonly _isNew;
+    /**
+     * Create a new Id
+     * @param value - Optional existing ID value. If not provided, generates a new UUID.
+     *
+     * @example
+     * // New entity (generates UUID)
+     * const newId = new Id();
+     * newId.isNew // true
+     *
+     * // Existing entity (uses provided ID)
+     * const existingId = new Id("550e8400-e29b-41d4-a716-446655440000");
+     * existingId.isNew // false
+     */
+    constructor(value?: string);
+    /**
+     * Get the string value of the ID
+     */
+    get value(): string;
+    /**
+     * Check if this ID represents a new entity
+     */
+    get isNew(): boolean;
+    /**
+     * Convert to string (for JSON serialization and comparisons)
+     */
+    toString(): string;
+    /**
+     * Convert to JSON (returns the string value)
+     */
+    toJSON(): string;
+    /**
+     * Check equality with another Id or string
+     */
+    equals(other: Id | string): boolean;
+    /**
+     * Generate a UUID v4
+     */
+    private generateUUID;
+    /**
+     * Create a new Id (convenience static method)
+     */
+    static create(): Id;
+    /**
+     * Create an Id from an existing value
+     */
+    static from(value: string): Id;
+}
+//# sourceMappingURL=id.d.ts.map

package/dist/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAKA,qBAAa,EAAE;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC;;;;;;;;;;;;OAYG;gBACS,KAAK,CAAC,EAAE,MAAM;IAY1B;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,OAAO;IAOnC;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,EAAE;IAInB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE;CAG/B"}