@woltz/rich-domain 0.2.2 → 1.1.0

package/dist/ordering.js

@@ -1,154 +0,0 @@
-"use strict";
-// ============================================================================
-// Ordering System
-// ============================================================================
-// Provides ordering/sorting capabilities for queries and in-memory collections
-// Compatible with Entity, Aggregate, and ValueObject types
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MultiOrderBy = exports.OrderBy = void 0;
-// ============================================================================
-// OrderBy Class
-// ============================================================================
-/**
- * Represents ordering configuration for a specific field
- * Can be used for in-memory sorting or converted to database-specific queries
- *
- * @example
- * ```typescript
- * const orderBy = new OrderBy('name', 'asc');
- * const items = users.sort(orderBy.compareFn());
- * ```
- */
-class OrderBy {
-    constructor(field, direction = "asc") {
-        this._field = field;
-        this._direction = direction;
-    }
-    /**
-     * Gets the field to order by
-     */
-    get field() {
-        return this._field;
-    }
-    /**
-     * Gets the order direction
-     */
-    get direction() {
-        return this._direction;
-    }
-    /**
-     * Returns configuration object for serialization
-     */
-    toConfig() {
-        return {
-            field: this._field,
-            direction: this._direction,
-        };
-    }
-    /**
-     * Creates a comparison function for in-memory sorting
-     * Handles nested properties using dot notation (e.g., "address.city")
-     *
-     * @example
-     * ```typescript
-     * const orderBy = new OrderBy<User>('name', 'asc');
-     * const sorted = users.sort(orderBy.compareFn());
-     * ```
-     */
-    compareFn() {
-        return (a, b) => {
-            const aValue = this.getNestedValue(a, this._field);
-            const bValue = this.getNestedValue(b, this._field);
-            // Handle null/undefined values
-            if (aValue === null || aValue === undefined)
-                return 1;
-            if (bValue === null || bValue === undefined)
-                return -1;
-            // Compare values
-            let comparison = 0;
-            if (aValue > bValue) {
-                comparison = 1;
-            }
-            else if (aValue < bValue) {
-                comparison = -1;
-            }
-            // Apply direction
-            return this._direction === "asc" ? comparison : -comparison;
-        };
-    }
-    /**
-     * Gets nested property value using dot notation
-     * @private
-     */
-    getNestedValue(obj, path) {
-        return path.split(".").reduce((current, prop) => current?.[prop], obj);
-    }
-    /**
-     * Creates a new OrderBy with reversed direction
-     */
-    reverse() {
-        const newDirection = this._direction === "asc" ? "desc" : "asc";
-        return new OrderBy(this._field, newDirection);
-    }
-}
-exports.OrderBy = OrderBy;
-// ============================================================================
-// MultiOrderBy Class
-// ============================================================================
-/**
- * Represents multiple ordering configurations
- * Allows sorting by multiple fields with different directions
- *
- * @example
- * ```typescript
- * const multiOrder = new MultiOrderBy<User>([
- *   new OrderBy('status', 'asc'),
- *   new OrderBy('name', 'asc')
- * ]);
- * const sorted = users.sort(multiOrder.compareFn());
- * ```
- */
-class MultiOrderBy {
-    constructor(orderings) {
-        if (orderings.length === 0) {
-            throw new Error("At least one OrderBy is required");
-        }
-        this._orderings = orderings;
-    }
-    /**
-     * Gets all ordering configurations
-     */
-    get orderings() {
-        return this._orderings;
-    }
-    /**
-     * Returns array of configuration objects for serialization
-     */
-    toConfig() {
-        return this._orderings.map((o) => o.toConfig());
-    }
-    /**
-     * Creates a comparison function that applies all orderings in sequence
-     * If first ordering produces a tie, moves to next ordering, and so on
-     */
-    compareFn() {
-        return (a, b) => {
-            for (const ordering of this._orderings) {
-                const comparison = ordering.compareFn()(a, b);
-                if (comparison !== 0) {
-                    return comparison;
-                }
-            }
-            return 0;
-        };
-    }
-    /**
-     * Adds another ordering to the end of the list
-     */
-    thenBy(field, direction = "asc") {
-        const newOrderBy = new OrderBy(field, direction);
-        return new MultiOrderBy([...this._orderings, newOrderBy]);
-    }
-}
-exports.MultiOrderBy = MultiOrderBy;
-//# sourceMappingURL=ordering.js.map

package/dist/ordering.js.map

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

