nextpress-core 1.0.0 → 1.0.2

package/lib/entities/user/user.ts

@@ -1,86 +0,0 @@
-import { unserialize } from "php-serialize";
-import { IUser } from "./user.interface";
-import { wpdb } from "@/wpdb/wpdb";
-
-export class User implements IUser {
-    constructor(
-        public ID: number
-    ) {}
-
-    /** Raw user data from database. */
-    private userData?: Record<string, any>;
-    /** Map of user meta key-value pairs. */
-    private metaMap?: Map<string, string>;
-
-    /**
-     * Retrieves array of User instances by IDs.
-     *
-     * @param {number[]} ids - Array of user IDs to retrieve.
-     * @returns {Promise<User[]>} Promise resolving to array of User instances.
-     */
-    static async get(ids: number[]): Promise<User[]> {
-        ids = ids.filter(Boolean);
-        if (!ids || !ids.length) return [];
-
-        const usersData = await wpdb
-            .selectFrom('wpUsers')
-            .where('ID', 'in', ids)
-            .selectAll()
-            .execute();
-
-        const metaData = await wpdb
-            .selectFrom('wpUsermeta')
-            .where('userId', 'in', ids)
-            .where('metaKey', 'in', [
-                'wp_capabilities',
-                'show_admin_bar_front'
-            ])
-            .select(['userId', 'metaKey', 'metaValue'])
-            .execute();
-
-        const metaByUserId = new Map<number, Map<string, string>>();
-        for (const row of metaData) {
-            const userId = Number(row.userId);
-            if (!metaByUserId.has(userId)) {
-                metaByUserId.set(userId, new Map());
-            }
-            metaByUserId.get(userId)?.set(row.metaKey || '', row.metaValue || '');
-        }
-
-        const userDataMap = new Map(usersData.map(user => [Number(user.ID), user]));
-
-        return ids.map(id => {
-            const instance = new User(id);
-
-            instance.userData = userDataMap.get(id);
-            instance.metaMap = metaByUserId.get(id) || new Map<string, string>();
-
-            return instance;
-        });
-    }
-
-    get roles(): string[] {
-        const rawCapabilities = this.metaMap?.get('wp_capabilities');
-        if (!rawCapabilities) return [];
-        try {
-            return Object.keys(unserialize(rawCapabilities));
-        } catch (error: any) {
-            console.warn('Error while getting user: Could not unserialize php: ', error.message);
-            return [];
-        }
-    }
-
-    get showAdminBar(): boolean {
-        return this.metaMap?.get('show_admin_bar_front') === 'true';
-    }
-
-    get displayName(): string { return this.userData?.['displayName'] ?? ''; }
-    get userActivationKey(): string { return this.userData?.['userActivationKey'] ?? ''; }
-    get userEmail(): string { return this.userData?.['userEmail'] ?? ''; }
-    get userLogin(): string { return this.userData?.['userLogin'] ?? ''; }
-    get userNicename(): string { return this.userData?.['userNicename'] ?? ''; }
-    get userPass(): string { return this.userData?.['userPass'] ?? ''; }
-    get userRegistered(): Date { return this.userData?.['userRegistered'] ?? new Date(); }
-    get userStatus(): number { return this.userData?.['userStatus'] ? Number(this.userData['userStatus']) : 0; }
-    get userUrl(): string { return this.userData?.['userUrl'] ?? ''; }
-}

package/lib/globals/entity-loader/entity-loader.d.ts

@@ -1,50 +0,0 @@
-/**
- * Defines the contract for an entity loader.
- *
- * @template EntityT The type of entity being loaded.
- * @template QueryArgsT The type of arguments used for querying the entity.
- */
-export interface EntityLoader<EntityT, QueryArgsT> {
-    /**
-     * Queues entity IDs for loading.
-     *
-     * @param {number[]} ids Array of entity IDs.
-     */
-    prime: (ids: number[]) => void;
-    /**
-     * Finds entity IDs based on query arguments and queues them for loading.
-     *
-     * @param {QueryArgsT} args Query arguments.
-     * @returns {Promise<{ids: number[], count: number}>} Array of found IDs and the total count.
-     * @throws {Error} If the query fails.
-     */
-    findAndPrime: (args: QueryArgsT) => Promise<{ids: number[], count: number}>;
-    /**
-     * Retrieves entities by their IDs.
-     *
-     * @param {number[]} ids Array of entity IDs.
-     * @returns {Promise<EntityT[]>} Array of entities.
-     * @throws {Error} If retrieval fails.
-     */
-    get: (ids: number[]) => Promise<EntityT[]>;
-}
-
-/**
- * Defines the contract for an entity query.
- *
- * @template TArgs The type of query arguments.
- */
-export interface EntityQuery<TArgs> {
-    /**
-     * Executes the query and returns the matching entity IDs.
-     *
-     * @returns {Promise<number[]>} Array of entity IDs.
-     * @throws {Error} If the query fails.
-     */
-    getIds(): Promise<number[]>;
-    /**
-     * Retrieves the total count of entities matching the query.
-     * @returns {number | undefined} Total count, or undefined if not computed.
-     */
-    getCount(): number | undefined;
-}

