nextpress-core 1.0.0 → 1.0.1

package/{lib/acf-functions/services/map-fields/map-fields.ts → dist/acf-functions/services/map-fields/map-fields.js}

@@ -1,21 +1,18 @@
 import { unserialize } from "php-serialize";
 import { acfComponentAutoloader } from "../../core/acf-component-autoloader";
-import { ACFGoogleMapsObject, ACFIconObject, ACFLinkObject } from "@/acf-functions/types/components/field-props";
 import { mapChoiceObject } from "./helpers/map-choice-object";
 import { processURL } from "@/services/utilities/process-url";
-
 const components = await acfComponentAutoloader();
-
 /**
  * Parses PHP serialized string into JavaScript object or array.
  *
  * @param {string} [string] - PHP serialized string.
  * @returns {unknown[] | { [key: string]: unknown }} Parsed object or array.
  */
-function parsePhp(string?: string): unknown[] | { [key: string]: unknown } {
-    return unserialize(string ?? 'a:0:{}') ?? [];
+function parsePhp(string) {
+    var _a;
+    return (_a = unserialize(string !== null && string !== void 0 ? string : 'a:0:{}')) !== null && _a !== void 0 ? _a : [];
 }
-
 /**
  * Gets array of object IDs from string value.
  *
@@ -23,17 +20,18 @@ function parsePhp(string?: string): unknown[] | { [key: string]: unknown } {
  * @param {boolean} multiple - Indicates if multiple IDs are expected.
  * @returns {number[]} Array of parsed object IDs.
  */
-function getObjectIDs(value: string, multiple: boolean): number[] {
+function getObjectIDs(value, multiple) {
+    var _a;
     if (multiple) {
         const postValueArray = parsePhp(value);
-        if (!Array.isArray(postValueArray)) return [];
-
+        if (!Array.isArray(postValueArray))
+            return [];
         return postValueArray.map(Number).filter(Boolean);
-    } else {
-        return [Number(value) ?? 0]
+    }
+    else {
+        return [(_a = Number(value)) !== null && _a !== void 0 ? _a : 0];
     }
 }
-
 /**
  * Maps individual ACF field to corresponding value.
  *
@@ -41,12 +39,13 @@ function getObjectIDs(value: string, multiple: boolean): number[] {
  * @param {ACFRawValues} rawValues - Raw values map.
  * @returns {Promise<any>} Promise resolving to mapped value.
  */
-export async function mapField(field: NextpressField, rawValues: ACFRawValues): Promise<any> {
+export async function mapField(field, rawValues) {
+    var _a, _b, _c, _d, _e, _f;
     /**
      * Basic scalar values and strings.
      * These are stored as simple strings in the database and require no complex parsing.
     */
-    switch (field.type){
+    switch (field.type) {
         case 'color_picker':
         case 'date_picker':
         case 'date_time_picker':
@@ -60,7 +59,6 @@ export async function mapField(field: NextpressField, rawValues: ACFRawValues):
         case 'file':
         case 'image':
             return rawValues.get(field.name);
-
         /**
          * Numeric fields.
          * Casts the raw string from the database into a strict JavaScript Number.
@@ -68,64 +66,58 @@ export async function mapField(field: NextpressField, rawValues: ACFRawValues):
         case 'number':
         case 'range':
             return Number(rawValues.get(field.name));
-
         /**
          * True/False boolean field.
          * Converts the truthy/falsy raw string/number into a strict JavaScript boolean.
          */
         case 'true_false':
             return !!rawValues.get(field.name);
-
         /**
          * Google Map field.
          * Deserializes the PHP array containing map data (address, lat, lng) into a structured object.
          */
         case 'google_map':
             const mapValue = parsePhp(rawValues.get(field.name));
-            if (Array.isArray(mapValue)) return;
-
-            const mapObject: ACFGoogleMapsObject = mapValue as ACFGoogleMapsObject;
+            if (Array.isArray(mapValue))
+                return;
+            const mapObject = mapValue;
             return mapObject;
-
         /**
          * Icon Picker field.
          * Deserializes the PHP array and respects the return format (either a raw string class or an object).
          */
         case 'icon_picker':
             const iconValue = parsePhp(rawValues.get(field.name));
-            if (Array.isArray(iconValue)) return;
-
-            const iconObject: ACFIconObject = iconValue as ACFIconObject;
+            if (Array.isArray(iconValue))
+                return;
+            const iconObject = iconValue;
             if (field.return_format === 'string') {
                 return iconObject.value;
-            } else {
+            }
+            else {
                 return iconObject;
             }
-
         /**
          * Button Group field.
          * Maps the selected choice value to its corresponding label/array using the choice map.
          */
         case 'button_group':
-            return mapChoiceObject(field.return_format ?? 'value', rawValues.get(field.name));
-
+            return mapChoiceObject((_a = field.return_format) !== null && _a !== void 0 ? _a : 'value', rawValues.get(field.name));
         /**
          * Checkbox field.
          * Deserializes the array of selected options and maps each one to the requested return format.
          */
         case 'checkbox':
             const checkBoxValues = parsePhp(rawValues.get(field.name));
-            if (!Array.isArray(checkBoxValues)) return;
-
-            return checkBoxValues.map(value => mapChoiceObject(field.return_format ?? 'value', typeof value === 'string' ? value : undefined, field.choices));
-
+            if (!Array.isArray(checkBoxValues))
+                return;
+            return checkBoxValues.map(value => { var _a; return mapChoiceObject((_a = field.return_format) !== null && _a !== void 0 ? _a : 'value', typeof value === 'string' ? value : undefined, field.choices); });
         /**
          * Radio field.
          * Maps a single selected choice using the field's available choices.
          */
         case 'radio':
-            return mapChoiceObject(field.return_format ?? 'value', rawValues.get(field.name), field.choices);
-
+            return mapChoiceObject((_b = field.return_format) !== null && _b !== void 0 ? _b : 'value', rawValues.get(field.name), field.choices);
         /**
          * Select field.
          * Handles both multi-select (deserializes array) and single-select (processes raw string),
@@ -134,23 +126,22 @@ export async function mapField(field: NextpressField, rawValues: ACFRawValues):
         case 'select':
             if (field.multiple === 1) {
                 const selectValues = parsePhp(rawValues.get(field.name));
-                if (!Array.isArray(selectValues)) return;
-
-                return selectValues.map(value => mapChoiceObject(field.return_format ?? 'value', typeof value === 'string' ? value : undefined, field.choices));
-            } else {
-                return mapChoiceObject(field.return_format ?? 'value', rawValues.get(field.name), field.choices);
+                if (!Array.isArray(selectValues))
+                    return;
+                return selectValues.map(value => { var _a; return mapChoiceObject((_a = field.return_format) !== null && _a !== void 0 ? _a : 'value', typeof value === 'string' ? value : undefined, field.choices); });
+            }
+            else {
+                return mapChoiceObject((_c = field.return_format) !== null && _c !== void 0 ? _c : 'value', rawValues.get(field.name), field.choices);
             }
-
         /**
          * Gallery field.
          * Deserializes the PHP array of image IDs or objects.
          */
         case 'gallery':
             const galleryValues = parsePhp(rawValues.get(field.name));
-            if (!Array.isArray(galleryValues)) return;
-
+            if (!Array.isArray(galleryValues))
+                return;
             return galleryValues;
-
         /**
          * Flexible Content field.
          * Iterates over saved layout names, extracts the relevant prefixed sub-fields for each block,
@@ -158,50 +149,38 @@ export async function mapField(field: NextpressField, rawValues: ACFRawValues):
          */
         case 'flexible_content':
             const layoutValues = parsePhp(rawValues.get(field.name));
-            if (!Array.isArray(layoutValues)) return;
-
+            if (!Array.isArray(layoutValues))
+                return;
             const layouts = field.layouts;
             const fcRawEntries = Array.from(rawValues.entries());
-
             const promises = layoutValues.map(async (layoutValue, index) => {
-                const layout = layouts?.find(layout => layout.name === layoutValue);
-
+                const layout = layouts === null || layouts === void 0 ? void 0 : layouts.find(layout => layout.name === layoutValue);
                 const prefix = `${field.name}_${index}_`;
                 const prefixLength = prefix.length;
-
-                const component = components.find(comp => comp.layout.name === layout?.name);
-
+                const component = components.find(comp => comp.layout.name === (layout === null || layout === void 0 ? void 0 : layout.name));
                 const subFieldEntries = fcRawEntries
                     .filter(([key]) => key.startsWith(prefix))
-                    .map(([key, value]) => [key.slice(prefixLength), value] as [string, any]);
-
-                const flexibleValues = new Map<string, any>(subFieldEntries);
-
-                const resolvedValues = await mapLayout(layout as any, flexibleValues);
-
+                    .map(([key, value]) => [key.slice(prefixLength), value]);
+                const flexibleValues = new Map(subFieldEntries);
+                const resolvedValues = await mapLayout(layout, flexibleValues);
                 return {
-                    Component: component?.Component,
+                    Component: component === null || component === void 0 ? void 0 : component.Component,
                     content: resolvedValues
                 };
             });
-
             return Promise.all(promises);
-
         /**
          * Group field.
          * Strips the parent group prefix from the database keys and recursively maps the internal sub-fields.
          */
         case 'group':
-            const groupValues = new Map(
-                [...rawValues.entries()]
-                    .filter(([key]) => key.startsWith(field.name) && key !== field.name)
-                    .map(([key, value]) => {
-                        const newKey = key.replace(`${field.name}_`, '');
-                        return [newKey, value];
-                    })
-            );
-            return await mapLayout(field as any, groupValues);
-
+            const groupValues = new Map([...rawValues.entries()]
+                .filter(([key]) => key.startsWith(field.name) && key !== field.name)
+                .map(([key, value]) => {
+                const newKey = key.replace(`${field.name}_`, '');
+                return [newKey, value];
+            }));
+            return await mapLayout(field, groupValues);
         /**
          * Repeater field.
          * Gets the total repeat count, then iterates to extract prefixed sub-fields for each row,
@@ -210,44 +189,36 @@ export async function mapField(field: NextpressField, rawValues: ACFRawValues):
         case 'repeater':
             const repeaterRepeats = Number(rawValues.get(field.name)) || 0;
             const repeaterResults = [];
-
             const rRawEntries = Array.from(rawValues.entries());
-
             for (let index = 0; index < repeaterRepeats; index++) {
                 const prefix = `${field.name}_${index}_`;
                 const prefixLength = prefix.length;
-
                 const subFieldEntries = rRawEntries
                     .filter(([key]) => key.startsWith(prefix))
-                    .map(([key, value]) => [key.slice(prefixLength), value] as [string, any]);
-
-                const repeatValues = new Map<string, any>(subFieldEntries);
-
-                repeaterResults.push(mapLayout(field as any, repeatValues));
+                    .map(([key, value]) => [key.slice(prefixLength), value]);
+                const repeatValues = new Map(subFieldEntries);
+                repeaterResults.push(mapLayout(field, repeatValues));
             }
-
             return Promise.all(repeaterResults);
-
         /**
          * Link field.
          * Deserializes link properties (title, url, target) and returns either the raw URL string or a structured object.
          */
         case 'link':
             const linkValue = parsePhp(rawValues.get(field.name));
-            if (Array.isArray(linkValue)) return;
-
-            const linkObject: ACFLinkObject = {
+            if (Array.isArray(linkValue))
+                return;
+            const linkObject = {
                 title: typeof linkValue.title === 'string' ? linkValue.title : '',
                 url: typeof linkValue.url === 'string' ? processURL(linkValue.url) : '',
                 target: typeof linkValue.target === 'string' ? linkValue.target : '',
-            }
-
+            };
             if (field.return_format === 'url') {
                 return linkObject.url;
-            } else {
-                return linkObject
             }
-
+            else {
+                return linkObject;
+            }
         /**
          * Page Link field.
          * Retrieves internal post paths dynamically based on post ID, or falls back to standard external URLs.
@@ -255,88 +226,82 @@ export async function mapField(field: NextpressField, rawValues: ACFRawValues):
         case 'page_link':
             if (field.multiple == 1) {
                 const pageLinkValue = parsePhp(rawValues.get(field.name));
-                if (!Array.isArray(pageLinkValue)) return;
+                if (!Array.isArray(pageLinkValue))
+                    return;
                 const pageLinkIds = pageLinkValue.map(Number).filter(Boolean);
-
                 const posts = await getPosts(pageLinkIds);
                 const postPaths = new Map(posts.map(post => [post.ID, post.path]));
-
-                return pageLinkValue.map(page => postPaths.has(Number(page)) ? postPaths.get(Number(page)) : processURL(page as string));
-            } else {
+                return pageLinkValue.map(page => postPaths.has(Number(page)) ? postPaths.get(Number(page)) : processURL(page));
+            }
+            else {
                 const pageLinkValue = rawValues.get(field.name);
                 const pageLinkId = Number(rawValues.get(field.name));
-                if (!pageLinkValue) return;
-
-                return pageLinkId ? (await getPost(pageLinkId))?.path : processURL(pageLinkValue);
+                if (!pageLinkValue)
+                    return;
+                return pageLinkId ? (_d = (await getPost(pageLinkId))) === null || _d === void 0 ? void 0 : _d.path : processURL(pageLinkValue);
             }
-
         /**
          * Post Object field.
          * Returns either the raw Post IDs or uses the Entity Loader to fetch and return the complete post models.
          */
         case 'post_object':
-            const postObjectIds: number[] = getObjectIDs(rawValues.get(field.name) ?? '', !!field.multiple)
-
+            const postObjectIds = getObjectIDs((_e = rawValues.get(field.name)) !== null && _e !== void 0 ? _e : '', !!field.multiple);
             if (field.return_format === 'id') {
                 return field.multiple ? postObjectIds : postObjectIds[0];
-            } else {
+            }
+            else {
                 postLoader.prime(postObjectIds);
                 const posts = await Promise.all(postObjectIds.map(id => getPost(id)));
                 return field.multiple ? posts : posts[0];
             }
-
         /**
          * Relationship field.
          * Extracts multiple selected IDs from a PHP array, returning them directly or fetching the associated post models.
          */
         case 'relationship':
             const relationshipArray = parsePhp(rawValues.get(field.name));
-            if (!Array.isArray(relationshipArray)) return [];
-
+            if (!Array.isArray(relationshipArray))
+                return [];
             const relationshipIds = relationshipArray.map(Number).filter(Boolean);
-
             if (field.return_format === 'id') {
                 return relationshipIds;
-            } {
+            }
+            {
                 postLoader.prime(relationshipIds);
                 return await Promise.all(relationshipIds.map(id => getPost(id)));
             }
-
         /**
          * Taxonomy field.
          * Parses selected Term IDs and optionally fetches the complete taxonomy Term objects from the database.
          */
         case 'taxonomy':
-            const termObjectIds = parsePhp(rawValues.get(field.name))
-            if (!Array.isArray(termObjectIds)) return [];
-
+            const termObjectIds = parsePhp(rawValues.get(field.name));
+            if (!Array.isArray(termObjectIds))
+                return [];
             const termIds = termObjectIds.map(Number).filter(Boolean);
-
             if (field.return_format === 'id') {
                 return field.multiple ? termIds : termIds[0];
-            } else {
+            }
+            else {
                 const terms = await Promise.all(termIds.map(id => getTerm(id)));
                 return field.multiple ? terms : terms[0];
             }
-
         /**
          * User field.
          * Extracts User IDs and returns either the raw IDs or fetches and returns the full User entity objects.
          */
         case 'user':
-            const userObjectIds: number[] = getObjectIDs(rawValues.get(field.name) ?? '', !!field.multiple)
-
+            const userObjectIds = getObjectIDs((_f = rawValues.get(field.name)) !== null && _f !== void 0 ? _f : '', !!field.multiple);
             if (field.return_format === 'id') {
                 return field.multiple ? userObjectIds : userObjectIds[0];
-            } else {
+            }
+            else {
                 const users = await Promise.all(userObjectIds.map(id => getUser(id)));
                 return field.multiple ? users : users[0];
             }
-        }
-
+    }
     return undefined;
 }
-
 /**
  * Maps layout configuration to values object.
  *
@@ -344,16 +309,15 @@ export async function mapField(field: NextpressField, rawValues: ACFRawValues):
  * @param {ACFRawValues} rawValues - Raw values map.
  * @returns {Promise<{ [key: string]: any }>} Promise resolving to layout values object.
  */
-export async function mapLayout(layout: NextpressLayout, rawValues: ACFRawValues)  {
-    const values: { [key: string]: any } = {};
-
+export async function mapLayout(layout, rawValues) {
+    const values = {};
     for (const subField of layout.sub_fields) {
         try {
-            values[subField.name] = await mapField(subField, rawValues)
-        } catch (error: any) {
+            values[subField.name] = await mapField(subField, rawValues);
+        }
+        catch (error) {
             console.warn('Failed to map sub field: ', subField.name, error.message);
         }
     }
-
     return values;
 }

package/dist/entities/option/option.d.ts

@@ -0,0 +1,19 @@
+import { IOption } from "./option.interface";
+/**
+ * Implementation of IOption entity.
+ */
+export declare class Option implements IOption {
+    optionId: number;
+    constructor(optionId: number);
+    /** Raw option data from database. */
+    private optionData?;
+    /**
+     * Retrieves array of Option instances by IDs.
+     *
+     * @param {number[]} ids - Array of option IDs to retrieve.
+     * @returns {Promise<Option[]>} Promise resolving to array of Option instances.
+     */
+    static get(ids: number[]): Promise<Option[]>;
+    get optionName(): string;
+    get optionValue(): string;
+}

package/{lib/entities/option/option.ts → dist/entities/option/option.js}

@@ -1,43 +1,36 @@
 import { wpdb } from "@/wpdb/wpdb";
-import { IOption } from "./option.interface";
-
 /**
  * Implementation of IOption entity.
  */
-export class Option implements IOption
-{
-    constructor(public optionId: number) {};
-
-    /** Raw option data from database. */
-    private optionData?: Record<string, any>;
-
+export class Option {
+    constructor(optionId) {
+        this.optionId = optionId;
+    }
+    ;
     /**
      * Retrieves array of Option instances by IDs.
      *
      * @param {number[]} ids - Array of option IDs to retrieve.
      * @returns {Promise<Option[]>} Promise resolving to array of Option instances.
      */
-    static async get(ids: number[]): Promise<Option[]> {
+    static async get(ids) {
         ids = ids.filter(Boolean);
-        if (!ids || !ids.length) return [];
-
+        if (!ids || !ids.length)
+            return [];
         const optionData = await wpdb
             .selectFrom('wpOptions')
             .where('optionId', 'in', ids)
             .select(['optionId', 'optionName', 'optionValue'])
             .execute();
-
         const optionDataMap = new Map(optionData.map(option => [Number(option.optionId), option]));
-
         return ids.map(id => {
             const instance = new Option(id);
-
             instance.optionData = optionDataMap.get(id);
-
             return instance;
-        })
+        });
     }
-
-    get optionName(): string { return this.optionData?.['optionName'] ?? ''};
-    get optionValue(): string { return this.optionData?.['optionValue'] ?? ''};
+    get optionName() { var _a, _b; return (_b = (_a = this.optionData) === null || _a === void 0 ? void 0 : _a['optionName']) !== null && _b !== void 0 ? _b : ''; }
+    ;
+    get optionValue() { var _a, _b; return (_b = (_a = this.optionData) === null || _a === void 0 ? void 0 : _a['optionValue']) !== null && _b !== void 0 ? _b : ''; }
+    ;
 }

package/dist/entities/post/post.d.ts

@@ -0,0 +1,50 @@
+import { Fields } from "../common";
+import { IPost, PostImageAttributes, MenuItemAttributes } from "./post.interface";
+/**
+ * Implementation of IPost entity.
+ */
+export declare class Post implements IPost {
+    ID: number;
+    constructor(ID: number);
+    /** Raw post data from database. */
+    private postData?;
+    /** Map of post meta key-value pairs. */
+    private metaMap?;
+    /**
+     * 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 get(ids: number[]): Promise<Post[]>;
+    get path(): string;
+    get thumbnailId(): number;
+    private _imageAttributes?;
+    get imageAttributes(): PostImageAttributes;
+    private _menuItemAttributes?;
+    get menuItemAttributes(): MenuItemAttributes | null;
+    private _postExcerpt?;
+    get postExcerpt(): string;
+    get commentCount(): number;
+    get commentStatus(): string;
+    get guid(): string;
+    get menuOrder(): number;
+    get pinged(): string;
+    get pingStatus(): string;
+    get postAuthor(): number;
+    get postContent(): string;
+    get postContentFiltered(): string;
+    get postDate(): Date;
+    get postDateGmt(): Date;
+    get postMimeType(): string;
+    get postModified(): Date;
+    get postModifiedGmt(): Date;
+    get postName(): string;
+    get postParent(): number;
+    get postPassword(): string;
+    get postStatus(): string;
+    get postTitle(): string;
+    get postType(): string;
+    get toPing(): string;
+    getFields(name: string): Promise<Fields>;
+}