nextpress-core 1.0.0 → 1.0.2

package/lib/repository/postquery/post-query-args.d.ts

@@ -1,108 +0,0 @@
-type WPQueryOrderByParam =
-    | 'none' | 'id' | 'author' | 'title' | 'name' | 'date' | 'modified'
-    | 'parent' | 'menuOrder'| 'commentCount' | 'rand' | `RAND(${number})`
-    | (string & {});
-
-/**
- * Defines the arguments for querying posts.
- * Maps standard WordPress WP_Query parameters.
- */
-interface PostQueryArgs {
-    /** Post ID. */
-    postId?: number;
-    /** An array of post IDs to retrieve, sticky posts will be included. */
-    postIn?: number[];
-    /** An array of post IDs not to retrieve. */
-    postNotIn?: number[];
-    /** Path to post */
-    path?: string;
-    /** A post type slug (string) or array of post type slugs. */
-    postType?: string | string[];
-    /** A post type slug (string) or array of post type slugs to NOT include. */
-    postTypeNot?: string | string[];
-    /** A post status (string) or array of post statuses. */
-    postStatus?: string | string[];
-    /** A post slug (string) or array of post slugs. */
-    postSlug?: string | string[];
-    /** A post id to retrieve anscestry tree off */
-    postAncestryOf?: string;
-    /** Post title. */
-    title?: string;
-    /** The mime type of the post. Used for 'attachment' post_type. */
-    postMimeType?: string;
-    /** Page ID to retrieve child pages for. Use 0 to only retrieve top-level pages. */
-    postParent?: number;
-    /** An array containing parent page IDs to query child pages from. */
-    postParentIn?: number[];
-    /** An array containing parent page IDs not to query child pages from. */
-    postParentNotIn?: number[];
-    /** Term ID. */
-    termId?: number;
-    /** An array of term IDs (AND in). */
-    termAnd?: number[];
-    /** An array of term IDs (OR in). */
-    termIn?: number[];
-    /** An array of term IDs (NOT in). */
-    termNotIn?: number[];
-    /** Use term slug (not name, this or any children). */
-    termSlug?: string;
-    /** An array of term slugs (AND in). */
-    termSlugAnd?: string[];
-    /** An array of term slugs (OR in). */
-    termSlugIn?: string[];
-    /** Author ID. */
-    authorId?: number;
-    /** User 'user_nicename'. */
-    authorName?: string;
-    /** An array of author IDs to query from. */
-    authorIn?: number[];
-    /** An array of author IDs not to query from. */
-    authorNotIn?: number[];
-    /** search keyword(s). */
-    search?: string;
-    /** Whether to search by exact keyword. Default false. */
-    exact?: boolean;
-    /** array of column names to be searched. accepts 'postTitle', 'postExcerpt' and 'postContent'. */
-    searchColumns?: ('postTitle' | 'postExcerpt' | 'postContent')[];
-    /** Combination YearMonth. Accepts any four-digit year and month numbers 01-12. */
-    yyyymm?: number;
-    /** The four-digit year. Default empty. Accepts any four-digit year. */
-    year?: number;
-    /** The two-digit month. Default empty. Accepts numbers 1-12. */
-    monthnum?: number;
-    /** The week number of the year. Default empty. Accepts numbers 0-53. */
-    w?: number;
-    /** Day of the month. Default empty. Accepts numbers 1-31. */
-    day?: number;
-    /** Hour of the day. Default empty. Accepts numbers 0-23. */
-    hour?: number;
-    /** Minute of the hour. Default empty. Accepts numbers 0-59. */
-    minute?: number;
-    /** Second of the minute. Default empty. Accepts numbers 0-59. */
-    second?: number;
-    /** Whether to ignore sticky posts or not. Default false. */
-    ignoreStickyPosts?: boolean;
-    /** Designates ascending or descending order of posts. Default 'DESC'. */
-    order?: 'ASC' | 'DESC';
-    /** Sort retrieved posts by parameter. */
-    orderBy?: WPQueryOrderByParam;
-    /** Show posts that would show up on page X of a static front page. */
-    page?: number;
-    /** Show all posts (true) or paginate (false). Default false. */
-    noPaging?: boolean;
-    /** The number of posts to offset before retrieval. */
-    offset?: number;
-    /** The number of posts to query for. Use -1 to request all posts. */
-    postsPerPage?: number;
-    /** Whether to skip counting the total rows found. Default false. */
-    noFoundRows?: boolean;
-    /** Meta query  */
-    metaQuery?: {
-        /** Meta key */
-        metaKey: string,
-        /** Variable name to save result to */
-        as: string
-    }[]
-    /** Whether to get multiple, default true */
-    multiple?: bool
-}

