nextpress-core 1.1.0 → 2.0.0

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

@@ -1,18 +1,24 @@
 import { unserialize } from "php-serialize";
 import { acfComponentAutoloader } from "../../core/acf-component-autoloader";
+import { ACFGoogleMapsObject, ACFIconObject, ACFLinkObject } from "nextpress/acf-functions/types/components/field-props";
+import { NextpressField } from "nextpress/acf-functions/types/acf-field";
+import { NextpressLayout } from "nextpress/acf-functions/types/acf-layout";
+import { ACFRawValues } from "nextpress/acf-functions/types/acf-values";
 import { mapChoiceObject } from "./helpers/map-choice-object";
-import { processURL } from "@/services/utilities/process-url";
+import { processURL } from "nextpress/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) {
-    var _a;
-    return (_a = unserialize(string !== null && string !== void 0 ? string : 'a:0:{}')) !== null && _a !== void 0 ? _a : [];
+function parsePhp(string?: string): unknown[] | { [key: string]: unknown } {
+    return unserialize(string ?? 'a:0:{}') ?? [];
 }
+
 /**
  * Gets array of object IDs from string value.
  *
@@ -20,18 +26,17 @@ function parsePhp(string) {
  * @param {boolean} multiple - Indicates if multiple IDs are expected.
  * @returns {number[]} Array of parsed object IDs.
  */