package/lib/globals/entity-loader/option-loader.ts

@@ -1,56 +0,0 @@
-import { OptionQuery } from "@/repository/optionquery/option-query";
-import { Option } from "../../entities/option/option";
-import { IOption } from "../../entities/option/option.interface";
-import { OptionQueryArgs } from "../../repository/optionquery/option-query-args";
-import { EntityLoader } from "./entity-loader";
-import { EntityLoaderBase } from "./entity-loader-base";
-
-class OptionLoader extends EntityLoaderBase<IOption, OptionQueryArgs> {
-    private static _instance: OptionLoader;
-
-    protected queryClass = OptionQuery;
-
-    private constructor() {
-        super();
-    }
-
-    public static instance(): OptionLoader {
-        if (!this._instance) {
-            this._instance = new OptionLoader();
-        }
-        return this._instance;
-    }
-
-    protected async fetchFromDatabase(ids: number[]): Promise<IOption[]> {
-        return await Option.get(ids);
-    }
-
-    protected getEntityId(option: IOption): number {
-        return option.optionId;
-    }
-}
-
-declare global {
-    /** Global instance of the OptionLoader. */
-    var optionLoader: EntityLoader<IOption, OptionQueryArgs>
-
-    /**
-     * Retrieves an option value by name.
-     *
-     * @param {string} name The option name.
-     *
-     * @returns {Promise<string | undefined>} The option value or undefined.
-     */
-    var getOption: (name: string) => Promise<string | undefined>;
-}
-
-globalThis.optionLoader = OptionLoader.instance();
-globalThis.getOption = async (name) => {
-    const foundOptions = await optionLoader.findAndPrime({
-        column: 'optionName',
-        operand: '=',
-        value: name
-    })
-
-    return (await optionLoader.get(foundOptions.ids))[0]?.optionValue;
-}

package/lib/globals/entity-loader/post-loader.ts

@@ -1,59 +0,0 @@
-import { Post } from "@/entities/post/post";
-import { IPost } from "../../entities/post/post.interface";
-import { EntityLoader } from "./entity-loader";
-import { EntityLoaderBase } from "./entity-loader-base";
-import { PostQuery } from "@/repository/postquery/post-query";
-
-class PostLoader extends EntityLoaderBase<IPost, PostQueryArgs> {
-    private static _instance: PostLoader;
-
-    protected queryClass = PostQuery;
-
-    private constructor() {
-        super();
-    }
-
-    public static instance(): PostLoader {
-        if (!this._instance) {
-            this._instance = new PostLoader();
-        }
-        return this._instance;
-    }
-
-    protected async fetchFromDatabase(ids: number[]): Promise<IPost[]> {
-        return await Post.get(ids);
-    }
-
-    protected getEntityId(post: IPost): number {
-        return post.ID;
-    }
-}
-
-declare global {
-    /** Global instance of the PostLoader. */
-    var postLoader: EntityLoader<IPost, PostQueryArgs>
-    /**
-     * Retrieves posts by their IDs.
-     *
-     * @param {number[]} ids Array of post IDs.
-     * @returns {Promise<IPost[]>} Array of posts.
-     */
-    var getPosts: (ids: number[]) => Promise<IPost[]>
-    /**
-     * Retrieves a single post by ID.
-     *
-     * @param {number} id The post ID.
-     * @returns {Promise<IPost | undefined>} The post or undefined.
-     */
-    var getPost: (id: number) => Promise<IPost | undefined>
-}
-
-globalThis.postLoader = PostLoader.instance();
-globalThis.getPosts = async (ids) => {
-    return await postLoader.get(ids);
-}
-globalThis.getPost = async (id) => {
-    return (await postLoader.get([id]))[0];
-}
-
-export {};

