create-phoenixjs 0.1.4 → 0.1.5

package/template/framework/database/pagination/Paginator.ts

@@ -0,0 +1,110 @@
+/**
+ * PhoenixJS ORM - Paginator
+ *
+ * Base class for pagination.
+ */
+
+export class Paginator<T> {
+	/**
+	 * The items for the current page.
+	 */
+	public items: T[];
+
+	/**
+	 * The number of items per page.
+	 */
+	public perPage: number;
+
+	/**
+	 * The current page number.
+	 */
+	public currentPage: number;
+
+	/**
+	 * Determine if there are more items in the data source.
+	 */
+	public hasMore: boolean;
+
+	/**
+	 * The base path for paginator links.
+	 */
+	public path: string = '/';
+
+	/**
+	 * The query string parameters for paginator links.
+	 */
+	public query: Record<string, string> = {};
+
+	/**
+	 * Create a new Paginator instance.
+	 */
+	constructor(
+		items: T[],
+		perPage: number,
+		currentPage: number,
+		options: { path?: string; query?: Record<string, string>; hasMore?: boolean } = {}
+	) {
+		this.items = items;
+		this.perPage = perPage;
+		this.currentPage = currentPage;
+		this.path = options.path || this.path;
+		this.query = options.query || this.query;
+		this.hasMore = options.hasMore ?? items.length > 0;
+	}
+
+	/**
+	 * Get the URL for the next page.
+	 */
+	public nextPageUrl(): string | null {
+		if (this.hasMore) {
+			return this.url(this.currentPage + 1);
+		}
+		return null;
+	}
+
+	/**
+	 * Get the URL for the previous page.
+	 */
+	public previousPageUrl(): string | null {
+		if (this.currentPage > 1) {
+			return this.url(this.currentPage - 1);
+		}
+		return null;
+	}
+
+	/**
+	 * Get the URL for a given page number.
+	 */
+	public url(page: number): string {
+		if (page <= 0) page = 1;
+
+		const queryParams = new URLSearchParams(this.query);
+		queryParams.set('page', page.toString());
+
+		return `${this.path}?${queryParams.toString()}`;
+	}
+
+	/**
+	 * Get the instance as an array (returns items).
+	 */
+	public toArray(): T[] {
+		return this.items;
+	}
+
+	/**
+	 * Convert the instance to JSON.
+	 */
+	public toJSON(): Record<string, unknown> {
+		return {
+			data: this.items,
+			current_page: this.currentPage,
+			per_page: this.perPage,
+			first_page_url: this.url(1),
+			next_page_url: this.nextPageUrl(),
+			prev_page_url: this.previousPageUrl(),
+			path: this.path,
+			from: (this.currentPage - 1) * this.perPage + 1,
+			to: (this.currentPage - 1) * this.perPage + this.items.length,
+		};
+	}
+}

package/template/framework/database/pagination/index.ts

@@ -0,0 +1,2 @@
+export * from './Paginator';
+export * from './LengthAwarePaginator';