package/dist/pagination.d.ts

@@ -1,218 +0,0 @@
-/**
- * Type of pagination strategy
- */
-export type PaginationType = "offset" | "cursor";
-/**
- * Configuration for offset-based pagination
- */
-export interface OffsetPaginationConfig {
-    type: "offset";
-    page: number;
-    pageSize: number;
-}
-/**
- * Configuration for cursor-based pagination
- */
-export interface CursorPaginationConfig {
-    type: "cursor";
-    cursor?: string;
-    pageSize: number;
-    direction?: "forward" | "backward";
-}
-/**
- * Union type for all pagination configurations
- */
-export type PaginationConfig = OffsetPaginationConfig | CursorPaginationConfig;
-/**
- * Represents offset-based pagination (traditional page-based pagination)
- * Uses page number and page size to calculate offset
- *
- * @example
- * ```typescript
- * const pagination = new OffsetPagination(1, 20); // page 1, 20 items per page
- * const { skip, take } = pagination.getSkipTake();
- * ```
- */
-export declare class OffsetPagination {
-    private readonly _page;
-    private readonly _pageSize;
-    constructor(page: number, pageSize: number);
-    /**
-     * Gets the current page number (1-indexed)
-     */
-    get page(): number;
-    /**
-     * Gets the page size
-     */
-    get pageSize(): number;
-    /**
-     * Gets the type of pagination
-     */
-    get type(): PaginationType;
-    /**
-     * Calculates skip and take values for database queries
-     */
-    getSkipTake(): {
-        skip: number;
-        take: number;
-    };
-    /**
-     * Returns configuration object for serialization
-     */
-    toConfig(): OffsetPaginationConfig;
-    /**
-     * Applies pagination to an in-memory array
-     */
-    apply<T>(items: T[]): T[];
-    /**
-     * Creates a new OffsetPagination for the next page
-     */
-    nextPage(): OffsetPagination;
-    /**
-     * Creates a new OffsetPagination for the previous page
-     */
-    previousPage(): OffsetPagination;
-}
-/**
- * Represents cursor-based pagination
- * Uses a cursor (typically an encoded string) to determine the starting point
- * More efficient for large datasets and real-time data
- *
- * @example
- * ```typescript
- * const pagination = new CursorPagination('cursor_abc123', 20);
- * ```
- */
-export declare class CursorPagination {
-    private readonly _cursor?;
-    private readonly _pageSize;
-    private readonly _direction;
-    constructor(cursor: string | undefined, pageSize: number, direction?: "forward" | "backward");
-    /**
-     * Gets the cursor (undefined for first page)
-     */
-    get cursor(): string | undefined;
-    /**
-     * Gets the page size
-     */
-    get pageSize(): number;
-    /**
-     * Gets the pagination direction
-     */
-    get direction(): "forward" | "backward";
-    /**
-     * Gets the type of pagination
-     */
-    get type(): PaginationType;
-    /**
-     * Checks if this is the first page (no cursor)
-     */
-    isFirstPage(): boolean;
-    /**
-     * Returns configuration object for serialization
-     */
-    toConfig(): CursorPaginationConfig;
-    /**
-     * Creates a new CursorPagination with a different cursor
-     */
-    withCursor(cursor: string | undefined): CursorPagination;
-    /**
-     * Creates a new CursorPagination for backward navigation
-     */
-    backward(): CursorPagination;
-    /**
-     * Creates a new CursorPagination for forward navigation
-     */
-    forward(): CursorPagination;
-}
-/**
- * Metadata for offset-based pagination results
- */
-export interface OffsetPaginationMeta {
-    type: "offset";
-    page: number;
-    pageSize: number;
-    total: number;
-    totalPages: number;
-    hasNextPage: boolean;
-    hasPreviousPage: boolean;
-}
-/**
- * Metadata for cursor-based pagination results
- */
-export interface CursorPaginationMeta {
-    type: "cursor";
-    pageSize: number;
-    hasNextPage: boolean;
-    hasPreviousPage: boolean;
-    nextCursor?: string;
-    previousCursor?: string;
-}
-/**
- * Union type for pagination metadata
- */
-export type PaginationMeta = OffsetPaginationMeta | CursorPaginationMeta;
-/**
- * Represents a paginated result set
- * Contains the data items and metadata about the pagination
- *
- * @example
- * ```typescript
- * const result = new PaginatedResult(users, {
- *   type: 'offset',
- *   page: 1,
- *   pageSize: 20,
- *   total: 100,
- *   totalPages: 5,
- *   hasNextPage: true,
- *   hasPreviousPage: false
- * });
- * ```
- */
-export declare class PaginatedResult<T> {
-    private readonly _data;
-    private readonly _meta;
-    constructor(data: T[], meta: PaginationMeta);
-    /**
-     * Gets the data items
-     */
-    get data(): readonly T[];
-    /**
-     * Gets the pagination metadata
-     */
-    get meta(): PaginationMeta;
-    /**
-     * Gets the count of items in current page
-     */
-    get count(): number;
-    /**
-     * Checks if there is a next page
-     */
-    hasNextPage(): boolean;
-    /**
-     * Checks if there is a previous page
-     */
-    hasPreviousPage(): boolean;
-    /**
-     * Maps the data items to a new type
-     */
-    map<U>(fn: (item: T) => U): PaginatedResult<U>;
-    /**
-     * Converts to plain object for serialization
-     */
-    toJson(): {
-        data: T[];
-        meta: PaginationMeta;
-    };
-    /**
-     * Creates an offset-based paginated result from an array and pagination config
-     * Automatically calculates metadata
-     */
-    static fromArray<T>(allItems: T[], pagination: OffsetPagination): PaginatedResult<T>;
-    /**
-     * Creates a cursor-based paginated result
-     * Requires cursors to be calculated externally
-     */
-    static fromCursor<T>(data: T[], pagination: CursorPagination, nextCursor?: string, previousCursor?: string): PaginatedResult<T>;
-}
-//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

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