package/lib/globals/entity-loader/term-loader.ts

@@ -1,59 +0,0 @@
-import { Term } from "@/entities/term/term";
-import { ITerm } from "../../entities/term/term.interface";
-import { EntityLoader } from "./entity-loader";
-import { EntityLoaderBase } from "./entity-loader-base";
-import { TermQuery } from "@/repository/termquery/term-query";
-
-class TermLoader extends EntityLoaderBase<ITerm, TermQueryArgs> {
-    private static _instance: TermLoader;
-
-    protected queryClass = TermQuery;
-
-    private constructor() {
-        super();
-    }
-
-    public static instance(): TermLoader {
-        if (!this._instance) {
-            this._instance = new TermLoader();
-        }
-        return this._instance;
-    }
-
-    protected async fetchFromDatabase(ids: number[]): Promise<ITerm[]> {
-        return await Term.get(ids);
-    }
-
-    protected getEntityId(term: ITerm): number {
-        return term.termId;
-    }
-}
-
-declare global {
-    /** Global instance of the TermLoader. */
-    var termLoader: EntityLoader<ITerm, TermQueryArgs>
-    /**
-     * Retrieves terms by their IDs.
-     *
-     * @param {number[]} ids Array of term IDs.
-     * @returns {Promise<ITerm[]>} Array of terms.
-     */
-    var getTerms: (ids: number[]) => Promise<ITerm[]>
-    /**
-     * Retrieves a single term by ID.
-     *
-     * @param {number} id The term ID.
-     * @returns {Promise<ITerm | undefined>} The term or undefined.
-     */
-    var getTerm: (id: number) => Promise<ITerm | undefined>
-}
-
-globalThis.termLoader = TermLoader.instance();
-globalThis.getTerms = async (ids) => {
-    return await termLoader.get(ids);
-}
-globalThis.getTerm = async (id) => {
-    return (await termLoader.get([id]))[0];
-}
-
-export {};

package/lib/globals/entity-loader/user-loader.ts

@@ -1,60 +0,0 @@
-import { User } from "@/entities/user/user";
-import { IUser } from "../../entities/user/user.interface";
-import { EntityLoader } from "./entity-loader";
-import { EntityLoaderBase } from "./entity-loader-base";
-import { UserQuery } from "@/repository/userquery/user-query";
-
-class UserLoader extends EntityLoaderBase<IUser, UserQueryArgs> {
-    private static _instance: UserLoader;
-
-    protected queryClass = UserQuery;
-
-    private constructor() {
-        super();
-    }
-
-    public static instance(): UserLoader {
-        if (!this._instance) {
-            this._instance = new UserLoader();
-        }
-        return this._instance;
-    }
-
-    protected async fetchFromDatabase(ids: number[]): Promise<IUser[]> {
-        return await User.get(ids);
-    }
-
-    protected getEntityId(user: IUser): number {
-        return user.ID;
-    }
-}
-
-declare global {
-    /** Global instance of the UserLoader. */
-    var userLoader: EntityLoader<IUser, UserQueryArgs>
-    /**
-     * Retrieves users by their IDs.
-     *
-     * @param {number[]} ids Array of user IDs.
-     * @returns {Promise<IUser[]>} Array of users.
-     */
-    var getUsers: (ids: number[]) => Promise<IUser[]>
-
-    /**
-     * Retrieves a single user by ID.
-     *
-     * @param {number} id The user ID.
-     * @returns {Promise<IUser | undefined>} The user or undefined.
-     */
-    var getUser: (id: number) => Promise<IUser | undefined>
-}
-
-globalThis.userLoader = UserLoader.instance();
-globalThis.getUsers = async (ids) => {
-    return await userLoader.get(ids);
-}
-globalThis.getUser = async (id) => {
-    return (await userLoader.get([id]))[0];
-}
-
-export {};

package/lib/globals/get-field/get-field.ts

