nextpress-core 1.0.0

package/lib/template-heirarchy/not-found.tsx/not-found.tsx

@@ -0,0 +1,28 @@
+import { Metadata } from "next";
+import { JSX } from "react";
+import { loadMetadata, loadTemplate } from "../_autoloader/template-autoloader";
+import { IndexMetadata, IndexTemplate } from "..";
+
+/**
+ * Loads the metadata for the NotFound template.
+ * Fallback: Index
+ *
+ * @returns {Promise<Metadata>} The merged metadata object.
+ */
+export async function NotFoundMetadata(): Promise<Metadata> {
+    const metadata = await loadMetadata('NotFound');
+    return {...(await IndexMetadata()), ...metadata};
+}
+
+/**
+ * Renders the NotFound template. Falls back to the Index template if not found.
+ * Fallback: Index
+ *
+ * @returns {Promise<JSX.Element>} The rendered template component.
+ */
+export async function NotFoundTemplate(): Promise<JSX.Element> {
+    const NotFound = await loadTemplate('NotFound');
+    if (!NotFound) return <IndexTemplate/>
+
+    return <NotFound/>;
+}

package/lib/template-heirarchy/page/page.tsx

@@ -0,0 +1,28 @@
+import { Metadata } from "next";
+import { JSX } from "react";
+import { loadMetadata, loadTemplate } from "../_autoloader/template-autoloader";
+import { SingularMetadata, SingularTemplate } from "./singular";
+
+/**
+ * Loads the metadata for the Page template.
+ * Fallback: Singular
+ *
+ * @returns {Promise<Metadata>} The merged metadata object.
+ */
+export async function PageMetadata(): Promise<Metadata> {
+    const metadata = await loadMetadata('Page');
+    return {...(await SingularMetadata()), ...metadata};
+}
+
+/**
+ * Renders the Page template. Falls back to the Singular template if not found.
+ * Fallback: Singular
+ *
+ * @returns {Promise<JSX.Element>} The rendered template component.
+ */
+export async function PageTemplate(): Promise<JSX.Element> {
+    const Page = await loadTemplate('Page');
+    if (!Page) return <SingularTemplate/>
+
+    return <Page/>;
+}

package/lib/template-heirarchy/page/posttype.tsx

@@ -0,0 +1,34 @@
+import { Metadata } from "next";
+import { JSX } from "react";
+import { loadMetadata, loadTemplate } from "../_autoloader/template-autoloader";
+import { SingularMetadata, SingularTemplate } from "./singular";
+import { capitalizeFirstLetter } from "@/services/utilities/capitalise-first-letter";
+
+/**
+ * Loads the metadata for a Post Type template based on the provided post type string.
+ * Fallback: Singular
+ *
+ * @param {object} props - The properties for loading metadata.
+ * @param {string} props.postType - The post type to load metadata for.
+ * @returns {Promise<Metadata>} The merged metadata object.
+ */
+export async function PostTypeMetadata({postType}: {postType: string}): Promise<Metadata> {
+    const metadata = await loadMetadata(capitalizeFirstLetter(postType));
+    return {...(await SingularMetadata()), ...metadata};
+}
+
+/**
+ * Renders a Post Type template based on the provided post type string. Falls back to Singular template if not found.
+ * Fallback: Singular
+ *
+ * @param {object} props - The properties for rendering the template.
+ * @param {string} props.postType - The post type to load the template for.
+ * @returns {Promise<JSX.Element>} The rendered template component.
+ */
+export async function PostTypeTemplate({postType}: {postType: string}): Promise<JSX.Element> {
+    const PostType = await loadTemplate(capitalizeFirstLetter(postType));
+    if (!PostType) return <SingularTemplate/>
+
+    return <PostType/>;
+}
+

package/lib/template-heirarchy/page/single.tsx

@@ -0,0 +1,28 @@
+import { Metadata } from "next";
+import { JSX } from "react";
+import { loadMetadata, loadTemplate } from "../_autoloader/template-autoloader";
+import { SingularMetadata, SingularTemplate } from "./singular";
+
+/**
+ * Loads the metadata for the Single template.
+ * Fallback: Singular
+ *
+ * @returns {Promise<Metadata>} The merged metadata object.
+ */
+export async function SingleMetadata(): Promise<Metadata> {
+    const metadata = await loadMetadata('Single');
+    return {...(await SingularMetadata()), ...metadata};
+}
+
+/**
+ * Renders the Single template. Falls back to the Singular template if not found.
+ * Fallback: Singular
+ *
+ * @returns {Promise<JSX.Element>} The rendered template component.
+ */
+export async function SingleTemplate(): Promise<JSX.Element> {
+    const Single = await loadTemplate('Single');
+    if (!Single) return <SingularTemplate/>
+
+    return <Single/>;
+}

