nextpress-core 1.1.0 → 2.0.0

package/{dist/wpdb/wpdb.js → lib/wpdb/wpdb.ts}

@@ -1,5 +1,7 @@
-import { createPool } from 'mysql2';
-import { CamelCasePlugin, DeduplicateJoinsPlugin, Kysely, MysqlDialect } from 'kysely';
+import { createPool } from 'mysql2'
+import { CamelCasePlugin, DeduplicateJoinsPlugin, Kysely, MysqlDialect } from 'kysely'
+import { DB } from './wpdb.interface';
+
 const dialect = new MysqlDialect({
     pool: createPool({
         user: 'root',
@@ -14,12 +16,14 @@ const dialect = new MysqlDialect({
         enableKeepAlive: true,
         keepAliveInitialDelay: 0,
     }),
-});
-export const wpdb = new Kysely({
+})
+
+export const wpdb = new Kysely<DB>({
     dialect,
     plugins: [new CamelCasePlugin(), new DeduplicateJoinsPlugin()],
     // log(event) {
     //     if (process.env.NODE_ENV !== 'development') return;
+
     //     if (event.level === 'query') {
     //         console.log(`\n[${event.queryDurationMillis.toFixed(2)}ms] QUERY EXECUTION`);
     //         console.log(`SQL: ${event.query.sql}`);
@@ -29,4 +33,4 @@ export const wpdb = new Kysely({
     //         console.error(`DB ERROR:`, event.error);
     //     }
     // }
-});
+})

package/package.json

@@ -1,52 +1,19 @@
 {
   "name": "nextpress-core",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Nextpress Core",
   "keywords": [],
-  "scripts": {
-    "build": "tsc"
+  "bin": {
+    "nextpress-install": "./cli/install.js"
   },
   "files": [
-    "dist"
+    "lib",
+    "cli"
   ],
-  "exports": {
-    "./acf-functions": {
-      "types": "./dist/acf-functions/index.d.ts",
-      "import": "./dist/acf-functions/index.js"
-    },
-    "./entities": {
-      "types": "./dist/entities/index.d.ts",
-      "import": "./dist/entities/index.js"
-    },
-    "./globals": {
-      "types": "./dist/globals/index.d.ts",
-      "import": "./dist/globals/index.js"
-    },
-    "./repository": {
-      "types": "./dist/repository/index.d.ts",
-      "import": "./dist/repository/index.js"
-    },
-    "./router": {
-      "types": "./dist/router/index.d.ts",
-      "import": "./dist/router/index.js"
-    },
-    "./services": {
-      "types": "./dist/services/index.d.ts",
-      "import": "./dist/services/index.js"
-    },
-    "./ui": {
-      "types": "./dist/ui/index.d.ts",
-      "import": "./dist/ui/index.js"
-    },
-    "./wpdb": {
-      "types": "./dist/wpdb/index.d.ts",
-      "import": "./dist/wpdb/index.js"
-    }
-  },
-  "author": "",
+  "author": "ellsaw",
   "license": "ISC",
   "type": "module",
-  "dependencies": {
+  "devDependencies": {
     "html-react-parser": "^6.1.2",
     "isomorphic-dompurify": "^3.14.0",
     "kysely": "^0.29.2",
@@ -54,9 +21,7 @@
     "next": "16.2.6",
     "php-serialize": "^5.1.3",
     "react": "19.2.4",
-    "react-dom": "19.2.4"
-  },
-  "devDependencies": {
+    "react-dom": "19.2.4",
     "@microsoft/api-extractor": "^7.58.9",
     "@tailwindcss/postcss": "^4",
     "@types/node": "^20.19.41",

package/dist/acf-functions/core/acf-builder.d.ts

@@ -1,51 +0,0 @@
-import { ACFFieldGroup, NextpressFieldGroup } from "../types/acf-field-group";
-/**
- * Class representing ACF builder.
- */
-export declare class ACFBuilder {
-    /** Array of ACF field groups. */
-    private fieldGroups;
-    constructor();
-    /**
-     * Gets built field groups.
-     *
-     * @returns {ACFFieldGroup[]} Array of field groups.
-     */
-    getFieldGroups(): ACFFieldGroup[];
-    /**
-     * Converts field groups to JSON string.
-     *
-     * @returns {string} JSON string representation of field groups.
-     */
-    toJSON(): string;
-    /**
-     * Registers and processes Nextpress field groups.
-     *
-     * @param {NextpressFieldGroup[]} fieldGroups - Array of field groups to register.
-     * @returns {this} Current instance.
-     */
-    registerFieldGroups(fieldGroups: NextpressFieldGroup[]): this;
-    /**
-     * Sets keys for fields based on parent name.
-     *
-     * @param {NextpressField[]} fields - Array of fields to process.
-     * @param {string} parentName - Parent string name.
-     * @returns {ACFField[]} Array of fields with generated keys.
-     */
-    private setFieldKeys;
-    /**
-     * Sets keys for layouts based on parent name.
-     *
-     * @param {NextpressLayout[]} layouts - Array of layouts to process.
-     * @param {string} parentName - Parent string name.
-     * @returns {ACFLayout[]} Array of layouts with generated keys.
-     */
-    private setLayoutKeys;
-    /**
-     * Formats suffix string.
-     *
-     * @param {string} suffix - Suffix to format.
-     * @returns {string} Formatted string.
-     */
-    private formatKeySuffix;
-}

package/dist/acf-functions/core/acf-component-autoloader.d.ts

@@ -1,11 +0,0 @@
-import { NextpressComponent } from '../types/components/nextpress-component';
-/**
- * Autoloads ACF components dynamically from the templates directory.
- * * **Requirements for it to work:**
- * Each `.tsx` file within the `src/app/_templates/components/` directory MUST export the following:
- * 1. `layout` (Named Export): The configuration for the ACF layout, typically defined using the `defineLayout` function.
- * 2. `default` (Default Export): The React component (JSX/TSX function) that renders the layout.
- *
- * @returns {Promise<NextpressComponent[]>} A promise resolving to an array of mapped layout configurations and their respective components.
- */
-export declare function acfComponentAutoloader(): Promise<NextpressComponent[]>;

package/dist/acf-functions/core/acf-field-group-autoloader.d.ts

@@ -1,10 +0,0 @@
-import { NextpressFieldGroup } from '../types/acf-field-group';
-/**
- * Autoloads ACF field groups dynamically from the field-groups directory.
- * * **Requirements for it to work:**
- * Each `.ts` file within the `src/app/_templates/components/field-groups/` directory MUST export the following:
- * 1. `default` (Default Export): The configuration object for the ACF Field Group, typically defined using the `defineFieldGroup` function.
- *
- * @returns {Promise<NextpressFieldGroup[]>} A promise resolving to an array of loaded ACF field group configurations.
- */
-export declare function acfFieldGroupAutoloader(): Promise<NextpressFieldGroup[]>;

package/dist/acf-functions/field-props.d.ts

@@ -1,196 +0,0 @@
-import { IPost } from "@/entities/post/post.interface";
-import { ITerm } from "@/entities/term/term.interface";
-import { IUser } from "@/entities/user/user.interface";
-import { JSX } from "react";
-type GetFields<T> = T extends {
-    fields: readonly any[];
-} ? T['fields'] : T extends {
-    sub_fields: readonly any[];
-} ? T['sub_fields'] : never;
-/**
- * Represents the properties passed to a Nextpress ACF component.
- *
- * @template T - The expected type of the mapped ACF fields.
- */
-export type FieldProps<LayoutT> = LayoutT extends {
-    fields: readonly any[];
-} | {
-    sub_fields: readonly any[];
-} ? ResolvedFields<GetFields<LayoutT>> : never;
-/**
- * An array of ACF field configurations to a strongly-typed object representing the resolved data structure.
- * It iterates over the array, using the `name` property of each field as the object key, and determines the expected value type using the `MapFieldType` utility.
- *
- * @template Fields - A readonly array of ACF field configuration objects.
- */
-type ResolvedFields<Fields extends readonly any[]> = {
-    [F in Fields[number] as F['name']]: MapFieldType<F>;
-};
-/**
- * Maps an array of ACF Flexible Content layouts to a union type representing the resolved layout blocks.
- * For each layout, it checks for the presence of `fields` or `sub_fields`, and resolves to a specific object
- * structure containing the layout's React component and its deeply resolved field content.
- *
- * @template Layouts - A readonly array of ACF Flexible Content layout configuration objects.
- */
-type ResolvedFlexibleContent<Layouts extends readonly any[]> = {
-    [L in Layouts[number] as L['name']]: L extends {
-        name: infer Name;
-    } & ({
-        fields: readonly any[];
-    } | {
-        sub_fields: readonly any[];
-    }) ? {
-        Component: () => Promise<JSX.Element>;
-        content: ResolvedFields<GetFields<L>>;
-    }[] : never;
-}[Layouts[number]['name']];
-type MapFieldType<Field> = Field extends {
-    type: 'color_picker';
-} ? string | null : Field extends {
-    type: 'date_picker';
-} ? string | null : Field extends {
-    type: 'date_time_picker';
-} ? string | null : Field extends {
-    type: 'google_map';
-} ? ACFGoogleMapsObject | null : Field extends {
-    type: 'icon_picker';
-} ? Field extends {
-    return_format: 'string';
-} ? string | null : Field extends {
-    return_format: 'array';
-} ? ACFIconObject | null : ACFIconObject | null : Field extends {
-    type: 'time_picker';
-} ? string | null : Field extends {
-    type: 'email';
-} ? string | null : Field extends {
-    type: 'number';
-} ? number | null : Field extends {
-    type: 'password';
-} ? string | null : Field extends {
-    type: 'range';
-} ? number | null : Field extends {
-    type: 'text';
-} ? string | null : Field extends {
-    type: 'textarea';
-} ? string | null : Field extends {
-    type: 'button_group';
-} ? Field extends {
-    return_format: 'array';
-} ? ACFChoiceObject | null : string | null : Field extends {
-    type: 'checkbox';
-} ? Field extends {
-    return_format: 'array';
-} ? ACFChoiceObject[] : string[] : Field extends {
-    type: 'radio';
-} ? Field extends {
-    return_format: 'array';
-} ? ACFChoiceObject | null : string | null : Field extends {
-    type: 'select';
-} ? Field extends {
-    multiple: 1;
-} ? Field extends {
-    return_format: 'array';
-} ? ACFChoiceObject[] : string[] : Field extends {
-    return_format: 'array';
-} ? ACFChoiceObject | null : string | null : Field extends {
-    type: 'true_false';
-} ? boolean : Field extends {
-    type: 'file';
-} ? number | null : Field extends {
-    type: 'gallery';
-} ? number[] : Field extends {
-    type: 'image';
-} ? number | null : Field extends {
-    type: 'oembed';
-} ? string | null : Field extends {
-    type: 'wysiwyg';
-} ? string | null : Field extends {
-    type: 'link';
-} ? Field extends {
-    return_format: 'url';
-} ? string | null : Field extends {
-    return_format: 'array';
-} ? ACFLinkObject | null : ACFLinkObject : Field extends {
-    type: 'page_link';
-} ? Field extends {
-    multiple: 1;
-} ? string[] : string | null : Field extends {
-    type: 'post_object';
-} ? Field extends {
-    multiple: 1;
-} ? Field extends {
-    return_format: 'object';
-} ? IPost[] : number[] : Field extends {
-    return_format: 'object';
-} ? IPost | null : number | null : Field extends {
-    type: 'relationship';
-} ? Field extends {
-    return_format: 'object';
-} ? IPost[] | null : number[] | null : Field extends {
-    type: 'taxonomy';
-} ? Field extends {
-    multiple: 1;
-} ? Field extends {
-    return_format: 'object';
-} ? ITerm[] : number[] : Field extends {
-    return_format: 'object';
-} ? ITerm | null : number | null : Field extends {
-    type: 'user';
-} ? Field extends {
-    multiple: 1;
-} ? Field extends {
-    return_format: 'object';
-} ? IUser[] : number[] : Field extends {
-    return_format: 'object';
-} ? IUser | null : number | null : Field extends {
-    type: 'group';
-} & ({
-    fields: readonly any[];
-} | {
-    sub_fields: readonly any[];
-}) ? ResolvedFields<GetFields<Field>> | null : Field extends {
-    type: 'repeater';
-} & ({
-    fields: readonly any[];
-} | {
-    sub_fields: readonly any[];
-}) ? ResolvedFields<GetFields<Field>>[] | null : Field extends {
-    type: 'flexible_content';
-    layouts: readonly any[];
-} ? ResolvedFlexibleContent<Field['layouts']> | null : Field extends {
-    fields: readonly any[];
-} | {
-    sub_fields: readonly any[];
-} ? ResolvedFields<GetFields<Field>> : never;
-type ACFIconObject = {
-    type: string;
-    value: string;
-};
-type ACFLinkObject = {
-    title: string;
-    url: string;
-    target: string;
-};
-type ACFChoiceObject = {
-    label?: string;
-    value?: string;
-};
-type ACFGoogleMapsObject = {
-    address: string;
-    lat: string | number;
-    lng: string | number;
-    zoom: string | number;
-    place_id: string;
-    name: string;
-    street_number: string | number;
-    street_name: string;
-    street_name_short: string;
-    city: string;
-    state: string;
-    state_short: string;
-    post_code: string | number;
-    country: string;
-    country_short: string;
-};
-export {};

package/dist/acf-functions/field-props.js

@@ -1 +0,0 @@
-export {};

package/dist/acf-functions/index.d.ts

@@ -1,13 +0,0 @@
-export * from './core/acf-builder';
-export * from './core/acf-field-group-autoloader';
-export * from './core/acf-component-autoloader';
-export * from './services/define-field-group';
-export * from './services/define-layout';
-export * from './services/map-fields/map-fields';
-export * from './services/map-fields/helpers/map-choice-object';
-export * from './types/acf-field';
-export * from './types/acf-values';
-export * from './types/acf-field-group';
-export * from './types/acf-layout';
-export * from './types/components/field-props';
-export * from './types/components/nextpress-component';

package/dist/acf-functions/index.js

@@ -1,13 +0,0 @@
-export * from './core/acf-builder';
-export * from './core/acf-field-group-autoloader';
-export * from './core/acf-component-autoloader';
-export * from './services/define-field-group';
-export * from './services/define-layout';
-export * from './services/map-fields/map-fields';
-export * from './services/map-fields/helpers/map-choice-object';
-export * from './types/acf-field';
-export * from './types/acf-values';
-export * from './types/acf-field-group';
-export * from './types/acf-layout';
-export * from './types/components/field-props';
-export * from './types/components/nextpress-component';

package/dist/acf-functions/services/define-field-group.js

@@ -1,10 +0,0 @@
-/**
- * Defines field group configuration and applies typing.
- *
- * @template T - Field group type extending NextpressFieldGroup.
- * @param {T} layout - Field group configuration object.
- * @returns {T} Passed field group configuration object.
- */
-export function defineFieldGroup(layout) {
-    return layout;
-}

package/dist/acf-functions/services/define-layout.js

@@ -1,10 +0,0 @@
-/**
- * Defines layout configuration and applies typing.
- *
- * @template T - Layout type extending NextpressLayout.
- * @param {T} layout - Layout configuration object.
- * @returns {T} Passed layout configuration object.
- */
-export function defineLayout(layout) {
-    return layout;
-}

package/dist/acf-functions/services/map-fields/helpers/map-choice-object.d.ts

@@ -1,2 +0,0 @@
-import { ACFChoiceObject } from "@/acf-functions/types/components/field-props";
-export declare function mapChoiceObject(return_format: 'array' | 'label' | 'value', value?: string, choices?: any): ACFChoiceObject | string | undefined;

package/dist/acf-functions/services/map-fields/helpers/map-choice-object.js

@@ -1,18 +0,0 @@
-export function mapChoiceObject(return_format, value, choices) {
-    if (return_format === 'value') {
-        return value;
-    }
-    if (!choices)
-        return;
-    const label = choices[value !== null && value !== void 0 ? value : ''];
-    if (return_format === 'array') {
-        const result = {
-            label: label,
-            value: value
-        };
-        return result;
-    }
-    else if (return_format === 'label') {
-        return label;
-    }
-}

package/dist/acf-functions/services/map-fields/map-fields.d.ts

@@ -1,21 +0,0 @@
-import { NextpressField } from "@/acf-functions/types/acf-field";
-import { NextpressLayout } from "@/acf-functions/types/acf-layout";
-import { ACFRawValues } from "@/acf-functions/types/acf-values";
-/**
- * Maps individual ACF field to corresponding value.
- *
- * @param {NextpressField} field - Field configuration.
- * @param {ACFRawValues} rawValues - Raw values map.
- * @returns {Promise<any>} Promise resolving to mapped value.
- */
-export declare function mapField(field: NextpressField, rawValues: ACFRawValues): Promise<any>;
-/**
- * Maps layout configuration to values object.
- *
- * @param {NextpressLayout} layout - Layout configuration.
- * @param {ACFRawValues} rawValues - Raw values map.
- * @returns {Promise<{ [key: string]: any }>} Promise resolving to layout values object.
- */
-export declare function mapLayout(layout: NextpressLayout, rawValues: ACFRawValues): Promise<{
-    [key: string]: any;
-}>;

package/dist/acf-functions/types/acf-field-group.js

@@ -1 +0,0 @@
-export {};