@@ -1,75 +0,0 @@
-import { mapField } from "../../acf-functions/services/map-fields/map-fields";
-import { IFieldLocation } from "../../entities/common";
-import { FieldProps } from "../../acf-functions/types/components/field-props";
-
-/** Specifies location to retrieve fields from. */
-type Location = IFieldLocation | 'options';
-
-declare global {
-    /**
-     * Retrieves, parses, and maps an Advanced Custom Fields (ACF) value to its corresponding component properties.
-     *
-     * @param {T} fieldGroup The configuration object defining the ACF field group and its schema.
-     * @param {K} selector The key name of the field to retrieve.
-     * @param {Location} [location] The database entity or context from which to load the field data. Accepts an `IFieldLocation` object or the string `'options'`. Defaults to the current queried object if omitted.
-     *
-     * @returns {Promise<FieldProps<T>[K]>} A promise resolving to the mapped field properties.
-     */
-    var getField: <
-        T extends NextpressFieldGroup,
-        K extends keyof FieldProps<T> & string
-    >(
-        fieldGroup: T,
-        selector: K,
-        location?: Location
-    ) => Promise<FieldProps<T>[K]>;
-}
-
-globalThis.getField = async (fieldGroup, selector, location) => {
-    if (!location) {
-        switch(queriedObject.objectType) {
-            case 'post':
-                location = await getThePost();
-                break;
-            // TODO: Add support for Term and User
-            // case 'term':
-            //     location = await getTheTerm();
-            //     break;
-            // case 'user':
-            //     location = await getTheUser();
-            //     break;
-        }
-    }
-    if (!location) return [];
-
-    const values = await (async () => {
-        if (location === 'options') {
-            const prefix = 'options_';
-
-            const foundOptions = await optionLoader.findAndPrime({
-                column: 'optionName',
-                operand: 'like',
-                value: `${prefix}%`
-            })
-
-            const options = await optionLoader.get(foundOptions.ids);
-
-            return options.map(option => ({
-                key: option.optionName.slice(prefix.length),
-                value: option.optionValue
-            }))
-        }
-
-        return await location.getFields(selector);
-    })() ?? [];
-
-    const valueMap: Map<string, string> = values.reduce((map, value) => {
-        map.set(value.key, value.value);
-        return map;
-    }, new Map());
-
-    const field = fieldGroup.fields.find(field => field.name === selector);
-    if (!field) return;
-
-    return mapField(field, valueMap) as any;
-}

package/lib/globals/nextpress-config/nextpress-config.interface.d.ts

@@ -1,18 +0,0 @@
-type NextpressConfig = {
-    /** Custom taxonomies used to categorize and group content (like categories or tags). Expects the taxonomy's URL prefix, so tag instead of post_tag */
-    readonly publicTaxonomies?: string[],
-
-    /** Custom post types registered for public consumption (like posts, pages, or portfolio). */
-    readonly publicPostTypes?: string[],
-
-    /** Post types that should display archive pages on the frontend. */
-    readonly archivedPostTypes?: string[],
-
-    /** The word/character count limit for automatically generated post teasers. */
-    readonly excerptLength?: number,
-
-    /** Database option keys (from wp_options) to fetch early for performance optimization. */
-    readonly preLoadOptions?: string[],
-} & {
-    [key: string]: any;
-};

package/lib/globals/queried-object/queried-object.ts