package/lib/template-heirarchy/page/singular.tsx

@@ -0,0 +1,28 @@
+import { Metadata } from "next";
+import { JSX } from "react";
+import { loadMetadata, loadTemplate } from "../_autoloader/template-autoloader";
+import { IndexMetadata, IndexTemplate } from "..";
+
+/**
+ * Loads the metadata for the Singular template.
+ * Fallback: Index
+ *
+ * @returns {Promise<Metadata>} The merged metadata object.
+ */
+export async function SingularMetadata(): Promise<Metadata> {
+    const metadata = await loadMetadata('Singular');
+    return {...(await IndexMetadata()), ...metadata}
+}
+
+/**
+ * Renders the Singular template. Falls back to the Index template if not found.
+ * Fallback: Index
+ *
+ * @returns {Promise<JSX.Element>} The rendered template component.
+ */
+export async function SingularTemplate(): Promise<JSX.Element> {
+    const Singular = await loadTemplate('Singular');
+    if (!Singular) return <IndexTemplate/>
+
+    return <Singular {...queriedObject} />;
+}

package/lib/ui/render-attachment-image.tsx

@@ -0,0 +1,29 @@
+import { ClassValue } from "clsx";
+import Image from "next/image";
+import { ComponentPropsWithoutRef } from "react";
+
+type Props = Omit<ComponentPropsWithoutRef<typeof Image>, "src" | "alt" | "height" | "width"> & {
+    attachmentId: number;
+    className?: ClassValue;
+};
+
+/**
+ * Renders a WordPress media attachment using the Next.js Image component.
+ */
+export async function RenderAttachmentImage({ attachmentId, className, ...rest }: Props) {
+    const image = await getPost(attachmentId);
+    if (!image) return;
+
+    const { src, alt, height, width } = image.imageAttributes;
+
+    return (
+        <Image
+            src={src || ''}
+            alt={alt || ''}
+            height={height}
+            width={width}
+            className={className}
+            {...rest}
+        />
+    );
+}

package/lib/ui/render-components.tsx

@@ -0,0 +1,12 @@
+import { ResolvedFlexibleContent } from "../acf-functions/types/components/field-props";
+
+type Props = {
+    layouts: ResolvedFlexibleContent<any>,
+}
+
+/**
+ * Dynamically resolves and renders an array of mapped ACF Layout components from a resolved flexible content field.
+ */
+export async function RenderComponents({ layouts }: Props) {
+    return layouts.map((layout, index) => <layout.Component key={index} {...layout.content}/>)
+}

package/lib/ui/render-the-admin-bar.tsx

@@ -0,0 +1,79 @@
+"use client"
+import { useEffect, useState } from "react";
+import { usePathname } from "next/navigation";
+import Script from "next/script";
+import { wpKsesPost } from "@/services/utilities/kses-post";
+
+type Props = {
+    loggedInUserId?: number
+}
+
+type AdminBarResponse = {
+    html: string,
+    assets: {
+        css: {
+            admin_bar: string,
+            dashicons: string
+        },
+        js: {
+            admin_bar: string
+        }
+    }
+}
+
+/**
+ * Renders the WordPress admin bar for authenticated administrators browsing the Next.js frontend.
+ */
+export async function RenderTheAdminBar({ loggedInUserId }: Props) {
+    const [adminBar, setAdminBar] = useState<AdminBarResponse | null>(null);
+    const [isMounted, setIsMounted] = useState(false);
+
+    const path = usePathname();
+
+    useEffect(() => {
+        fetch(`/api/admin-bar?user_id=${loggedInUserId}&path=${encodeURIComponent(path)}`)
+            .then((request) => {
+                if (!request.ok) {
+                    throw new Error(`Failed to fetch admin bar: ${request.status}`);
+                }
+                return request.json();
+            })
+            .then((response) => {
+                setAdminBar(response);
+                setTimeout(() => setIsMounted(true), 50);
+            })
+            .catch((error) => {
+                console.error("Failed to load admin bar", error.message);
+            })
+    }, [loggedInUserId, path]);
+
+    if (!adminBar) {
+        return null;
+    }
+
+    return (
+        <>
+            <link
+                rel="stylesheet"
+                href={adminBar.assets.css.admin_bar}
+                precedence="high"
+            />
+            <link
+                rel="stylesheet"
+                href={adminBar.assets.css.dashicons}
+                precedence="high"
+            />
+            <Script src={adminBar.assets.js.admin_bar}/>
+
+            <div
+                className={`fixed top-0 left-0 right-0 transform transition-all duration-300 ease-in-out ${
+                    isMounted
+                        ? "scale-y-100"
+                        : "scale-y-0"
+                }`}
+            >
+                {wpKsesPost(adminBar.html)}
+            </div>
+        </>
+    );
+}

