Page Builder plugin

packages/page-builder-types/.gitignore

@@ -0,0 +1 @@
+node_modules

packages/page-builder-types/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@lambdacurry/medusa-page-builder-types",
+  "version": "0.0.4",
+  "packageManager": "yarn@4.6.0",
+  "types": "./src/index.d.ts",
+  "devDependencies": {
+    "typescript": "5.7.3"
+  },
+  "exports": {
+    ".": "./src/index.d.ts"
+  },
+  "installConfig": {
+    "hoistingLimits": "workspaces"
+  },
+  "files": [
+    "src"
+  ]
+}

packages/page-builder-types/src/admins.d.ts

@@ -0,0 +1,78 @@
+import type { Post } from './models'
+
+// Response Types
+export interface PaginatedResponse {
+  count: number
+  offset: number
+  limit: number
+}
+
+export type AdminPageBuilderListPostsQuery = {
+  offset?: number
+  limit?: number
+  q?: string
+  id?: string | string[]
+  title?: string
+  handle?: string
+  status?: PostStatus | PostStatus[]
+  type?: PostType | PostType[]
+  content_mode?: PostContentMode | PostContentMode[]
+  is_home_page?: boolean
+  // biome-ignore lint/suspicious/noExplicitAny: medusa infered type
+  published_at?: any
+  // biome-ignore lint/suspicious/noExplicitAny: medusa infered type
+  archived_at?: any
+  // biome-ignore lint/suspicious/noExplicitAny: medusa infered type
+  created_at?: any
+  // biome-ignore lint/suspicious/noExplicitAny: medusa infered type
+  updated_at?: any
+  order?: string
+  fields?: string
+}
+
+export interface AdminPageBuilderListPostsResponse extends PaginatedResponse {
+  posts: Post[]
+}
+
+export type AdminPageBuilderCreatePostBody = {
+  title: string
+  handle?: string
+  excerpt?: string
+  content?: Record<string, unknown>
+  status?: PostStatus
+  type?: PostType
+  content_mode?: PostContentMode
+  seo?: Record<string, unknown>
+  is_home_page?: boolean
+}
+
+export interface AdminPageBuilderCreatePostResponse {
+  post: Post
+}
+
+export type AdminPageBuilderUpdatePostBody = {
+  id: string
+  title?: string
+  handle?: string
+  excerpt?: string
+  content?: Record<string, unknown>
+  status?: PostStatus
+  type?: PostType
+  content_mode?: PostContentMode
+  seo?: Record<string, unknown>
+  is_home_page?: boolean
+}
+
+export interface AdminPageBuilderUpdatePostResponse {
+  post: Post
+}
+
+export interface AdminPageBuilderDeletePostResponse {
+  id: string
+  object: string
+  deleted: boolean
+}
+
+export interface AdminPageBuilderDuplicatePostResponse {
+  post: Post
+}

packages/page-builder-types/src/common.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Common type declarations for page builder
+ */
+
+export type PostStatus = 'draft' | 'published' | 'archived'
+
+export type PostType = 'page' | 'post'
+
+export type PostContentMode = 'basic' | 'advanced'
+
+// These would be defined in the implementation file
+export declare const postStatuses: readonly PostStatus[]
+export declare const postTypes: readonly PostType[]
+export declare const postContentModes: readonly PostContentMode[]
+
+export interface SortOptions {
+  sort?: string
+  order?: 'ASC' | 'DESC'
+}
+
+export interface PaginationOptions {
+  limit?: number
+  offset?: number
+}
+
+export interface FilterOptions {
+  q?: string
+  [key: string]: unknown
+}
+
+export type QueryOptions = SortOptions & PaginationOptions & FilterOptions
+
+export interface FindConfig<T> extends QueryOptions {
+  select?: (keyof T)[]
+  relations?: string[]
+  where?: { [K in keyof T]?: T[K] | T[K][] } & {
+    [key: string]: unknown
+  }
+}

packages/page-builder-types/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from './admins'
+export * from './common'
+export * from './models'
+export * from './storefronts'

packages/page-builder-types/src/models.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Type declarations for page builder models
+ */
+
+import type { PostContentMode, PostStatus, PostType } from './common'
+
+export interface Base {
+  id: string
+  created_at: string
+  updated_at: string | undefined
+}
+
+export interface Post extends Base {
+  title: string
+  handle?: string | null
+  excerpt?: string | null
+  content?: Record<string, unknown> | null
+  status: PostStatus
+  type: PostType
+  content_mode: PostContentMode
+  seo?: Record<string, unknown> | null
+  is_home_page: boolean
+  published_at?: string | null
+  archived_at?: string | null
+  featured_image_id?: string
+  featured_image?: Image
+  authors?: PostAuthor[]
+  tags?: PostTag[]
+  sections?: PostSection[]
+  root_id?: string
+  root?: PostTemplate
+}
+
+export interface Image extends Base {
+  url: string
+  alt?: string
+  width?: number
+  height?: number
+  mime_type?: string
+  file_size?: number
+  metadata?: Record<string, unknown>
+}
+
+export interface NavigationItem extends Base {
+  title: string
+  url: string
+  parent_id?: string
+  parent?: NavigationItem
+  children?: NavigationItem[]
+}
+
+export interface PostAuthor extends Base {
+  name: string
+  bio?: string
+  posts?: Post[]
+}
+
+export interface PostSection extends Base {
+  name: string
+  data?: Record<string, unknown>
+  order: number
+  post_id?: string
+  post?: Post
+  parent_section_id?: string
+  parent_section?: PostSection
+  child_sections?: PostSection[]
+}
+
+export interface PostTag extends Base {
+  name: string
+  posts?: Post[]
+}
+
+export interface PostTemplate extends Base {
+  name: string
+  data?: Record<string, unknown>
+  posts?: Post[]
+}
+
+export interface SiteSettings extends Base {
+  site_name: string
+  site_url?: string
+  logo_id?: string
+  logo?: Image
+  favicon_id?: string
+  favicon?: Image
+  social_links?: Record<string, string>
+  navigation?: Record<string, NavigationItem[]>
+  custom_css?: string
+  custom_js?: string
+  meta_defaults?: Record<string, unknown>
+}

