nextpress-core 1.0.0 → 1.0.1

package/dist/entities/post/post.js

@@ -0,0 +1,184 @@
+var _a;
+import { unserialize } from "php-serialize";
+import { processURL } from "@/services/utilities/process-url";
+import { wpdb } from "@/wpdb/wpdb";
+const excerptLength = (_a = nextpressConfig.excerptLength) !== null && _a !== void 0 ? _a : 55;
+/**
+ * Implementation of IPost entity.
+ */
+export class Post {
+    constructor(ID) {
+        this.ID = ID;
+    }
+    /**
+     * Retrieves array of Post instances by IDs.
+     *
+     * @param {number[]} ids - Array of post IDs to retrieve.
+     * @returns {Promise<Post[]>} Promise resolving to array of Post instances.
+     */
+    static async get(ids) {
+        var _a;
+        ids = ids.filter(Boolean);
+        if (!ids || !ids.length)
+            return [];
+        const postsData = await wpdb
+            .selectFrom('wpPosts')
+            .where('ID', 'in', ids)
+            .selectAll()
+            .execute();
+        const metaData = await wpdb
+            .selectFrom('wpPostmeta')
+            .where('postId', 'in', ids)
+            .where('metaKey', 'in', [
+            '_nextpress_path',
+            '_thumbnail_id',
+            '_wp_attachment_image_alt',
+            '_wp_attachment_metadata',
+            '_menu_item_type',
+            '_menu_item_object_id',
+            '_menu_item_url',
+            '_menu_item_menu_item_parent'
+        ])
+            .select(['postId', 'metaKey', 'metaValue'])
+            .execute();
+        const metaByPostId = new Map();
+        for (const row of metaData) {
+            const postId = Number(row.postId);
+            if (!metaByPostId.has(postId)) {
+                metaByPostId.set(postId, new Map());
+            }
+            (_a = metaByPostId.get(postId)) === null || _a === void 0 ? void 0 : _a.set(row.metaKey || '', row.metaValue || '');
+        }
+        const postDataMap = new Map(postsData.map(post => [Number(post.ID), post]));
+        return ids.map(id => {
+            const instance = new Post(id);
+            instance.postData = postDataMap.get(id);
+            instance.metaMap = metaByPostId.get(id) || new Map();
+            postLoader.prime([instance.thumbnailId]);
+            return instance;
+        });
+    }
+    get path() {
+        var _a, _b;
+        return (_b = (_a = this.metaMap) === null || _a === void 0 ? void 0 : _a.get('_nextpress_path')) !== null && _b !== void 0 ? _b : '';
+    }
+    get thumbnailId() {
+        var _a;
+        const val = (_a = this.metaMap) === null || _a === void 0 ? void 0 : _a.get('_thumbnail_id');
+        return val ? Number(val) : 0;
+    }
+    get imageAttributes() {
+        var _a;
+        if (this._imageAttributes !== undefined)
+            return this._imageAttributes;
+        if (!this.metaMap)
+            return {};
+        const alt = (_a = this.metaMap.get('_wp_attachment_image_alt')) !== null && _a !== void 0 ? _a : '';
+        const rawMetadata = this.metaMap.get('_wp_attachment_metadata');
+        if (!rawMetadata && !alt) {
+            this._imageAttributes = {};
+            return this._imageAttributes;
+        }
+        const guid = this.guid;
+        const index = guid.indexOf('/wp-content');
+        const path = index !== -1 ? guid.slice(index) : guid;
+        const srcPath = `${process.env.WP_SERVICE_URL}${path}`;
+        try {
+            const metadata = unserialize(rawMetadata !== null && rawMetadata !== void 0 ? rawMetadata : 'a:0:{}');
+            this._imageAttributes = {
+                src: srcPath,
+                alt: alt,
+                height: metadata.height ? Number(metadata.height) : undefined,
+                width: metadata.width ? Number(metadata.width) : undefined
+            };
+        }
+        catch (error) {
+            console.warn('Error while getting post: Could not unserialize php: ', error.message);
+            this._imageAttributes = {};
+        }
+        return this._imageAttributes;
+    }
+    get menuItemAttributes() {
+        var _a, _b;
+        if (this._menuItemAttributes !== undefined)
+            return this._menuItemAttributes;
+        if (!this.metaMap)
+            return null;
+        const typeMeta = this.metaMap.get('_menu_item_type');
+        const type = ['custom', 'post_type', 'taxonomy'].includes(typeMeta !== null && typeMeta !== void 0 ? typeMeta : '')
+            ? typeMeta
+            : undefined;
+        let url;
+        let objectId;
+        if (type === 'custom') {
+            const urlMeta = this.metaMap.get('_menu_item_url');
+            url = urlMeta ? processURL(urlMeta) : '';
+        }
+        else {
+            objectId = Number(this.metaMap.get('_menu_item_object_id'));
+        }
+        const parentId = (_a = Number(this.metaMap.get('_menu_item_menu_item_parent'))) !== null && _a !== void 0 ? _a : 0;
+        const label = (_b = this.postTitle) !== null && _b !== void 0 ? _b : '';
+        return {
+            label,
+            type: type !== null && type !== void 0 ? type : 'custom',
+            parentId,
+            objectId: objectId !== null && objectId !== void 0 ? objectId : 0,
+            url: url !== null && url !== void 0 ? url : ''
+        };
+    }
+    get postExcerpt() {
+        var _a, _b;
+        if (this._postExcerpt !== undefined)
+            return this._postExcerpt;
+        const excerpt = (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postExcerpt']) !== null && _b !== void 0 ? _b : '';
+        if (excerpt)
+            return excerpt;
+        const postContent = this.postContent;
+        if (!postContent)
+            return '';
+        const plainText = postContent
+            .replace(/<[^>]+>/g, ' ') // Strip HTML tags
+            .replace(/\s+/g, ' ') // Normalize multiple spaces into a single space
+            .trim();
+        const words = plainText.split(' ');
+        if (words.length > (excerptLength)) {
+            return words.slice(0, excerptLength).join(' ') + '...';
+        }
+        this._postExcerpt = plainText;
+        return this._postExcerpt;
+    }
+    get commentCount() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['commentCount']) !== null && _b !== void 0 ? _b : 0; }
+    get commentStatus() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['commentStatus']) !== null && _b !== void 0 ? _b : 'closed'; }
+    get guid() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['guid']) !== null && _b !== void 0 ? _b : ''; }
+    get menuOrder() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['menuOrder']) !== null && _b !== void 0 ? _b : 0; }
+    get pinged() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['pinged']) !== null && _b !== void 0 ? _b : ''; }
+    get pingStatus() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['pingStatus']) !== null && _b !== void 0 ? _b : 'closed'; }
+    get postAuthor() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postAuthor']) !== null && _b !== void 0 ? _b : 0; }
+    get postContent() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postContent']) !== null && _b !== void 0 ? _b : ''; }
+    get postContentFiltered() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postContentFiltered']) !== null && _b !== void 0 ? _b : ''; }
+    get postDate() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postDate']) !== null && _b !== void 0 ? _b : new Date(); }
+    get postDateGmt() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postDateGmt']) !== null && _b !== void 0 ? _b : new Date(); }
+    get postMimeType() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postMimeType']) !== null && _b !== void 0 ? _b : ''; }
+    get postModified() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postModified']) !== null && _b !== void 0 ? _b : new Date(); }
+    get postModifiedGmt() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postModifiedGmt']) !== null && _b !== void 0 ? _b : new Date(); }
+    get postName() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postName']) !== null && _b !== void 0 ? _b : ''; }
+    get postParent() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postParent']) !== null && _b !== void 0 ? _b : 0; }
+    get postPassword() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postPassword']) !== null && _b !== void 0 ? _b : ''; }
+    get postStatus() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postStatus']) !== null && _b !== void 0 ? _b : 'draft'; }
+    get postTitle() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postTitle']) !== null && _b !== void 0 ? _b : ''; }
+    get postType() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['postType']) !== null && _b !== void 0 ? _b : 'post'; }
+    get toPing() { var _a, _b; return (_b = (_a = this.postData) === null || _a === void 0 ? void 0 : _a['toPing']) !== null && _b !== void 0 ? _b : ''; }
+    async getFields(name) {
+        const meta = await wpdb
+            .selectFrom('wpPostmeta')
+            .where('metaKey', 'like', `${name}%`)
+            .where('postId', '=', this.ID)
+            .select(['metaKey', 'metaValue'])
+            .execute();
+        return meta.map(m => ({
+            key: m.metaKey || '',
+            value: m.metaValue || ''
+        }));
+    }
+}