package/dist/pagination.js

@@ -1,281 +0,0 @@
-"use strict";
-// ============================================================================
-// Pagination System
-// ============================================================================
-// Provides offset-based and cursor-based pagination capabilities
-// Can be used for in-memory pagination or converted to database-specific queries
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaginatedResult = exports.CursorPagination = exports.OffsetPagination = void 0;
-// ============================================================================
-// OffsetPagination Class
-// ============================================================================
-/**
- * Represents offset-based pagination (traditional page-based pagination)
- * Uses page number and page size to calculate offset
- *
- * @example
- * ```typescript
- * const pagination = new OffsetPagination(1, 20); // page 1, 20 items per page
- * const { skip, take } = pagination.getSkipTake();
- * ```
- */
-class OffsetPagination {
-    constructor(page, pageSize) {
-        if (page < 1) {
-            throw new Error("Page must be greater than or equal to 1");
-        }
-        if (pageSize < 1) {
-            throw new Error("Page size must be greater than or equal to 1");
-        }
-        this._page = page;
-        this._pageSize = pageSize;
-    }
-    /**
-     * Gets the current page number (1-indexed)
-     */
-    get page() {
-        return this._page;
-    }
-    /**
-     * Gets the page size
-     */
-    get pageSize() {
-        return this._pageSize;
-    }
-    /**
-     * Gets the type of pagination
-     */
-    get type() {
-        return "offset";
-    }
-    /**
-     * Calculates skip and take values for database queries
-     */
-    getSkipTake() {
-        return {
-            skip: (this._page - 1) * this._pageSize,
-            take: this._pageSize,
-        };
-    }
-    /**
-     * Returns configuration object for serialization
-     */
-    toConfig() {
-        return {
-            type: "offset",
-            page: this._page,
-            pageSize: this._pageSize,
-        };
-    }
-    /**
-     * Applies pagination to an in-memory array
-     */
-    apply(items) {
-        const { skip, take } = this.getSkipTake();
-        return items.slice(skip, skip + take);
-    }
-    /**
-     * Creates a new OffsetPagination for the next page
-     */
-    nextPage() {
-        return new OffsetPagination(this._page + 1, this._pageSize);
-    }
-    /**
-     * Creates a new OffsetPagination for the previous page
-     */
-    previousPage() {
-        if (this._page <= 1) {
-            throw new Error("Already on first page");
-        }
-        return new OffsetPagination(this._page - 1, this._pageSize);
-    }
-}
-exports.OffsetPagination = OffsetPagination;
-// ============================================================================
-// CursorPagination Class
-// ============================================================================
-/**
- * Represents cursor-based pagination
- * Uses a cursor (typically an encoded string) to determine the starting point
- * More efficient for large datasets and real-time data
- *
- * @example
- * ```typescript
- * const pagination = new CursorPagination('cursor_abc123', 20);
- * ```
- */
-class CursorPagination {
-    constructor(cursor, pageSize, direction = "forward") {
-        if (pageSize < 1) {
-            throw new Error("Page size must be greater than or equal to 1");
-        }
-        this._cursor = cursor;
-        this._pageSize = pageSize;
-        this._direction = direction;
-    }
-    /**
-     * Gets the cursor (undefined for first page)
-     */
-    get cursor() {
-        return this._cursor;
-    }
-    /**
-     * Gets the page size
-     */
-    get pageSize() {
-        return this._pageSize;
-    }
-    /**
-     * Gets the pagination direction
-     */
-    get direction() {
-        return this._direction;
-    }
-    /**
-     * Gets the type of pagination
-     */
-    get type() {
-        return "cursor";
-    }
-    /**
-     * Checks if this is the first page (no cursor)
-     */
-    isFirstPage() {
-        return this._cursor === undefined;
-    }
-    /**
-     * Returns configuration object for serialization
-     */
-    toConfig() {
-        return {
-            type: "cursor",
-            cursor: this._cursor,
-            pageSize: this._pageSize,
-            direction: this._direction,
-        };
-    }
-    /**
-     * Creates a new CursorPagination with a different cursor
-     */
-    withCursor(cursor) {
-        return new CursorPagination(cursor, this._pageSize, this._direction);
-    }
-    /**
-     * Creates a new CursorPagination for backward navigation
-     */
-    backward() {
-        return new CursorPagination(this._cursor, this._pageSize, "backward");
-    }
-    /**
-     * Creates a new CursorPagination for forward navigation
-     */
-    forward() {
-        return new CursorPagination(this._cursor, this._pageSize, "forward");
-    }
-}
-exports.CursorPagination = CursorPagination;
-/**
- * Represents a paginated result set
- * Contains the data items and metadata about the pagination
- *
- * @example
- * ```typescript
- * const result = new PaginatedResult(users, {
- *   type: 'offset',
- *   page: 1,
- *   pageSize: 20,
- *   total: 100,
- *   totalPages: 5,
- *   hasNextPage: true,
- *   hasPreviousPage: false
- * });
- * ```
- */
-class PaginatedResult {
-    constructor(data, meta) {
-        this._data = data;
-        this._meta = meta;
-    }
-    /**
-     * Gets the data items
-     */
-    get data() {
-        return this._data;
-    }
-    /**
-     * Gets the pagination metadata
-     */
-    get meta() {
-        return this._meta;
-    }
-    /**
-     * Gets the count of items in current page
-     */
-    get count() {
-        return this._data.length;
-    }
-    /**
-     * Checks if there is a next page
-     */
-    hasNextPage() {
-        return this._meta.hasNextPage;
-    }
-    /**
-     * Checks if there is a previous page
-     */
-    hasPreviousPage() {
-        return this._meta.hasPreviousPage;
-    }
-    /**
-     * Maps the data items to a new type
-     */
-    map(fn) {
-        return new PaginatedResult(this._data.map(fn), this._meta);
-    }
-    /**
-     * Converts to plain object for serialization
-     */
-    toJson() {
-        return {
-            data: this._data,
-            meta: this._meta,
-        };
-    }
-    /**
-     * Creates an offset-based paginated result from an array and pagination config
-     * Automatically calculates metadata
-     */
-    static fromArray(allItems, pagination) {
-        const { skip, take } = pagination.getSkipTake();
-        const data = allItems.slice(skip, skip + take);
-        const total = allItems.length;
-        const totalPages = Math.ceil(total / pagination.pageSize);
-        const meta = {
-            type: "offset",
-            page: pagination.page,
-            pageSize: pagination.pageSize,
-            total,
-            totalPages,
-            hasNextPage: pagination.page < totalPages,
-            hasPreviousPage: pagination.page > 1,
-        };
-        return new PaginatedResult(data, meta);
-    }
-    /**
-     * Creates a cursor-based paginated result
-     * Requires cursors to be calculated externally
-     */
-    static fromCursor(data, pagination, nextCursor, previousCursor) {
-        const meta = {
-            type: "cursor",
-            pageSize: pagination.pageSize,
-            hasNextPage: nextCursor !== undefined,
-            hasPreviousPage: previousCursor !== undefined,
-            nextCursor,
-            previousCursor,
-        };
-        return new PaginatedResult(data, meta);
-    }
-}
-exports.PaginatedResult = PaginatedResult;
-//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

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