@@ -1,124 +0,0 @@
-import { IPost } from "../../entities/post/post.interface";
-import { ITerm } from "../../entities/term/term.interface";
-import { IUser } from "../../entities/user/user.interface";
-import { queriedObjectState } from "../globals";
-
-/**
- * Represents the state of the queried object.
- */
-interface IQueriedObject {
-    /** Type of the queried object. */
-    objectType: 'post' | 'term' | 'user' | null,
-    /** Array of post IDs associated with the query. */
-    posts: number[],
-    /** Current page number. */
-    page: number,
-    /** Total page count. */
-    pageCount: number,
-    /** ID of the main queried term. */
-    mainTerm?: number,
-    /** Array of term IDs associated with the query. */
-    terms: number[],
-    /** ID of the queried user. */
-    user?: number,
-}
-
-/**
- * Creates a blank queried object state.
- *
- * @returns {IQueriedObject} Blank state object.
- */
-const createBlankState = (): IQueriedObject => ({
-    objectType: null,
-    posts: [],
-    page: 1,
-    pageCount: 1,
-    terms: [],
-});
-
-declare global {
-    /** The current queried object. */
-    var queriedObject: IQueriedObject
-    /**
-     * Retrieves the first post from the queried object.
-     * @returns {Promise<IPost | undefined>} The post.
-     */
-    var getThePost: () => Promise<IPost | undefined>
-    /**
-     * Retrieves all posts from the queried object.
-     * @returns {Promise<IPost[]>} Array of posts.
-     */
-    var getThePosts: () => Promise<IPost[]>
-    /**
-     * Retrieves the current page number.
-     * @returns {number} Page number.
-     */
-    var getThePage: () => number
-    /**
-     * Retrieves the total page count.
-     * @returns {number} Page count.
-     */
-    var getThePageCount: () => number
-    /**
-     * Retrieves the main term from the queried object.
-     * @returns {Promise<ITerm | undefined>} The term.
-     */
-    var getTheTerm: () => Promise<ITerm | undefined>
-    /**
-     * Retrieves all terms from the queried object.
-     * @returns {Promise<ITerm[]>} Array of terms.
-     */
-    var getTheTerms: () => Promise<ITerm[]>
-    /**
-     * Retrieves the user from the queried object.
-     * @returns {Promise<IUser | undefined>} The user.
-     */
-    var getTheUser: () => Promise<IUser | undefined>
-}
-
-Object.defineProperty(globalThis, 'queriedObject', {
-    configurable: true,
-    enumerable: true,
-    get() {
-        const state = queriedObjectState();
-        return state.currentState || createBlankState();
-    },
-    set(newData: IQueriedObject) {
-        const store = queriedObjectState();
-
-        if (newData.posts) postLoader.prime(newData.posts);
-        if (newData.mainTerm) termLoader.prime([newData.mainTerm]);
-        if (newData.terms) termLoader.prime(newData.terms);
-        if (newData.user) userLoader.prime([newData.user]);
-
-        if (!store.currentState) store.currentState = {};
-        Object.assign(store.currentState, newData);
-    }
-});
-
-globalThis.getThePost = async () => {
-    return (await postLoader.get(globalThis.queriedObject.posts))[0];
-};
-globalThis.getThePosts = () => {
-    return postLoader.get(globalThis.queriedObject.posts);
-};
-
-globalThis.getThePage = () => globalThis.queriedObject.page;
-
-globalThis.getThePageCount = () => globalThis.queriedObject.pageCount;
-
-globalThis.getTheTerm = async () => {
-    if (!globalThis.queriedObject.mainTerm) return;
-    return (await termLoader.get([globalThis.queriedObject.mainTerm]))[0];
-};
-
-globalThis.getTheTerms = () => {
-    return termLoader.get(globalThis.queriedObject.terms);
-};
-
-globalThis.getTheUser = async () => {
-    if (!globalThis.queriedObject.user) return;
-    return (await userLoader.get([globalThis.queriedObject.user]))[0];
-};
-
-export {};

package/lib/repository/optionquery/option-query-args.d.ts

@@ -1,21 +0,0 @@
-import { DB, WpOption } from "../../wpdb/wpdb.interface";
-
-/**
- * Defines the arguments for querying options.
- */
-interface OptionQueryArgs {
-    /**
-     * Database column reference to query against.
-     */
-    column: ReferenceExpression<DB, WpOption>;
-
-    /**
-     * Comparison operator for the query.
-     */
-    operand?: ComparisonOperatorExpression;
-
-    /**
-     * Value or array of values to compare.
-     */
-    value: string | string[];
-}

package/lib/repository/optionquery/option-query.ts

@@ -1,29 +0,0 @@
-import { ComparisonOperatorExpression } from "kysely";
-import { EntityQuery } from "../../globals/entity-loader/entity-loader";
-import { OptionQueryArgs } from "./option-query-args";
-import { IOption } from "../../entities/option/option.interface";
-import { wpdb } from "@/wpdb/wpdb";
-
-/**
- * Executes database queries to retrieve option IDs (or keys) based on provided arguments.
- */
-export class OptionQuery implements EntityQuery<IOption>
-{
-    constructor(
-        private args: OptionQueryArgs
-    ) {}
-
-    public getCount(): number | undefined {
-        return undefined;
-    }
-
-    public async getIds(): Promise<number[]> {
-        const operand: ComparisonOperatorExpression = this.args.operand || '=';
-
-        return (await wpdb
-            .selectFrom('wpOptions')
-            .select('optionId')
-            .where(this.args.column, operand, this.args.value)
-            .execute()).map(option => option.optionId);
-    }
-}