Post Management implementation

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',
+ },
+ )
+ }
+}

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',
+ },
+ )
+ }
+}

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',
+ },
+ )
+ }
+}

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',
+ },
+ )
+ }
+}

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',
+ },
+ )
+ }
+}

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',
+ },
+ )
+ }
+}

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',
+ },
+ )
+ }
+}

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',
+ },
+ )
+ }
+}