package/dist/entities/term/term.d.ts

@@ -0,0 +1,28 @@
+import { ITerm } from "./term.interface";
+/**
+ * Implementation of ITerm entity.
+ */
+export declare class Term implements ITerm {
+    termId: number;
+    constructor(termId: number);
+    /** Raw term data from database. */
+    private termData?;
+    /** Map of term meta key-value pairs. */
+    private metaMap?;
+    /**
+     * Retrieves array of Term instances by IDs.
+     *
+     * @param {number[]} ids - Array of term IDs to retrieve.
+     * @returns {Promise<Term[]>} Promise resolving to array of Term instances.
+     */
+    static get(ids: number[]): Promise<Term[]>;
+    get path(): string;
+    get name(): string;
+    get slug(): string;
+    get termGroup(): number;
+    get parent(): number;
+    get description(): string;
+    get termTaxonomyId(): number;
+    get count(): number;
+    get taxonomy(): string;
+}

package/dist/entities/term/term.js

@@ -0,0 +1,67 @@
+import { wpdb } from "@/wpdb/wpdb";
+/**
+ * Implementation of ITerm entity.
+ */
+export class Term {
+    constructor(termId) {
+        this.termId = termId;
+    }
+    /**
+     * Retrieves array of Term instances by IDs.
+     *
+     * @param {number[]} ids - Array of term IDs to retrieve.
+     * @returns {Promise<Term[]>} Promise resolving to array of Term instances.
+     */
+    static async get(ids) {
+        var _a;
+        ids = ids.filter(Boolean);
+        if (!ids || !ids.length)
+            return [];
+        const combinedData = await wpdb
+            .selectFrom('wpTerms as term')
+            .innerJoin('wpTermTaxonomy as taxonomy', 'term.termId', 'taxonomy.termId')
+            .where('term.termId', 'in', ids)
+            .select([
+            'term.termId as termId',
+            'term.name as name',
+            'term.slug as slug',
+            'term.termGroup as termGroup',
+            'taxonomy.termTaxonomyId as termTaxonomyId',
+            'taxonomy.taxonomy as taxonomy',
+            'taxonomy.description as description',
+            'taxonomy.parent as parent',
+            'taxonomy.count as count'
+        ])
+            .execute();
+        const metaData = await wpdb
+            .selectFrom('wpTermmeta')
+            .where('termId', 'in', ids)
+            .where('metaKey', '=', '_nextpress_path')
+            .select(['termId', 'metaKey', 'metaValue'])
+            .execute();
+        const metaByTermId = new Map();
+        for (const row of metaData) {
+            const termId = Number(row.termId);
+            if (!metaByTermId.has(termId)) {
+                metaByTermId.set(termId, new Map());
+            }
+            (_a = metaByTermId.get(termId)) === null || _a === void 0 ? void 0 : _a.set(row.metaKey || '', row.metaValue || '');
+        }
+        const combinedDataMap = new Map(combinedData.map(row => [Number(row.termId), row]));
+        return ids.map(id => {
+            const instance = new Term(id);
+            instance.termData = combinedDataMap.get(id);
+            instance.metaMap = metaByTermId.get(id) || new Map();
+            return instance;
+        });
+    }
+    get path() { var _a, _b; return (_b = (_a = this.metaMap) === null || _a === void 0 ? void 0 : _a.get('_nextpress_path')) !== null && _b !== void 0 ? _b : ''; }
+    get name() { var _a, _b; return (_b = (_a = this.termData) === null || _a === void 0 ? void 0 : _a['name']) !== null && _b !== void 0 ? _b : ''; }
+    get slug() { var _a, _b; return (_b = (_a = this.termData) === null || _a === void 0 ? void 0 : _a['slug']) !== null && _b !== void 0 ? _b : ''; }
+    get termGroup() { var _a; return ((_a = this.termData) === null || _a === void 0 ? void 0 : _a['termGroup']) ? Number(this.termData['termGroup']) : 0; }
+    get parent() { var _a; return ((_a = this.termData) === null || _a === void 0 ? void 0 : _a['parent']) ? Number(this.termData['parent']) : 0; }
+    get description() { var _a, _b; return (_b = (_a = this.termData) === null || _a === void 0 ? void 0 : _a['description']) !== null && _b !== void 0 ? _b : ''; }
+    get termTaxonomyId() { var _a; return ((_a = this.termData) === null || _a === void 0 ? void 0 : _a['termTaxonomyId']) ? Number(this.termData['termTaxonomyId']) : 0; }
+    get count() { var _a; return ((_a = this.termData) === null || _a === void 0 ? void 0 : _a['count']) ? Number(this.termData['count']) : 0; }
+    get taxonomy() { var _a, _b; return (_b = (_a = this.termData) === null || _a === void 0 ? void 0 : _a['taxonomy']) !== null && _b !== void 0 ? _b : ''; }
+}