package/lib/ui/render-the-logo.tsx

@@ -0,0 +1,24 @@
+import { getThemeMods } from "@/services/get-theme-mods";
+import { getBlogname } from "@/services/metadata/get-blogname";
+import { RenderAttachmentImage } from "./render-attachment-image";
+
+type Props = {
+    className?: string
+}
+
+/**
+ * Renders the custom site logo defined in the WordPress Customizer.
+ *
+ * Fallback: Renders the text-based Site Title if no custom logo is assigned in WordPress.
+ */
+export async function RenderTheLogo({ className }: Props) {
+    const logoId = Number(await getThemeMods('custom_logo')) ?? 0;
+
+    return (
+        <div className={className}>
+            {logoId ?
+                <RenderAttachmentImage className="h-full w-full object-contain object-center" attachmentId={logoId} sizes="512px"/>
+            : <span className="text-4xl font-bold">{await getBlogname()}</span>}
+        </div>
+    )
+}

package/lib/wpdb/wpdb.interface.d.ts

@@ -0,0 +1,171 @@
+/**
+ * This file was generated by kysely-codegen.
+ * Please do not edit it manually.
+ */
+
+import type { ColumnType } from "kysely";
+
+export type Generated<T> = T extends ColumnType<infer S, infer I, infer U>
+    ? ColumnType<S, I | undefined, U>
+    : ColumnType<T, T | undefined, T>;
+
+export interface WpCommentmeta {
+    commentId: Generated<number>;
+    metaId: Generated<number>;
+    metaKey: string | null;
+    metaValue: string | null;
+}
+
+export interface WpComment {
+    commentAgent: Generated<string>;
+    commentApproved: Generated<string>;
+    commentAuthor: string;
+    commentAuthorEmail: Generated<string>;
+    commentAuthorIP: Generated<string>;
+    commentAuthorUrl: Generated<string>;
+    commentContent: string;
+    commentDate: Generated<Date>;
+    commentDateGmt: Generated<Date>;
+    commentID: Generated<number>;
+    commentKarma: Generated<number>;
+    commentParent: Generated<number>;
+    commentPostID: Generated<number>;
+    commentType: Generated<string>;
+    userId: Generated<number>;
+}
+
+export interface WpLink {
+    linkDescription: Generated<string>;
+    linkId: Generated<number>;
+    linkImage: Generated<string>;
+    linkName: Generated<string>;
+    linkNotes: string;
+    linkOwner: Generated<number>;
+    linkRating: Generated<number>;
+    linkRel: Generated<string>;
+    linkRss: Generated<string>;
+    linkTarget: Generated<string>;
+    linkUpdated: Generated<Date>;
+    linkUrl: Generated<string>;
+    linkVisible: Generated<string>;
+}
+
+export interface WpNextpressPostmeta {
+    metaId: Generated<number>;
+    metaKey: string | null;
+    metaValue: string | null;
+    objectId: Generated<number>;
+}
+
+export interface WpNextpressTermmeta {
+    metaId: Generated<number>;
+    metaKey: string | null;
+    metaValue: string | null;
+    objectId: Generated<number>;
+}
+
+export interface WpOption {
+    autoload: Generated<string>;
+    optionId: Generated<number>;
+    optionName: Generated<string>;
+    optionValue: string;
+}
+
+export interface WpPostmeta {
+    metaId: Generated<number>;
+    metaKey: string | null;
+    metaValue: string | null;
+    postId: Generated<number>;
+}
+
+export interface WpPost {
+    commentCount: Generated<number>;
+    commentStatus: Generated<string>;
+    guid: Generated<string>;
+    ID: Generated<number>;
+    menuOrder: Generated<number>;
+    pinged: string;
+    pingStatus: Generated<string>;
+    postAuthor: Generated<number>;
+    postContent: string;
+    postContentFiltered: string;
+    postDate: Generated<Date>;
+    postDateGmt: Generated<Date>;
+    postExcerpt: string;
+    postMimeType: Generated<string>;
+    postModified: Generated<Date>;
+    postModifiedGmt: Generated<Date>;
+    postName: Generated<string>;
+    postParent: Generated<number>;
+    postPassword: Generated<string>;
+    postStatus: Generated<string>;
+    postTitle: string;
+    postType: Generated<string>;
+    toPing: string;
+}
+
+export interface WpTermmeta {
+    metaId: Generated<number>;
+    metaKey: string | null;
+    metaValue: string | null;
+    termId: Generated<number>;
+}
+
+export interface WpTermRelationship {
+    objectId: Generated<number>;
+    termOrder: Generated<number>;
+    termTaxonomyId: Generated<number>;
+}
+
+export interface WpTerm {
+    name: Generated<string>;
+    slug: Generated<string>;
+    termGroup: Generated<number>;
+    termId: Generated<number>;
+}
+
+export interface WpTermTaxonomy {
+    count: Generated<number>;
+    description: string;
+    parent: Generated<number>;
+    taxonomy: Generated<string>;
+    termId: Generated<number>;
+    termTaxonomyId: Generated<number>;
+}
+
+export interface WpUsermeta {
+    metaKey: string | null;
+    metaValue: string | null;
+    umetaId: Generated<number>;
+    userId: Generated<number>;
+}
+
+export interface WpUser {
+    displayName: Generated<string>;
+    ID: Generated<number>;
+    userActivationKey: Generated<string>;
+    userEmail: Generated<string>;
+    userLogin: Generated<string>;
+    userNicename: Generated<string>;
+    userPass: Generated<string>;
+    userRegistered: Generated<Date>;
+    userStatus: Generated<number>;
+    userUrl: Generated<string>;
+}
+
+export interface DB {
+    wpCommentmeta: WpCommentmeta;
+    wpComments: WpComment;
+    wpLinks: WpLink;
+    wpNextpressPostmeta: WpNextpressPostmeta;
+    wpNextpressTermmeta: WpNextpressTermmeta;
+    wpOptions: WpOption;
+    wpPostmeta: WpPostmeta;
+    wpPosts: WpPost;
+    wpTermmeta: WpTermmeta;
+    wpTermRelationships: WpTermRelationship;
+    wpTerms: WpTerm;
+    wpTermTaxonomy: WpTermTaxonomy;
+    wpUsermeta: WpUsermeta;
+    wpUsers: WpUser;
+}

