@evenicanpm/cms 1.3.0

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+import Strapi from "strapi-sdk-js";
+declare const strapi: Strapi;
+export { strapi };

package/dist/content/blogs/index.d.ts

@@ -0,0 +1,11 @@
+import type { Blog } from "./types";
+declare const getBlogs: (options: {
+    pagination: {
+        pageSize: number;
+        page: number;
+    };
+}) => Promise<import("strapi-sdk-js").StrapiResponse<Blog[]>>;
+declare const getBlog: (options: {
+    id: string;
+}) => Promise<import("strapi-sdk-js").StrapiResponse<Blog>>;
+export { getBlogs, getBlog };

package/dist/content/blogs/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Interface is not auto-generated and needs to be updated
+ * whenever Strapi Content-Type is modified.
+ *
+ * TODO: Auto-generated interfaces from Strapi
+ */
+export interface Blog {
+    title: string;
+    content: any;
+    image: any;
+    documentId: string;
+    id: number;
+    shortDescription: string;
+    createdAt: Date;
+    publishedAt: Date;
+    createdBy: {
+        firstname: string;
+        lastname: string;
+    };
+}

package/dist/content/navigation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Fetch main navigation TREE
+ *
+ * Not an actual content type and has a specific endpoint
+ * so must use axios.request api directly
+ */
+declare const getMainNavigation: () => Promise<unknown>;
+export { getMainNavigation };

package/dist/content/navigation/types.d.ts

@@ -0,0 +1,45 @@
+export interface CmsNavigation {
+    nodes: {
+        name: string;
+        id: number;
+        items: (CmsPage | CmsSubMenu)[];
+    }[];
+}
+export interface CmsPage {
+    type: string;
+    id: number;
+    name: string;
+    slug: string;
+}
+export interface CmsSubMenu {
+    type: string;
+    name: string;
+    pages: CmsPage[];
+}
+export interface CmsNavRelated {
+    id: number;
+    title: string;
+    slug: string;
+    createdAt: string;
+    updatedAt: string;
+    publishedAt?: string | null;
+    /** Optional content‑type hint Strapi adds when `populate=*` */
+    __contentType?: string;
+    /**
+     * Any other attributes your model exposes (e.g., SEO fields,
+     * coverImage, etc.). Keep this open so the type stays valid
+     * if the Strapi model grows.
+     */
+    [key: string]: unknown;
+}
+export interface CmsNavItem {
+    title: string;
+    menuAttached: boolean;
+    path: string;
+    type: "INTERNAL" | "EXTERNAL" | "WRAPPER";
+    uiRouterKey: string;
+    slug: string;
+    related: CmsNavRelated | null;
+    external: boolean;
+    items: CmsNavItem[];
+}

package/dist/content/pages/index.d.ts

@@ -0,0 +1,5 @@
+import type { Page } from "./types";
+declare const getPage: (options: {
+    slug: string;
+}) => Promise<import("strapi-sdk-js").StrapiResponse<Page[]>>;
+export { getPage };

package/dist/content/pages/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Interface is not auto-generated and needs to be updated
+ * whenever Strapi Content-Type is modified.
+ *
+ * TODO: Auto-generated interfaces from Strapi
+ */
+type MetaElement = {
+    name: string;
+    content: string;
+};
+export interface Page {
+    title: string;
+    slug: string;
+    seo: {
+        metaTitle?: string;
+        metaDescription?: string;
+        shareImage?: any;
+        metaImage?: {
+            media: {
+                url: string;
+            };
+        };
+        metaKeywords: Array<string>;
+        meta: Array<MetaElement>;
+    } | null;
+    block: Array<{
+        __component: "blocks.rich-text";
+        id: number;
+        content: string;
+    }>;
+}
+export {};

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import * as blogs from "./content/blogs";
+import * as navigation from "./content/navigation";
+import * as pages from "./content/pages";
+import * as media from "./media";
+import * as session from "./session";
+export declare const cms: {
+    blogs: typeof blogs;
+    pages: typeof pages;
+    navigation: typeof navigation;
+    media: typeof media;
+    session: typeof session;
+};

package/dist/media/get-image-url.d.ts