package/lib/repository/postquery/post-query.ts

@@ -1,281 +0,0 @@
-import { QueryCreator, sql } from "kysely";
-import { DB } from "../../wpdb/wpdb.interface";
-import * as phpSerialize from "php-serialize";
-import { EntityQuery } from "../../globals/entity-loader/entity-loader";
-import { IPost } from "../../entities/post/post.interface";
-import { wpdb } from "@/wpdb/wpdb";
-
-/**
- * Executes database queries to retrieve post IDs and counts based on provided arguments.
- */
-export class PostQuery implements EntityQuery<IPost>
-{
-    private postCount?: number;
-
-    constructor(
-        private args: PostQueryArgs
-    ) {}
-
-    public getCount(): number | undefined {
-        return this.postCount;
-    }
-
-    public async getIds(): Promise<number[]> {
-        let builder = wpdb as QueryCreator<any>;
-
-        if (this.args.postAncestryOf) {
-            builder = builder.withRecursive('decendent_tree', (qb) =>
-                qb.selectFrom('wpPosts')
-                    .select(['wpPosts.ID', 'wpPosts.postName', 'wpPosts.postParent'])
-                    .where('wpPosts.postName', '=', this.args.postAncestryOf)
-                    .unionAll(
-                        qb.selectFrom('wpPosts as p')
-                            .select(['p.ID', 'p.postName', 'p.postParent'])
-                            .innerJoin('decendent_tree as d', 'p.postParent', 'd.ID')
-                    )
-            )
-        }
-
-        let query = (builder as QueryCreator<DB>).selectFrom('wpPosts');
-
-        if (this.args.postAncestryOf) {
-            query = query.where('wpPosts.postName', 'in', (qb: any) =>
-                qb.selectFrom('decendent_tree').select('postName')
-            );
-        }
-
-        // --- ID Filters ---
-        if (this.args.postId)    query = query.where('wpPosts.ID', '=', this.args.postId);
-        if (this.args.postIn)    query = query.where('wpPosts.ID', 'in', this.args.postIn);
-        if (this.args.postNotIn) query = query.where('wpPosts.ID', 'not in', this.args.postNotIn);
-
-        if (this.args.path) {
-            query = query.where((eb) => eb.exists(
-                eb.selectFrom('wpPostmeta')
-                    .select('postId')
-                    .whereRef('postId', '=', 'wpPosts.ID')
-                    .where('wpPostmeta.metaKey', '=', '_nextpress_path')
-                    .where('wpPostmeta.metaValue', '=', this.args.path as string)
-            ));
-        }
-        // --- Type Filters ---
-        if (this.args.postType) {
-            const types = Array.isArray(this.args.postType) ? this.args.postType : [this.args.postType];
-            query = query.where('wpPosts.postType', 'in', types);
-        }
-        if (this.args.postTypeNot) {
-            const types = Array.isArray(this.args.postTypeNot) ? this.args.postTypeNot : [this.args.postTypeNot];
-            query = query.where('wpPosts.postType', 'not in', types);
-        }
-
-        // --- Status Filters ---
-        if (this.args.postStatus) {
-            const statuses = Array.isArray(this.args.postStatus) ? this.args.postStatus : [this.args.postStatus];
-            query = query.where('wpPosts.postStatus', 'in', statuses);
-        }
-
-        // --- Content Filters ---
-        if (this.args.postSlug) {
-            const postSlugs = Array.isArray(this.args.postSlug) ? this.args.postSlug : [this.args.postSlug];
-            query = query.where('wpPosts.postName', 'in', postSlugs);
-        }
-        if (this.args.title)        query = query.where('wpPosts.postTitle', '=', this.args.title);
-        if (this.args.postMimeType) query = query.where('wpPosts.postMimeType', 'like', `%${this.args.postMimeType}%`);
-
-        // --- Parent Filters ---
-        if (this.args.postParent !== undefined)  query = query.where('wpPosts.postParent', '=', this.args.postParent);
-        if (this.args.postParentIn)              query = query.where('wpPosts.postParent', 'in', this.args.postParentIn);
-        if (this.args.postParentNotIn)           query = query.where('wpPosts.postParent', 'not in', this.args.postParentNotIn);
-
-        // --- Term Filters ---
-        if (this.args.termId) {
-            query = query.innerJoin('wpTermRelationships', 'wpPosts.ID', 'wpTermRelationships.objectId')
-                        .where('wpTermRelationships.termTaxonomyId', '=', this.args.termId);
-        }
-        if (this.args.termAnd) {
-            query = query.innerJoin('wpTermRelationships', 'wpPosts.ID', 'wpTermRelationships.objectId')
-                        .where('wpTermRelationships.termTaxonomyId', 'in', this.args.termAnd)
-                        .groupBy('wpPosts.ID')
-                        .having((eb) => eb.fn.count('wpTermRelationships.termTaxonomyId'), '=', this.args.termAnd!.length);
-        }
-        if (this.args.termIn) {
-            query = query.innerJoin('wpTermRelationships', 'wpPosts.ID', 'wpTermRelationships.objectId')
-                        .where('wpTermRelationships.termTaxonomyId', 'in', this.args.termIn);
-        }
-        if (this.args.termNotIn) {
-            query = query.where('wpPosts.ID', 'not in',
-                (qb) =>
-                    qb.selectFrom('wpTermRelationships')
-                        .select('wpTermRelationships.objectId')
-                        .where('wpTermRelationships.termTaxonomyId', 'in', this.args.termNotIn!)
-            );
-        }
-        if (this.args.termSlug) {
-            query = query.innerJoin('wpTermRelationships', 'wpPosts.ID', 'wpTermRelationships.objectId')
-                        .innerJoin('wpTerms', 'wpTermRelationships.termTaxonomyId', 'wpTerms.termId')
-                        .where('wpTerms.slug', '=', this.args.termSlug)
-                        .groupBy('wpPosts.ID');
-        }
-        if (this.args.termSlugAnd) {
-            query = query.innerJoin('wpTermRelationships', 'wpPosts.ID', 'wpTermRelationships.objectId')
-                        .innerJoin('wpTerms', 'wpTermRelationships.termTaxonomyId', 'wpTerms.termId')
-                        .where('wpTerms.slug', 'in', this.args.termSlugAnd)
-                        .groupBy('wpPosts.ID')
-                        .having((eb) => eb.fn.count('wpTermRelationships.termTaxonomyId'), '=', this.args.termSlugAnd!.length);
-        }
-        if (this.args.termSlugIn) {
-            query = query.innerJoin('wpTermRelationships', 'wpPosts.ID', 'wpTermRelationships.objectId')
-                        .innerJoin('wpTerms', 'wpTermRelationships.termTaxonomyId', 'wpTerms.termId')
-                        .where('wpTerms.slug', 'in', this.args.termSlugIn)
-                        .groupBy('wpPosts.ID');
-        }
-
-        // --- Author Filters ---
-        if (this.args.authorId)      query = query.where('wpPosts.postAuthor', '=', this.args.authorId);
-        if (this.args.authorIn)      query = query.where('wpPosts.postAuthor', 'in', this.args.authorIn);
-        if (this.args.authorNotIn)   query = query.where('wpPosts.postAuthor', 'not in', this.args.authorNotIn);
-        if (this.args.authorName) {
-            query = query.innerJoin('wpUsers', 'wpPosts.postAuthor', 'wpUsers.ID')
-                        .where('wpUsers.displayName', '=', this.args.authorName);
-        }
-
-        // --- Search Filters ---
-        if (this.args.search) {
-            const searchTerm = this.args.exact ? this.args.search : `%${this.args.search}%`;
-            const searchCols = this.args.searchColumns || ['postTitle', 'postContent', 'postExcerpt'];
-            const isExact = this.args.exact;
-
-            query = query.where((eb) => {
-                const orClauses = searchCols.map(col => eb(col, isExact ? '=' : 'like', searchTerm));
-                return eb.or(orClauses);
-            });
-        }
-
-        // --- Date Filters ---
-        if (this.args.yyyymm) {
-            const mStr = String(this.args.yyyymm);
-            const y = Number(mStr.substring(0, 4));
-            const mon = Number(mStr.substring(4, 6));
-            query = query.where((eb) => eb.fn('YEAR', [eb.ref('wpPosts.postDate')]), '=', y)
-                        .where((eb) => eb.fn('MONTH', [eb.ref('wpPosts.postDate')]), '=', mon);
-        }
-        if (this.args.year)                 query = query.where((eb) => eb.fn('YEAR', [eb.ref('wpPosts.postDate')]), '=', this.args.year);
-        if (this.args.monthnum)             query = query.where((eb) => eb.fn('MONTH', [eb.ref('wpPosts.postDate')]), '=', this.args.monthnum);
-        if (this.args.w)                    query = query.where((eb) => eb.fn('WEEK', [eb.ref('wpPosts.postDate')]), '=', this.args.w);
-        if (this.args.day)                  query = query.where((eb) => eb.fn('DAY', [eb.ref('wpPosts.postDate')]), '=', this.args.day);
-        if (this.args.hour !== undefined)   query = query.where((eb) => eb.fn('HOUR', [eb.ref('wpPosts.postDate')]), '=', this.args.hour);
-        if (this.args.minute !== undefined) query = query.where((eb) => eb.fn('MINUTE', [eb.ref('wpPosts.postDate')]), '=', this.args.minute);
-        if (this.args.second !== undefined) query = query.where((eb) => eb.fn('SECOND', [eb.ref('wpPosts.postDate')]), '=', this.args.second);
-
-        // -- Calculate Total Count (Before Limits/Offsets) --
-        if (!this.args.noFoundRows) {
-            try {
-                const countQueryBase = query.clearSelect().select('wpPosts.ID').distinct();
-                const countResult = await wpdb.selectFrom(countQueryBase.as('sub'))
-                    .select(sql<number>`count(*)`.as('count'))
-                    .executeTakeFirst();
-
-                this.postCount = countResult ? Number(countResult.count) : undefined;
-            } catch (error: any) {
-                console.error('WPPostQuery: Cannot get row count: ', error.message);
-                this.postCount = undefined;
-            }
-        } else {
-            this.postCount = undefined;
-        }
-
-        // -- Apply ORDER BY --
-        if (!this.args.ignoreStickyPosts) {
-            const rawStickyPostIds = await getOption('sticky_posts');
-
-            let stickyPosts: number[] = [];
-            try {
-                const parsed = phpSerialize.unserialize(rawStickyPostIds ?? 'a:0:{}');
-                stickyPosts = Object.values(parsed as Record<string, number> | number[]);
-            } catch (error) {
-                console.warn('WPPostQuery: Failed to parse sticky_posts option. Defaulting to empty.', error);
-            }
-
-            if (stickyPosts.length > 0) {
-                query = query.orderBy(
-                    sql`CASE WHEN wp_posts.ID IN (${sql.join(stickyPosts)}) THEN 0 ELSE 1 END`,
-                    'asc'
-                );
-            }
-        }
-
-        const orderDirection = this.args.order === 'ASC' ? 'asc' : 'desc';
-        const orderBy = this.args.orderBy || 'none';
-
-        switch(orderBy) {
-            case 'none': break;
-            case 'id':              query = query.orderBy('wpPosts.ID', orderDirection); break;
-            case 'author':          query = query.orderBy('wpPosts.postAuthor', orderDirection).orderBy('wpPosts.ID', orderDirection); break;
-            case 'title':           query = query.orderBy('wpPosts.postTitle', orderDirection).orderBy('wpPosts.ID', orderDirection); break;
-            case 'name':            query = query.orderBy('wpPosts.postName', orderDirection).orderBy('wpPosts.ID', orderDirection); break;
-            case 'date':            query = query.orderBy('wpPosts.postDate', orderDirection).orderBy('wpPosts.ID', orderDirection); break;
-            case 'modified':        query = query.orderBy('wpPosts.postModified', orderDirection).orderBy('wpPosts.ID', orderDirection); break;
-            case 'parent':          query = query.orderBy('wpPosts.postParent', orderDirection).orderBy('wpPosts.ID', orderDirection); break;
-            case 'menuOrder':       query = query.orderBy('wpPosts.menuOrder', orderDirection).orderBy('wpPosts.ID', orderDirection); break;
-            case 'commentCount':    query = query.orderBy('wpPosts.commentCount', orderDirection).orderBy('wpPosts.ID', orderDirection); break;
-            case 'rand':            query = query.orderBy((eb) => eb.fn('RAND', [])).orderBy('wpPosts.ID', orderDirection); break;
-            default:
-                if (orderBy.startsWith('RAND(')) {
-                    const seed = parseInt(orderBy.replace(/\D/g, ''), 10);
-                    query = query.orderBy((eb) => eb.fn('RAND', [eb.val(seed)])).orderBy('wpPosts.ID', orderDirection);
-                } else {
-                    query = query.orderBy('wpPosts.postDate', orderDirection).orderBy('wpPosts.ID', orderDirection);
-                }
-                break;
-        }
-
-        // -- Apply LIMIT & OFFSET --
-        if (!this.args.noPaging) {
-            const perPage = this.args.postsPerPage ?? 10;
-
-            if (perPage > -1) {
-                query = query.limit(perPage);
-
-                const page = this.args.page ?? 1;
-                const baseOffset = this.args.offset ?? 0;
-                const offsetAmount = ((page - 1) * perPage) + baseOffset;
-
-                if (offsetAmount > 0) {
-                    query = query.offset(offsetAmount);
-                }
-            }
-        }
-
-        if (this.args.metaQuery) {
-            let dynamicQuery: any = query;
-
-            for (let metaQuery of this.args.metaQuery) {
-                const uniqueAlias = `meta_${metaQuery.as}`;
-
-                dynamicQuery = dynamicQuery.leftJoin(`wpPostmeta as ${uniqueAlias}`, (join: any) =>
-                    join
-                        .onRef(`${uniqueAlias}.postId`, '=', 'wpPosts.ID')
-                        .on(`${uniqueAlias}.metaKey`, '=', metaQuery.metaKey)
-                    )
-                    .select(`${uniqueAlias}.metaValue as ${metaQuery.as}`);
-            }
-
-            query = dynamicQuery;
-        }
-
-        try {
-            if(this.args.multiple !== false) {
-                return (await query
-                    .select('wpPosts.ID as id')
-                    .groupBy('wpPosts.ID')
-                    .execute()).map(res => res.id);
-            } else {
-                return (await query
-                    .select('wpPosts.ID as id')
-                    .execute()).map(res => res.id);
-            }
-        } catch (error: any) {
-            throw new Error(`WPPostQuery: Cannot get posts: ${error.message}`, { cause: error });
-        }
-    }
-}