package/dist/entities/user/user.d.ts

@@ -0,0 +1,27 @@
+import { IUser } from "./user.interface";
+export declare class User implements IUser {
+    ID: number;
+    constructor(ID: number);
+    /** Raw user data from database. */
+    private userData?;
+    /** Map of user meta key-value pairs. */
+    private metaMap?;
+    /**
+     * 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 get(ids: number[]): Promise<User[]>;
+    get roles(): string[];
+    get showAdminBar(): boolean;
+    get displayName(): string;
+    get userActivationKey(): string;
+    get userEmail(): string;
+    get userLogin(): string;
+    get userNicename(): string;
+    get userPass(): string;
+    get userRegistered(): Date;
+    get userStatus(): number;
+    get userUrl(): string;
+}

package/dist/entities/user/user.js

@@ -0,0 +1,74 @@
+import { unserialize } from "php-serialize";
+import { wpdb } from "@/wpdb/wpdb";
+export class User {
+    constructor(ID) {
+        this.ID = ID;
+    }
+    /**
+     * 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) {
+        var _a;
+        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();
+        for (const row of metaData) {
+            const userId = Number(row.userId);
+            if (!metaByUserId.has(userId)) {
+                metaByUserId.set(userId, new Map());
+            }
+            (_a = metaByUserId.get(userId)) === null || _a === void 0 ? void 0 : _a.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();
+            return instance;
+        });
+    }
+    get roles() {
+        var _a;
+        const rawCapabilities = (_a = this.metaMap) === null || _a === void 0 ? void 0 : _a.get('wp_capabilities');
+        if (!rawCapabilities)
+            return [];
+        try {
+            return Object.keys(unserialize(rawCapabilities));
+        }
+        catch (error) {
+            console.warn('Error while getting user: Could not unserialize php: ', error.message);
+            return [];
+        }
+    }
+    get showAdminBar() {
+        var _a;
+        return ((_a = this.metaMap) === null || _a === void 0 ? void 0 : _a.get('show_admin_bar_front')) === 'true';
+    }
+    get displayName() { var _a, _b; return (_b = (_a = this.userData) === null || _a === void 0 ? void 0 : _a['displayName']) !== null && _b !== void 0 ? _b : ''; }
+    get userActivationKey() { var _a, _b; return (_b = (_a = this.userData) === null || _a === void 0 ? void 0 : _a['userActivationKey']) !== null && _b !== void 0 ? _b : ''; }
+    get userEmail() { var _a, _b; return (_b = (_a = this.userData) === null || _a === void 0 ? void 0 : _a['userEmail']) !== null && _b !== void 0 ? _b : ''; }
+    get userLogin() { var _a, _b; return (_b = (_a = this.userData) === null || _a === void 0 ? void 0 : _a['userLogin']) !== null && _b !== void 0 ? _b : ''; }
+    get userNicename() { var _a, _b; return (_b = (_a = this.userData) === null || _a === void 0 ? void 0 : _a['userNicename']) !== null && _b !== void 0 ? _b : ''; }
+    get userPass() { var _a, _b; return (_b = (_a = this.userData) === null || _a === void 0 ? void 0 : _a['userPass']) !== null && _b !== void 0 ? _b : ''; }
+    get userRegistered() { var _a, _b; return (_b = (_a = this.userData) === null || _a === void 0 ? void 0 : _a['userRegistered']) !== null && _b !== void 0 ? _b : new Date(); }
+    get userStatus() { var _a; return ((_a = this.userData) === null || _a === void 0 ? void 0 : _a['userStatus']) ? Number(this.userData['userStatus']) : 0; }
+    get userUrl() { var _a, _b; return (_b = (_a = this.userData) === null || _a === void 0 ? void 0 : _a['userUrl']) !== null && _b !== void 0 ? _b : ''; }
+}

package/dist/globals/entity-loader/entity-loader-base.d.ts

@@ -0,0 +1,65 @@
+import { EntityLoader, EntityQuery } from "./entity-loader";
+/**
+ * Constructor type for entity queries.
+ */
+type QueryConstructor<TArgs> = new (args: TArgs) => EntityQuery<TArgs>;
+export interface ILoaderStorage<TEntity> {
+    loadQueue: Set<number>;
+    entityCache: Map<number, TEntity>;
+    promisedEntities: Map<number, Promise<TEntity[]>>;
+}
+export declare abstract class EntityLoaderBase<TEntity, TArgs> implements EntityLoader<TEntity, TArgs> {
+    /** Query class used to fetch entity IDs. */
+    protected abstract queryClass: QueryConstructor<TArgs>;
+    /**
+     * Fetches entities from the database by ID.
+     *
+     * @param {number[]} ids Array of entity IDs.
+     *
+     * @returns {Promise<TEntity[]>} Array of fetched entities.
+     * @throws {Error} If database fetch fails.
+     */
+    protected abstract fetchFromDatabase(ids: number[]): Promise<TEntity[]>;
+    /**
+     * Gets the ID of an entity.
+     *
+     * @param {TEntity} entity The entity.
+     *
+     * @returns {number} The entity ID.
+     */
+    protected abstract getEntityId(entity: TEntity): number;
+    /**
+     * Retrieves the local state for the loader from the global cache.
+     *
+     * @returns {ILoaderStorage<TEntity>} The loader storage.
+     */
+    private getLocalState;
+    /**
+     * Adds IDs to the loading queue.
+     *
+     * @param {number[]} ids Array of IDs to prime.
+     */
+    prime(ids: number[]): void;
+    /**
+     * Finds entity IDs matching the arguments and queues them for loading.
+     *
+     * @param {TArgs} args Query arguments.
+     *
+     * @returns {Promise<{ ids: number[]; count: number }>} Matching IDs and total count.
+     * @throws {Error} If query execution fails.
+     */
+    findAndPrime(args: TArgs): Promise<{
+        ids: number[];
+        count: number;
+    }>;
+    /**
+     * Retrieves entities by ID.
+     *
+     * @param {number[]} ids Array of entity IDs.
+     *
+     * @returns {Promise<TEntity[]>} Array of entities.
+     * @throws {Error} If entity fetching fails.
+     */
+    get(ids: number[]): Promise<TEntity[]>;
+}
+export {};

package/{lib/globals/entity-loader/entity-loader-base.ts → dist/globals/entity-loader/entity-loader-base.js}

@@ -1,50 +1,13 @@
-import { EntityLoader, EntityQuery } from "./entity-loader";
 import { queriedObjectState } from "../globals";
-
-/**
- * Constructor type for entity queries.
- */
-type QueryConstructor<TArgs> = new (args: TArgs) => EntityQuery<TArgs>;
-
-export interface ILoaderStorage<TEntity> {
-    loadQueue: Set<number>;
-    entityCache: Map<number, TEntity>;
-    promisedEntities: Map<number, Promise<TEntity[]>>;
-}
-
-export abstract class EntityLoaderBase<TEntity, TArgs> implements EntityLoader<TEntity, TArgs>
-{
-    /** Query class used to fetch entity IDs. */
-    protected abstract queryClass: QueryConstructor<TArgs>;
-
-    /**
-     * Fetches entities from the database by ID.
-     *
-     * @param {number[]} ids Array of entity IDs.
-     *
-     * @returns {Promise<TEntity[]>} Array of fetched entities.
-     * @throws {Error} If database fetch fails.
-     */
-    protected abstract fetchFromDatabase(ids: number[]): Promise<TEntity[]>;
-
-    /**
-     * Gets the ID of an entity.
-     *
-     * @param {TEntity} entity The entity.
-     *
-     * @returns {number} The entity ID.
-     */
-    protected abstract getEntityId(entity: TEntity): number;
-
+export class EntityLoaderBase {
     /**
      * Retrieves the local state for the loader from the global cache.
      *
      * @returns {ILoaderStorage<TEntity>} The loader storage.
      */
-    private getLocalState(): ILoaderStorage<TEntity> {
+    getLocalState() {
         const state = queriedObjectState();
         const loaderKey = `__loader_${this.constructor.name}`;
-
         if (!state.loaderStates[loaderKey]) {
             state.loaderStates[loaderKey] = {
                 loadQueue: new Set(),
@@ -54,13 +17,12 @@ export abstract class EntityLoaderBase<TEntity, TArgs> implements EntityLoader<T
         }
         return state.loaderStates[loaderKey];
     }
-
     /**
      * Adds IDs to the loading queue.
      *
      * @param {number[]} ids Array of IDs to prime.
      */
-    public prime(ids: number[]): void {
+    prime(ids) {
         const state = this.getLocalState();
         for (const id of ids) {
             if (state.loadQueue.has(id) || state.entityCache.has(id) || state.promisedEntities.has(id)) {
@@ -69,7 +31,6 @@ export abstract class EntityLoaderBase<TEntity, TArgs> implements EntityLoader<T
             state.loadQueue.add(id);
         }
     }
-
     /**
      * Finds entity IDs matching the arguments and queues them for loading.
      *
@@ -78,17 +39,14 @@ export abstract class EntityLoaderBase<TEntity, TArgs> implements EntityLoader<T
      * @returns {Promise<{ ids: number[]; count: number }>} Matching IDs and total count.
      * @throws {Error} If query execution fails.
      */
-    public async findAndPrime(args: TArgs): Promise<{ ids: number[]; count: number }> {
+    async findAndPrime(args) {
+        var _a;
         const query = new this.queryClass(args);
-
         const ids = await query.getIds();
-        const count = query.getCount() ?? ids.length;
-
+        const count = (_a = query.getCount()) !== null && _a !== void 0 ? _a : ids.length;
         this.get(ids);
-
         return { ids, count };
     }
-
     /**
      * Retrieves entities by ID.
      *
@@ -97,42 +55,30 @@ export abstract class EntityLoaderBase<TEntity, TArgs> implements EntityLoader<T
      * @returns {Promise<TEntity[]>} Array of entities.
      * @throws {Error} If entity fetching fails.
      */
-    public async get(ids: number[]): Promise<TEntity[]> {
+    async get(ids) {
         const state = this.getLocalState();
-
         const newIds = ids.filter(id => !state.entityCache.has(id) && !state.promisedEntities.has(id));
-
         if (newIds.length > 0) {
             this.prime(newIds);
         }
-
         if (state.loadQueue.size > 0) {
             const queue = Array.from(state.loadQueue);
             state.loadQueue.clear();
-
             const fetchPromise = this.fetchFromDatabase(queue).then(queuedEntities => {
                 queuedEntities.forEach(entity => state.entityCache.set(this.getEntityId(entity), entity));
                 queue.forEach(id => state.promisedEntities.delete(id));
                 return queuedEntities;
             });
-
             queue.forEach(id => {
                 state.promisedEntities.set(id, fetchPromise);
             });
         }
-
-        const activePromises = Array.from(
-            new Set(
-                ids
-                    .map(id => state.promisedEntities.get(id))
-                    .filter((p): p is Promise<TEntity[]> => !!p)
-            )
-        );
-
+        const activePromises = Array.from(new Set(ids
+            .map(id => state.promisedEntities.get(id))
+            .filter((p) => !!p)));
         if (activePromises.length > 0) {
             await Promise.all(activePromises);
         }
-
         return ids.flatMap(id => {
             const entity = state.entityCache.get(id);
             return entity ? [entity] : [];

package/dist/globals/entity-loader/option-loader.d.ts

@@ -0,0 +1,15 @@
+import { IOption } from "../../entities/option/option.interface";
+import { OptionQueryArgs } from "../../repository/optionquery/option-query-args";
+import { EntityLoader } from "./entity-loader";
+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>;
+}

package/dist/globals/entity-loader/option-loader.js

@@ -0,0 +1,31 @@
+import { OptionQuery } from "@/repository/optionquery/option-query";
+import { Option } from "../../entities/option/option";
+import { EntityLoaderBase } from "./entity-loader-base";
+class OptionLoader extends EntityLoaderBase {
+    constructor() {
+        super();
+        this.queryClass = OptionQuery;
+    }
+    static instance() {
+        if (!this._instance) {
+            this._instance = new OptionLoader();
+        }
+        return this._instance;
+    }
+    async fetchFromDatabase(ids) {
+        return await Option.get(ids);
+    }
+    getEntityId(option) {
+        return option.optionId;
+    }
+}
+globalThis.optionLoader = OptionLoader.instance();
+globalThis.getOption = async (name) => {
+    var _a;
+    const foundOptions = await optionLoader.findAndPrime({
+        column: 'optionName',
+        operand: '=',
+        value: name
+    });
+    return (_a = (await optionLoader.get(foundOptions.ids))[0]) === null || _a === void 0 ? void 0 : _a.optionValue;
+};

package/dist/globals/entity-loader/post-loader.d.ts

@@ -0,0 +1,21 @@
+import { IPost } from "../../entities/post/post.interface";
+import { EntityLoader } from "./entity-loader";
+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>;
+}
+export {};