@@ -0,0 +1,7 @@
+export type imageSizes = "small" | "medium" | "large" | "thumbnail";
+/**
+ * @param formats formats array from CMS data
+ * @param size size of the image
+ * @returns largest available image url
+ */
+export declare const getImageUrl: (formats: any, size?: imageSizes) => any;

package/dist/media/index.d.ts

@@ -0,0 +1 @@
+export * from "./get-image-url";

package/dist/session/index.d.ts

@@ -0,0 +1,2 @@
+declare const signout: () => Promise<void>;
+export { signout };

package/package.json

@@ -0,0 +1,20 @@
+{
+	"name": "@evenicanpm/cms",
+	"version": "1.3.0",
+	"description": "Strapi 5 client and queries for e4 Headless.",
+	"author": "Evenica",
+	"type": "module",
+	"license": "ISC",
+	"exports": "./src/index.ts",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"test": "echo \"Error: no test specified\" && exit 1"
+	},
+	"dependencies": {
+		"strapi-sdk-js": "^3.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^24.0.13"
+	},
+	"gitHead": "074f33378006dfc21ceb49456806a18dbb6e91ad"
+}

package/src/README.md

@@ -0,0 +1,22 @@
+# e4 CMS Module 
+
+## index
+
+- should export all content-type queries to be accessed with:
+
+```ts
+import { cms } from '@evenicanpm/common-core/src/cms';
+
+const blogs = await cms.blogs.getBlogs()
+```
+
+## content/
+
+- Contains strapi-client queries for content-types
+
+## media/
+
+- Contains helpers and utilities related to media library 
+and CMS images.
+
+

package/src/client.ts

@@ -0,0 +1,7 @@
+import Strapi from "strapi-sdk-js";
+
+const strapi = new Strapi({
+	url: `${process.env.NEXT_PUBLIC_STRAPI_5_ENDPOINT}`,
+});
+
+export { strapi };

package/src/content/blogs/index.ts

@@ -0,0 +1,18 @@
+import { strapi } from "../../client";
+import type { Blog } from "./types";
+
+// Queries
+const getBlogs = async (options: {
+	pagination: { pageSize: number; page: number };
+}) => {
+	return await strapi.find<Blog>("blogs", {
+		pagination: { ...options.pagination, withCount: true },
+		populate: "*",
+	});
+};
+
+const getBlog = async (options: { id: string }) => {
+	return await strapi.findOne<Blog>("blogs", options.id, { populate: "*" });
+};
+
+export { getBlogs, getBlog };

package/src/content/blogs/types.ts

@@ -0,0 +1,18 @@
+/**
+ * Interface is not auto-generated and needs to be updated
+ * whenever Strapi Content-Type is modified.
+ *
+ * TODO: Auto-generated interfaces from Strapi
+ */
+
+export interface Blog {
+	title: string;
+	content: any;
+	image: any;
+	documentId: string;
+	id: number;
+	shortDescription: string;
+	createdAt: Date;
+	publishedAt: Date;
+	createdBy: { firstname: string; lastname: string };
+}

package/src/content/navigation/index.ts

@@ -0,0 +1,26 @@
+import { strapi } from "../../client";
+
+/**
+ * Fetch main navigation TREE
+ *
+ * Not an actual content type and has a specific endpoint
+ * so must use axios.request api directly
+ */
+const getMainNavigation = async () => {
+	// GET /navigation/render/main-navigation?type=TREE
+	try {
+		const response = await strapi.request(
+			"get",
+			"/navigation/render/navigation",
+			{
+				params: { type: "TREE" },
+				headers: {},
+			},
+		);
+		return response;
+	} catch (_error) {
+		console.log("error fetching strapi navigation data");
+	}
+};
+
+export { getMainNavigation };

package/src/content/navigation/types.ts