-function getObjectIDs(value, multiple) {
-    var _a;
+function getObjectIDs(value: string, multiple: boolean): number[] {
     if (multiple) {
         const postValueArray = parsePhp(value);
-        if (!Array.isArray(postValueArray))
-            return [];
+        if (!Array.isArray(postValueArray)) return [];
+
         return postValueArray.map(Number).filter(Boolean);
-    }
-    else {
-        return [(_a = Number(value)) !== null && _a !== void 0 ? _a : 0];
+    } else {
+        return [Number(value) ?? 0]
     }
 }
+
 /**
  * Maps individual ACF field to corresponding value.
  *
@@ -39,13 +44,12 @@ function getObjectIDs(value, multiple) {
  * @param {ACFRawValues} rawValues - Raw values map.
  * @returns {Promise<any>} Promise resolving to mapped value.
  */
-export async function mapField(field, rawValues) {
-    var _a, _b, _c, _d, _e, _f;
+export async function mapField(field: NextpressField, rawValues: ACFRawValues): Promise<any> {
     /**
      * 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':
@@ -59,6 +63,7 @@ export async function mapField(field, rawValues) {
         case 'file':
         case 'image':
             return rawValues.get(field.name);
+
         /**
          * Numeric fields.
          * Casts the raw string from the database into a strict JavaScript Number.
@@ -66,58 +71,64 @@ export async function mapField(field, rawValues) {
         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 = mapValue;
+            if (Array.isArray(mapValue)) return;
+
+            const mapObject: ACFGoogleMapsObject = mapValue as ACFGoogleMapsObject;
             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 = iconValue;
+            if (Array.isArray(iconValue)) return;
+
+            const iconObject: ACFIconObject = iconValue as ACFIconObject;
             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((_a = field.return_format) !== null && _a !== void 0 ? _a : 'value', rawValues.get(field.name));
+            return mapChoiceObject(field.return_format ?? '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 => { var _a; return mapChoiceObject((_a = field.return_format) !== null && _a !== void 0 ? _a : 'value', typeof value === 'string' ? value : undefined, field.choices); });
+            if (!Array.isArray(checkBoxValues)) return;
+
+            return checkBoxValues.map(value => mapChoiceObject(field.return_format ?? '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((_b = field.return_format) !== null && _b !== void 0 ? _b : 'value', rawValues.get(field.name), field.choices);
+            return mapChoiceObject(field.return_format ?? 'value', rawValues.get(field.name), field.choices);
+
         /**
          * Select field.
          * Handles both multi-select (deserializes array) and single-select (processes raw string),
@@ -126,22 +137,23 @@ export async function mapField(field, rawValues) {
         case 'select':
             if (field.multiple === 1) {
                 const selectValues = parsePhp(rawValues.get(field.name));
-                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);
+                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);
             }
+
         /**
          * 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,
@@ -149,38 +161,50 @@ export async function mapField(field, rawValues) {
          */
         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 === null || layouts === void 0 ? void 0 : layouts.find(layout => layout.name === layoutValue);
+                const layout = layouts?.find(layout => layout.name === layoutValue);
+
                 const prefix = `${field.name}_${index}_`;
                 const prefixLength = prefix.length;
-                const component = components.find(comp => comp.layout.name === (layout === null || layout === void 0 ? void 0 : layout.name));
+
+                const component = components.find(comp => comp.layout.name === layout?.name);
+
                 const subFieldEntries = fcRawEntries
                     .filter(([key]) => key.startsWith(prefix))
-                    .map(([key, value]) => [key.slice(prefixLength), value]);
-                const flexibleValues = new Map(subFieldEntries);
-                const resolvedValues = await mapLayout(layout, flexibleValues);
+                    .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);
+
                 return {
-                    Component: component === null || component === void 0 ? void 0 : component.Component,
+                    Component: 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, 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 as any, groupValues);
+
         /**
          * Repeater field.
          * Gets the total repeat count, then iterates to extract prefixed sub-fields for each row,
@@ -189,36 +213,44 @@ export async function mapField(field, rawValues) {
         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]);
-                const repeatValues = new Map(subFieldEntries);
-                repeaterResults.push(mapLayout(field, repeatValues));
+                    .map(([key, value]) => [key.slice(prefixLength), value] as [string, any]);
+
+                const repeatValues = new Map<string, any>(subFieldEntries);
+
+                repeaterResults.push(mapLayout(field as any, 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 = {
+            if (Array.isArray(linkValue)) return;
+
+            const linkObject: ACFLinkObject = {
                 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.
@@ -226,82 +258,88 @@ export async function mapField(field, rawValues) {
         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));
-            }
-            else {
+
+                return pageLinkValue.map(page => postPaths.has(Number(page)) ? postPaths.get(Number(page)) : processURL(page as string));
+            } else {
                 const pageLinkValue = rawValues.get(field.name);
                 const pageLinkId = Number(rawValues.get(field.name));
-                if (!pageLinkValue)
-                    return;
-                return pageLinkId ? (_d = (await getPost(pageLinkId))) === null || _d === void 0 ? void 0 : _d.path : processURL(pageLinkValue);
+                if (!pageLinkValue) return;
+
+                return pageLinkId ? (await getPost(pageLinkId))?.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 = getObjectIDs((_e = rawValues.get(field.name)) !== null && _e !== void 0 ? _e : '', !!field.multiple);
+            const postObjectIds: number[] = getObjectIDs(rawValues.get(field.name) ?? '', !!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 = getObjectIDs((_f = rawValues.get(field.name)) !== null && _f !== void 0 ? _f : '', !!field.multiple);
+            const userObjectIds: number[] = getObjectIDs(rawValues.get(field.name) ?? '', !!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.
  *
@@ -309,15 +347,16 @@ export async function mapField(field, rawValues) {
  * @param {ACFRawValues} rawValues - Raw values map.
  * @returns {Promise<{ [key: string]: any }>} Promise resolving to layout values object.
  */
-export async function mapLayout(layout, rawValues) {
-    const values = {};
+export async function mapLayout(layout: NextpressLayout, rawValues: ACFRawValues)  {
+    const values: { [key: string]: any } = {};
+
     for (const subField of layout.sub_fields) {
         try {
-            values[subField.name] = await mapField(subField, rawValues);
-        }
-        catch (error) {
+            values[subField.name] = await mapField(subField, rawValues)
+        } catch (error: any) {
             console.warn('Failed to map sub field: ', subField.name, error.message);
         }
     }
+
     return values;
 }

package/{dist/acf-functions/types/acf-field-group.d.ts → lib/acf-functions/types/acf-field-group.ts}

@@ -1,9 +1,13 @@
 import { NextpressField, ACFField } from "./acf-field";
-type TransformACFFieldGroup<T> = T extends any ? Omit<T, 'key' | 'fields'> & ('fields' extends keyof T ? {
-    fields: NextpressField[];
-} : []) : never;
+
+type TransformACFFieldGroup<T> = T extends any
+    ? Omit<T, 'key' | 'fields'> &
+        ('fields' extends keyof T ? { fields: NextpressField[] } : [])
+    : never;
+
 /** ACF Field Group without key constraints to allow key generation */
-export type NextpressFieldGroup = TransformACFFieldGroup<ACFFieldGroup>;
+export type NextpressFieldGroup = TransformACFFieldGroup<ACFFieldGroup>
+
 /**
  * Represents an Advanced Custom Fields (ACF) Field Group configuration.
  */
@@ -11,89 +15,106 @@ export interface ACFFieldGroup {
     /**
      * Unique identifier for the field group with group_ prefix (e.g. 'group_abc123')
      */
-    key: string;
+    key: string
     /**
      * The title/name of this entity
      */
-    title: string;
+    title: string
     /**
      * Array of field definitions. If empty array, field group appears but contains no fields.
      */
-    fields: ACFField[];
+    fields: ACFField[]
     /**
      * The order of this entity in the admin menu
      */
-    menu_order?: number;
+    menu_order?: number
     /**
      * [ACF] Whether this entity is active
      */
-    active?: boolean;
+    active?: boolean
     /**
      * [ACF Export Only] Unix timestamp of last modification
      */
-    modified?: number;
+    modified?: number
     /**
      * Location rules determining where this field group appears. Array of rule groups (OR logic between groups, AND logic within groups). If omitted or empty, field group won't appear on any edit screens.
      */
-    location?: ACFLocationGroup[];
+    location?: ACFLocationGroup[]
     /**
      * Position of the field group on the edit screen
      */
-    position?: "normal" | "side" | "acf_after_title";
+    position?: "normal" | "side" | "acf_after_title"
     /**
      * Visual style of the field group metabox
      */
-    style?: "default" | "seamless";
+    style?: "default" | "seamless"
     /**
      * Placement of field labels relative to fields
      */
-    label_placement?: "top" | "left";
+    label_placement?: "top" | "left"
     /**
      * Placement of field instructions
      */
-    instruction_placement?: "label" | "field";
+    instruction_placement?: "label" | "field"
     /**
      * Screen elements to hide when this field group is displayed
      */
-    hide_on_screen?: ("permalink" | "the_content" | "excerpt" | "custom_fields" | "discussion" | "comments" | "revisions" | "slug" | "author" | "format" | "page_attributes" | "featured_image" | "categories" | "tags" | "send-trackbacks")[];
+    hide_on_screen?: (
+        | "permalink"
+        | "the_content"
+        | "excerpt"
+        | "custom_fields"
+        | "discussion"
+        | "comments"
+        | "revisions"
+        | "slug"
+        | "author"
+        | "format"
+        | "page_attributes"
+        | "featured_image"
+        | "categories"
+        | "tags"
+        | "send-trackbacks"
+    )[]
     /**
      * Description of the field group
      */
-    description?: string;
+    description?: string
     /**
      * Whether to expose this field group's fields in the REST API
      */
-    show_in_rest?: boolean | number;
+    show_in_rest?: boolean | number
     /**
      * Whether to expose this field group to AI integrations
      */
-    allow_ai_access?: boolean | number;
+    allow_ai_access?: boolean | number
     /**
      * Description that helps AI integrations understand how to use this field group
      */
-    ai_description?: string;
+    ai_description?: string
     /**
      * Alternative display title for the field group
      */
-    display_title?: string;
+    display_title?: string
 }
+
 /**
  * Group of location rules (AND logic within group)
  */
-export type ACFLocationGroup = [ACFLocationRule, ...ACFLocationRule[]];
-export interface ACFLocationRule {
+type ACFLocationGroup = [ACFLocationRule, ...ACFLocationRule[]]
+
+interface ACFLocationRule {
     /**
      * The parameter to compare (e.g. 'post_type', 'page_template', 'user_role')
      */
-    param: string;
+    param: string
     /**
      * Comparison operator
      */
-    operator: "==" | "!=";
+    operator: "==" | "!="
     /**
      * Value to compare against
      */
-    value: string;
-    [k: string]: unknown;
+    value: string
+    [k: string]: unknown
 }
-export {};