packages/page-builder-types/src/storefronts.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Storefront type declarations for page builder
+ */
+
+import type { Post, PostAuthor, PostTag, SiteSettings } from './models'
+
+export interface StorefrontGetPostParams {
+  handle: string
+}
+
+export interface StorefrontGetPostResponse {
+  post: Post
+}
+
+export interface StorefrontListPostsParams {
+  limit?: number
+  offset?: number
+  type?: string
+  tag?: string
+  author?: string
+  sort?: string
+  order?: 'asc' | 'desc'
+}
+
+export interface StorefrontListPostsResponse {
+  posts: Post[]
+  count: number
+  offset: number
+  limit: number
+}
+
+export interface StorefrontGetTagsResponse {
+  tags: PostTag[]
+}
+
+export interface StorefrontGetAuthorsResponse {
+  authors: PostAuthor[]
+}
+
+export interface StorefrontGetSiteSettingsResponse {
+  settings: SiteSettings
+}
+
+export interface StorefrontRenderOptions {
+  cacheControl?: string
+  handle?: string
+  language?: string
+  preview?: boolean
+}

packages/plugins-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/medusa-plugins-sdk",
-  "version": "0.0.5",
+  "version": "0.0.6-beta.3",
   "description": "SDK for Medusa plugins",
   "author": "Lambda Curry (https://lambdacurry.dev)",
   "license": "MIT",
@@ -38,15 +38,16 @@
     "dev:publish": "yalc publish"
   },
   "devDependencies": {
-    "@medusajs/types": "^2.5.0",
+    "@medusajs/types": "^2.6.1",
     "prettier": "^3.2.5",
     "rimraf": "^6.0.1",
     "tsup": "^8.0.2",
     "typescript": "^5.7.2",
     "yalc": "^1.0.0-pre.53"
   },
   "dependencies": {
-    "@medusajs/js-sdk": "^2.5.0",
+    "@lambdacurry/medusa-page-builder-types": "0.0.4",
+    "@medusajs/js-sdk": "^2.6.1",
     "@types/express": "^5.0.0",
     "@types/multer": "^1.4.12",
     "form-data": "^4.0.2"

packages/plugins-sdk/src/sdk/admin/admin-page-builder.ts

@@ -0,0 +1,63 @@
+import type { Client } from '@medusajs/js-sdk'
+import type {
+  AdminPageBuilderCreatePostBody,
+  AdminPageBuilderCreatePostResponse,
+  AdminPageBuilderListPostsQuery,
+  AdminPageBuilderListPostsResponse,
+  AdminPageBuilderDeletePostResponse,
+  AdminPageBuilderUpdatePostBody,
+  AdminPageBuilderUpdatePostResponse,
+  AdminPageBuilderDuplicatePostResponse,
+} from '@lambdacurry/medusa-page-builder-types'
+
+export class AdminPageBuilderResource {
+  constructor(private client: Client) {}
+
+  async listPosts(query: AdminPageBuilderListPostsQuery) {
+    return this.client.fetch<AdminPageBuilderListPostsResponse>(
+      '/admin/content/posts',
+      {
+        method: 'GET',
+        query,
+      },
+    )
+  }
+
+  async createPost(data: AdminPageBuilderCreatePostBody) {
+    return this.client.fetch<AdminPageBuilderCreatePostResponse>(
+      '/admin/content/posts',
+      {
+        method: 'POST',
+        body: data,
+      },
+    )
+  }
+
+  async updatePost(id: string, data: AdminPageBuilderUpdatePostBody) {
+    return this.client.fetch<AdminPageBuilderUpdatePostResponse>(
+      `/admin/content/posts/${id}`,
+      {
+        method: 'PUT',
+        body: data,
+      },
+    )
+  }
+
+  async deletePost(id: string) {
+    return this.client.fetch<AdminPageBuilderDeletePostResponse>(
+      `/admin/content/posts/${id}`,
+      {
+        method: 'DELETE',
+      },
+    )
+  }
+
+  async duplicatePost(id: string) {
+    return this.client.fetch<AdminPageBuilderDuplicatePostResponse>(
+      `/admin/content/posts/${id}/duplicate`,
+      {
+        method: 'POST',
+      },
+    )
+  }
+}