@@ -0,0 +1,52 @@
+// cms internal interfaces
+export interface CmsNavigation {
+	nodes: {
+		name: string;
+		id: number;
+		items: (CmsPage | CmsSubMenu)[];
+	}[];
+}
+
+export interface CmsPage {
+	type: string;
+	id: number;
+	name: string;
+	slug: string;
+}
+
+export interface CmsSubMenu {
+	type: string;
+	name: string;
+	pages: CmsPage[];
+}
+
+export interface CmsNavRelated {
+	id: number;
+	title: string;
+	slug: string;
+	createdAt: string;
+	updatedAt: string;
+	publishedAt?: string | null;
+
+	/** Optional content‑type hint Strapi adds when `populate=*` */
+	__contentType?: string;
+
+	/**
+	 * Any other attributes your model exposes (e.g., SEO fields,
+	 * coverImage, etc.). Keep this open so the type stays valid
+	 * if the Strapi model grows.
+	 */
+	[key: string]: unknown;
+}
+
+export interface CmsNavItem {
+	title: string;
+	menuAttached: boolean;
+	path: string;
+	type: "INTERNAL" | "EXTERNAL" | "WRAPPER";
+	uiRouterKey: string;
+	slug: string;
+	related: CmsNavRelated | null;
+	external: boolean;
+	items: CmsNavItem[];
+}

package/src/content/pages/index.ts

@@ -0,0 +1,14 @@
+import { strapi } from "../../client";
+import type { Page } from "./types";
+
+const getPage = async (options: { slug: string }) => {
+	const { slug } = options;
+
+	// Equivalent of: pages.find({ filter: { slug }, populate: "*" })
+	return await strapi.find<Page>("pages", {
+		filters: { slug },
+		populate: "*",
+	});
+};
+
+export { getPage };

package/src/content/pages/types.ts

@@ -0,0 +1,31 @@
+/**
+ * Interface is not auto-generated and needs to be updated
+ * whenever Strapi Content-Type is modified.
+ *
+ * TODO: Auto-generated interfaces from Strapi
+ */
+
+type MetaElement = {
+	name: string;
+	content: string;
+};
+
+export interface Page {
+	title: string;
+	slug: string;
+	seo: {
+		// blocks.seo component
+		metaTitle?: string;
+		metaDescription?: string;
+		shareImage?: any;
+		metaImage?: { media: { url: string } };
+		metaKeywords: Array<string>;
+		meta: Array<MetaElement>;
+	} | null;
+
+	block: Array<{
+		__component: "blocks.rich-text";
+		id: number;
+		content: string;
+	}>;
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+import * as blogs from "./content/blogs";
+import * as navigation from "./content/navigation";
+import * as pages from "./content/pages";
+import * as media from "./media";
+import * as session from "./session";
+
+export const cms = {
+	blogs,
+	pages,
+	navigation,
+	media,
+	session,
+};

package/src/media/get-image-url.ts

@@ -0,0 +1,25 @@
+export type imageSizes = "small" | "medium" | "large" | "thumbnail";
+// Media
+/**
+ * @param formats formats array from CMS data
+ * @param size size of the image
+ * @returns largest available image url
+ */
+export const getImageUrl = (formats: any, size?: imageSizes) => {
+	if (size) {
+		return formats[size]?.url;
+	}
+
+	if (formats?.large?.url) {
+		return formats.large.url;
+	}
+	if (formats?.medium?.url) {
+		return formats.medium.url;
+	}
+	if (formats?.small?.url) {
+		return formats.small.url;
+	}
+	if (formats?.thumbnail?.url) {
+		return formats.thumbnail.url;
+	}
+};

package/src/media/index.ts

@@ -0,0 +1 @@
+export * from "./get-image-url";

package/src/session/index.ts

@@ -0,0 +1,7 @@
+import { strapi } from "../client";
+
+const signout = async () => {
+	await strapi.request("post", "/e4-sso-plugin", { withCredentials: true });
+};
+
+export { signout };

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+	"compilerOptions": {
+		"target": "ES6",
+		"lib": ["ES2022", "DOM", "DOM.Iterable"],
+		"module": "ESNext",
+		"sourceMap": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"declaration": true,
+		"moduleResolution": "node",
+		"resolveJsonModule": true,
+		"outDir": "./dist",
+		"baseUrl": "./",
+		"emitDeclarationOnly": true,
+		"jsx": "preserve"
+	},
+	"include": ["./"]
+}