package/lib/wpdb/wpdb.ts

@@ -0,0 +1,36 @@
+import { DB } from './wpdb.interface'
+import { createPool } from 'mysql2'
+import { CamelCasePlugin, DeduplicateJoinsPlugin, Kysely, MysqlDialect } from 'kysely'
+
+const dialect = new MysqlDialect({
+    pool: createPool({
+        user: 'root',
+        host: 'db',
+        password: process.env.MYSQL_ROOT_PASSWORD,
+        database: process.env.MYSQL_DATABASE,
+        waitForConnections: true,
+        connectionLimit: 150,
+        maxIdle: 150,
+        idleTimeout: 60000,
+        queueLimit: 0,
+        enableKeepAlive: true,
+        keepAliveInitialDelay: 0,
+    }),
+})
+
+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}`);
+    //         console.log(`PARAMS: ${JSON.stringify(event.query.parameters)}`);
+    //     }
+    //     if (event.level === 'error') {
+    //         console.error(`DB ERROR:`, event.error);
+    //     }
+    // }
+})

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "nextpress-core",
+  "version": "1.0.0",
+  "description": "Nextpress Core",
+  "keywords": [],
+  "files": [
+    "lib"
+  ],
+  "exports": {
+    "./*": {
+      "import": "./lib/*.{ts,tsx}"
+    }
+  },
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "dependencies": {
+    "html-react-parser": "^6.1.2",
+    "isomorphic-dompurify": "^3.14.0",
+    "kysely": "^0.29.2",
+    "mysql2": "^3.22.3",
+    "next": "16.2.6",
+    "php-serialize": "^5.1.3",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.58.9",
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20.19.41",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "babel-plugin-react-compiler": "1.0.0",
+    "cross-env": "^10.1.0",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}