package/lib/repository/termquery/term-query-args.d.ts

@@ -1,61 +0,0 @@
-/**
- * Defines the arguments for querying terms.
- * Maps standard WordPress WP_Term_Query parameters.
- */
-interface TermQueryArgs {
-    /** Taxonomy name, or array of taxonomy names, to which results should be limited. */
-    taxonomy?: string | string[];
-    /** Taxonomy ID, or array of term taxonomy IDs, to match when querying terms. */
-    taxonomyId?: number | number[];
-    /** TermId or array of term IDs to include along with all of their descendant terms. */
-    termId?: number | number[];
-    /** TermId or array of term IDs to exclude along with all of their descendant terms. */
-    termIdNot?: number | number[];
-    /** Slug or array of slugs to return term(s) for. Default empty. */
-    termSlug?: string | string[];
-    /** Slug or array of slugs to return term(s) for. Default empty. */
-    termSlugNot?: string | string[];
-    /** Name or array of names to return term(s) for. Default empty. */
-    termName?: string | string[];
-    /** Nextpress path to the term */
-    path?: string;
-    /** Whether to hide terms not assigned to any posts. Default true. */
-    hideEmpty?: boolean;
-    /** Field(s) to order terms by. Default 'none'. */
-    orderBy?:
-        | 'term_id'
-        | 'name'
-        | 'slug'
-        | 'term_group'
-        | 'description'
-        | 'parent'
-        | 'term_order'
-        | 'count'
-        | 'none'
-        | string;
-    /** Whether to order terms in ascending or descending order. Default 'ASC'. */
-    order?: 'ASC' | 'DESC';
-    /** Maximum number of terms to return. Accepts 0 (all) or any positive number. Default 0 (all). */
-    number?: number;
-    /** The number by which to offset the terms query. Default empty. */
-    offset?: number;
-    /** Parent term ID to retrieve direct-child terms of. Default empty. */
-    parent?: number;
-    /** True to limit results to terms that have no children. This parameter has no effect on non-hierarchical taxonomies. Default false. */
-    childless?: boolean;
-    /** Search criteria to match terms. Will be SQL-formatted with wildcards before and after. Default empty. */
-    search?: string;
-    /** Retrieve terms with criteria by which a term is LIKE `$nameLike`. Default empty. */
-    nameLike?: string;
-    /** Retrieve terms where the description is LIKE `$descriptionLike`. Default empty. */
-    descriptionLike?: string;
-    /** Meta query  */
-    metaQuery?: {
-        /** Meta key */
-        metaKey: string,
-        /** Variable name to save result to */
-        as: string
-    }[]
-    /** Whether to get multiple, default true */
-    multiple?: bool
-}