@fayz-ai/plugin-marketing 0.2.1 → 0.8.1

package/dist/schema.js

@@ -1,7 +1,7 @@
 import { pgTable, createdAt, boolean, text, tenantId, uuid, index, timestamps, integer, jsonb, date } from '@fayz-ai/db';
 
 // src/schema/index.ts
-var mktSocialAccounts = pgTable("mkt_social_accounts", {
+var mktSocialAccounts = pgTable("plg_marketing_social_accounts", {
   id: uuid("id").primaryKey().defaultRandom(),
   tenantId: tenantId(),
   name: text("name").notNull(),
@@ -10,8 +10,8 @@ var mktSocialAccounts = pgTable("mkt_social_accounts", {
   platforms: text("platforms").array().notNull().default(["instagram"]),
   isActive: boolean("is_active").notNull().default(true),
   ...createdAt
-}, (t) => [index("idx_mkt_social_accounts_tenant").on(t.tenantId)]);
-var mktContentPlans = pgTable("mkt_content_plans", {
+}, (t) => [index("idx_plg_marketing_social_accounts_tenant").on(t.tenantId)]);
+var mktContentPlans = pgTable("plg_marketing_content_plans", {
   id: uuid("id").primaryKey().defaultRandom(),
   tenantId: tenantId(),
   accountId: uuid("account_id").notNull().references(() => mktSocialAccounts.id, { onDelete: "cascade" }),
@@ -27,10 +27,10 @@ var mktContentPlans = pgTable("mkt_content_plans", {
   briefMd: text("brief_md").notNull().default(""),
   ...timestamps
 }, (t) => [
-  index("idx_mkt_content_plans_tenant").on(t.tenantId),
-  index("idx_mkt_content_plans_account").on(t.accountId)
+  index("idx_plg_marketing_content_plans_tenant").on(t.tenantId),
+  index("idx_plg_marketing_content_plans_account").on(t.accountId)
 ]);
-var mktContentPosts = pgTable("mkt_content_posts", {
+var mktContentPosts = pgTable("plg_marketing_content_posts", {
   id: uuid("id").primaryKey().defaultRandom(),
   tenantId: tenantId(),
   planId: uuid("plan_id").notNull().references(() => mktContentPlans.id, { onDelete: "cascade" }),
@@ -51,9 +51,9 @@ var mktContentPosts = pgTable("mkt_content_posts", {
   contentMd: text("content_md").notNull().default(""),
   ...timestamps
 }, (t) => [
-  index("idx_mkt_content_posts_tenant").on(t.tenantId),
-  index("idx_mkt_content_posts_plan").on(t.planId, t.weekNumber, t.position),
-  index("idx_mkt_content_posts_status").on(t.tenantId, t.status)
+  index("idx_plg_marketing_content_posts_tenant").on(t.tenantId),
+  index("idx_plg_marketing_content_posts_plan").on(t.planId, t.weekNumber, t.position),
+  index("idx_plg_marketing_content_posts_status").on(t.tenantId, t.status)
 ]);
 
 export { mktContentPlans, mktContentPosts, mktSocialAccounts };

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schema/index.ts"],"names":[],"mappings":"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","file":"schema.js","sourcesContent":["// Builders come from @fayz-ai/db (single drizzle-orm instance) — never import\n// pgTable/uuid directly from drizzle-orm/pg-core. See MIGRATION-ARCHITECTURE §6.\nimport {\n  pgTable, uuid, text, boolean, integer, date, jsonb, index,\n  tenantId, timestamps, createdAt,\n} from '@fayz-ai/db'\n\n// ---------------------------------------------------------------------------\n// Marketing plugin — Ring-1 schema (schema-as-code), content planner tables.\n// RLS policies + grants are companion SQL (Drizzle doesn't diff those) —\n// see src/migrations/001_content_planner.sql.\n// ---------------------------------------------------------------------------\n\nexport const mktSocialAccounts = pgTable('mkt_social_accounts', {\n  id: uuid('id').primaryKey().defaultRandom(),\n  tenantId: tenantId(),\n  name: text('name').notNull(),\n  handle: text('handle'),\n  // One account, many platform connections (Instagram, YouTube, TikTok, ...)\n  platforms: text('platforms').array().notNull().default(['instagram']),\n  isActive: boolean('is_active').notNull().default(true),\n  ...createdAt,\n}, (t) => [index('idx_mkt_social_accounts_tenant').on(t.tenantId)])\n\nexport const mktContentPlans = pgTable('mkt_content_plans', {\n  id: uuid('id').primaryKey().defaultRandom(),\n  tenantId: tenantId(),\n  accountId: uuid('account_id').notNull().references(() => mktSocialAccounts.id, { onDelete: 'cascade' }),\n  name: text('name').notNull(),\n  status: text('status').notNull().default('active'),\n  weeksCount: integer('weeks_count').notNull().default(8),\n  startDate: date('start_date'),\n  objective: text('objective'),\n  tone: text('tone'),\n  pillars: jsonb('pillars').notNull().default([]),\n  formats: jsonb('formats').notNull().default([]),\n  weeklyFrequency: integer('weekly_frequency').notNull().default(3),\n  briefMd: text('brief_md').notNull().default(''),\n  ...timestamps,\n}, (t) => [\n  index('idx_mkt_content_plans_tenant').on(t.tenantId),\n  index('idx_mkt_content_plans_account').on(t.accountId),\n])\n\nexport const mktContentPosts = pgTable('mkt_content_posts', {\n  id: uuid('id').primaryKey().defaultRandom(),\n  tenantId: tenantId(),\n  planId: uuid('plan_id').notNull().references(() => mktContentPlans.id, { onDelete: 'cascade' }),\n  weekNumber: integer('week_number').notNull().default(1),\n  position: integer('position').notNull().default(0),\n  title: text('title').notNull(),\n  format: text('format').notNull().default('reel'),\n  status: text('status').notNull().default('idea'),\n  scheduledDate: date('scheduled_date'),\n  // Target platforms for this post; empty = inherit the account's platforms\n  platforms: text('platforms').array().notNull().default([]),\n  // Recording-day checklist [{ id, text, done }]\n  checklist: jsonb('checklist').notNull().default([]),\n  // Uploaded asset (static posts: caption + final art instead of a script)\n  mediaUrl: text('media_url'),\n  hook: text('hook'),\n  cta: text('cta'),\n  contentMd: text('content_md').notNull().default(''),\n  ...timestamps,\n}, (t) => [\n  index('idx_mkt_content_posts_tenant').on(t.tenantId),\n  index('idx_mkt_content_posts_plan').on(t.planId, t.weekNumber, t.position),\n  index('idx_mkt_content_posts_status').on(t.tenantId, t.status),\n])\n"]}
+{"version":3,"sources":["../src/schema/index.ts"],"names":[],"mappings":"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","file":"schema.js","sourcesContent":["// Builders come from @fayz-ai/db (single drizzle-orm instance) — never import\n// pgTable/uuid directly from drizzle-orm/pg-core. See MIGRATION-ARCHITECTURE §6.\nimport {\n  pgTable, uuid, text, boolean, integer, date, jsonb, index,\n  tenantId, timestamps, createdAt,\n} from '@fayz-ai/db'\n\n// ---------------------------------------------------------------------------\n// Marketing plugin — Ring-1 schema (schema-as-code), content planner tables.\n// RLS policies + grants are companion SQL (Drizzle doesn't diff those) —\n// see src/migrations/001_content_planner.sql.\n// ---------------------------------------------------------------------------\n\nexport const mktSocialAccounts = pgTable('plg_marketing_social_accounts', {\n  id: uuid('id').primaryKey().defaultRandom(),\n  tenantId: tenantId(),\n  name: text('name').notNull(),\n  handle: text('handle'),\n  // One account, many platform connections (Instagram, YouTube, TikTok, ...)\n  platforms: text('platforms').array().notNull().default(['instagram']),\n  isActive: boolean('is_active').notNull().default(true),\n  ...createdAt,\n}, (t) => [index('idx_plg_marketing_social_accounts_tenant').on(t.tenantId)])\n\nexport const mktContentPlans = pgTable('plg_marketing_content_plans', {\n  id: uuid('id').primaryKey().defaultRandom(),\n  tenantId: tenantId(),\n  accountId: uuid('account_id').notNull().references(() => mktSocialAccounts.id, { onDelete: 'cascade' }),\n  name: text('name').notNull(),\n  status: text('status').notNull().default('active'),\n  weeksCount: integer('weeks_count').notNull().default(8),\n  startDate: date('start_date'),\n  objective: text('objective'),\n  tone: text('tone'),\n  pillars: jsonb('pillars').notNull().default([]),\n  formats: jsonb('formats').notNull().default([]),\n  weeklyFrequency: integer('weekly_frequency').notNull().default(3),\n  briefMd: text('brief_md').notNull().default(''),\n  ...timestamps,\n}, (t) => [\n  index('idx_plg_marketing_content_plans_tenant').on(t.tenantId),\n  index('idx_plg_marketing_content_plans_account').on(t.accountId),\n])\n\nexport const mktContentPosts = pgTable('plg_marketing_content_posts', {\n  id: uuid('id').primaryKey().defaultRandom(),\n  tenantId: tenantId(),\n  planId: uuid('plan_id').notNull().references(() => mktContentPlans.id, { onDelete: 'cascade' }),\n  weekNumber: integer('week_number').notNull().default(1),\n  position: integer('position').notNull().default(0),\n  title: text('title').notNull(),\n  format: text('format').notNull().default('reel'),\n  status: text('status').notNull().default('idea'),\n  scheduledDate: date('scheduled_date'),\n  // Target platforms for this post; empty = inherit the account's platforms\n  platforms: text('platforms').array().notNull().default([]),\n  // Recording-day checklist [{ id, text, done }]\n  checklist: jsonb('checklist').notNull().default([]),\n  // Uploaded asset (static posts: caption + final art instead of a script)\n  mediaUrl: text('media_url'),\n  hook: text('hook'),\n  cta: text('cta'),\n  contentMd: text('content_md').notNull().default(''),\n  ...timestamps,\n}, (t) => [\n  index('idx_plg_marketing_content_posts_tenant').on(t.tenantId),\n  index('idx_plg_marketing_content_posts_plan').on(t.planId, t.weekNumber, t.position),\n  index('idx_plg_marketing_content_posts_status').on(t.tenantId, t.status),\n])\n"]}

package/dist/views/blog/BlogAdminView.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export declare function BlogAdminView({ navigate }: {
+    navigate: (view: string) => void;
+}): React.JSX.Element;
+//# sourceMappingURL=BlogAdminView.d.ts.map

package/dist/views/blog/BlogAdminView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogAdminView.d.ts","sourceRoot":"","sources":["../../../src/views/blog/BlogAdminView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAA;AAgF3D,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,qBAkB/E"}

package/dist/views/blog/BlogEntityForm.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { EntityDef } from '@fayz-ai/core';
+export declare function BlogEntityForm<T extends {
+    id: string;
+}>({ entity, editId, parentLabel, onDone, }: {
+    entity: EntityDef<T>;
+    editId?: string;
+    parentLabel: string;
+    onDone: () => void;
+}): React.JSX.Element;
+//# sourceMappingURL=BlogEntityForm.d.ts.map

package/dist/views/blog/BlogEntityForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogEntityForm.d.ts","sourceRoot":"","sources":["../../../src/views/blog/BlogEntityForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAU9C,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EACvD,MAAM,EACN,MAAM,EACN,WAAW,EACX,MAAM,GACP,EAAE;IACD,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,qBAoEA"}

package/dist/views/blog/useEntityCrud.d.ts

@@ -0,0 +1,29 @@
+import type { EntityDef } from '@fayz-ai/core';
+interface ListQuery {
+    search?: string;
+    filters?: Record<string, unknown>;
+    page?: number;
+    pageSize?: number;
+    sortBy?: string;
+    sortDir?: 'asc' | 'desc';
+}
+/**
+ * Minimal store-less CRUD wiring for a plugin that owns its data + routing.
+ * Resolves the generic Supabase provider from the EntityDef's `data.table`
+ * (mock fallback when Supabase is not configured) and exposes list/get/save/
+ * remove. Used by the blog backoffice list + form views — the heavy list/form
+ * rendering stays in the shared CrudListView / CrudFormPage.
+ */
+export declare function useEntityCrud<T extends {
+    id: string;
+}>(entity: EntityDef<T>): {
+    items: T[] | null;
+    total: number;
+    fetch: (query?: ListQuery) => Promise<void>;
+    getById: (id: string) => Promise<T | null>;
+    create: (data: Record<string, unknown>) => Promise<T>;
+    update: (id: string, data: Record<string, unknown>) => Promise<T>;
+    remove: (id: string) => Promise<void>;
+};
+export {};
+//# sourceMappingURL=useEntityCrud.d.ts.map

package/dist/views/blog/useEntityCrud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntityCrud.d.ts","sourceRoot":"","sources":["../../../src/views/blog/useEntityCrud.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,UAAU,SAAS;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;;;oBAKlC,SAAS;kBAcV,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;mBAK/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iBACzB,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iBACrC,MAAM;EAGvC"}

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@fayz-ai/plugin-marketing",
-  "version": "0.2.1",
+  "fayz": {
+    "status": "beta"
+  },
+  "version": "0.8.1",
   "description": "Fayz SDK — marketing campaigns & broadcasts plugin",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -32,10 +35,10 @@
     "@tanstack/react-table": "^8.20.0",
     "lucide-react": "^0.400.0",
     "zustand": "^4.5.0",
-    "@fayz-ai/db": "^0.1.2",
-    "@fayz-ai/saas": "^0.7.0",
-    "@fayz-ai/core": "^0.7.0",
-    "@fayz-ai/ui": "^0.7.0"
+    "@fayz-ai/core": "^0.8.1",
+    "@fayz-ai/ui": "^0.8.1",
+    "@fayz-ai/saas": "^0.8.1",
+    "@fayz-ai/db": "^0.8.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",

package/src/MarketingContext.tsx

@@ -15,6 +15,8 @@ export interface MarketingLabels {
   funnel: string
   landingPages: string
   content: string
+  blog: string
+  blogCategories: string
   settings: string
 }
 

package/src/MarketingPage.tsx

@@ -19,6 +19,9 @@ import type { ContentPlannerUIState } from './views/content/contentStore'
 import { ContentView } from './views/content/ContentView'
 import { PostPage } from './views/content/PostPage'
 import { PlanBriefView } from './views/content/PlanBriefView'
+import { BlogAdminView } from './views/blog/BlogAdminView'
+import { BlogEntityForm } from './views/blog/BlogEntityForm'
+import { buildBlogPostEntity, buildBlogCategoryEntity } from './data/blogEntities'
 
 function buildNav(
   config: ResolvedMarketingConfig,
@@ -51,6 +54,14 @@ function buildNav(
       onClick: () => navigate('content'),
     })
   }
+  if (config.modules.blog) {
+    items.push({
+      id: 'blog', label: config.labels.blog, icon: 'Newspaper',
+      active: view === 'blog' || view === 'blog-new' || view.startsWith('blog-post:')
+        || view === 'blog-cat-new' || view.startsWith('blog-cat:'),
+      onClick: () => navigate('blog'),
+    })
+  }
   return items
 }
 
@@ -63,8 +74,9 @@ export function MarketingPage({ config, provider, store, contentProvider, conten
 }) {
   const t = useTranslation()
   const { view, direction, navigate } = useModuleNavigation('/marketing', {
-    overview: 0, channels: 0, campaigns: 0, funnel: 0, 'landing-pages': 0, content: 0,
+    overview: 0, channels: 0, campaigns: 0, funnel: 0, 'landing-pages': 0, content: 0, blog: 0,
     'channel-detail': 1, 'content-post': 1, 'content-brief': 1,
+    'blog-new': 1, 'blog-post': 1, 'blog-cat-new': 1, 'blog-cat': 1,
   }, 'overview')
 
   React.useEffect(() => { void store.getState().load() }, [store])
@@ -72,6 +84,10 @@ export function MarketingPage({ config, provider, store, contentProvider, conten
   const isOverview = view === 'overview'
   const nav = buildNav(config, view, navigate)
 
+  // Blog backoffice entities — one shared EntityDef each drives the list + form.
+  const blogPostEntity = React.useMemo(() => buildBlogPostEntity(), [])
+  const blogCategoryEntity = React.useMemo(() => buildBlogCategoryEntity(), [])
+
   const quickActions = React.useMemo<PluginQuickAction[]>(() => [
     { id: 'new-campaign', label: t('marketing.campaigns.new'), icon: 'Megaphone', description: config.labels.campaigns, action: () => navigate('campaigns') },
   ], [t, config.labels.campaigns])
@@ -85,6 +101,11 @@ export function MarketingPage({ config, provider, store, contentProvider, conten
     { id: 'content', render: () => <ContentView onOpenPost={(id) => navigate(`content-post:${id}`)} /> },
     { id: 'content-post', render: ({ id }) => <PostPage postId={id!} onBack={() => navigate('content')} /> },
     { id: 'content-brief', render: () => <PlanBriefView onBack={() => navigate('content')} /> },
+    { id: 'blog', render: () => <BlogAdminView navigate={navigate} /> },
+    { id: 'blog-new', render: () => <BlogEntityForm entity={blogPostEntity} parentLabel={config.labels.blog} onDone={() => navigate('blog')} /> },
+    { id: 'blog-post', render: ({ id }) => <BlogEntityForm entity={blogPostEntity} editId={id!} parentLabel={config.labels.blog} onDone={() => navigate('blog')} /> },
+    { id: 'blog-cat-new', render: () => <BlogEntityForm entity={blogCategoryEntity} parentLabel={config.labels.blogCategories} onDone={() => navigate('blog')} /> },
+    { id: 'blog-cat', render: ({ id }) => <BlogEntityForm entity={blogCategoryEntity} editId={id!} parentLabel={config.labels.blogCategories} onDone={() => navigate('blog')} /> },
     { id: 'overview', render: () => <OverviewView /> },
   ], 'overview')
 

package/src/data/blogEntities.tsx

@@ -0,0 +1,91 @@
+import type { EntityDef, FieldDef } from '@fayz-ai/core'
+
+// ---------------------------------------------------------------------------
+// Blog backoffice entities — the single source of truth that drives BOTH the
+// generic list (CrudListView columns + facets) and the create/edit form
+// (CrudFormPage fields, incl. the markdown body + category relation).
+//
+// Persistence is the generic Supabase provider resolved from `data.table`
+// (plg_blog_posts / plg_blog_categories, owned by @fayz-ai/plugin-blog's
+// migrations). camelCase field keys map to snake_case columns automatically.
+// The website reads the same rows through the anon v_public_blog_posts view.
+// ---------------------------------------------------------------------------
+
+export const BLOG_POSTS_TABLE = 'plg_blog_posts'
+export const BLOG_CATEGORIES_TABLE = 'plg_blog_categories'
+
+export interface BlogPostRow {
+  id: string
+  title: string
+  slug: string
+  excerpt: string
+  body: string
+  categoryId?: string
+  coverImage?: string
+  authorName?: string
+  authorRole?: string
+  authorAvatarUrl?: string
+  authorBio?: string
+  status: 'draft' | 'published'
+  readTime?: string
+  publishedAt?: string
+}
+
+export interface BlogCategoryRow {
+  id: string
+  name: string
+  slug: string
+  description?: string
+}
+
+export function buildBlogPostEntity(): EntityDef<BlogPostRow> {
+  const fields: FieldDef[] = [
+    { key: 'title', label: 'Title', type: 'text', required: true, searchable: true, showInTable: true, sortable: true },
+    { key: 'slug', label: 'Slug', type: 'text', required: true, searchable: true, showInTable: false, hint: 'URL identifier, e.g. "cannabis-and-oral-health"' },
+    { key: 'status', label: 'Status', type: 'select', options: ['draft', 'published'], showInTable: true, defaultValue: 'draft' },
+    { key: 'categoryId', label: 'Category', type: 'relation', relation: { table: BLOG_CATEGORIES_TABLE, valueField: 'id', labelField: 'name', tenantScoped: true }, showInTable: false },
+    { key: 'excerpt', label: 'Excerpt', type: 'textarea', span: 2, showInTable: false, placeholder: 'Short summary shown on cards' },
+    { key: 'body', label: 'Body', type: 'markdown', span: 2, showInTable: false },
+    { key: 'coverImage', label: 'Cover image', type: 'image', showInTable: false, placeholder: 'https://…' },
+    { key: 'readTime', label: 'Read time', type: 'text', showInTable: false, placeholder: '5 min' },
+    { key: 'publishedAt', label: 'Published at', type: 'date', showInTable: true, sortable: true },
+    { key: 'authorName', label: 'Author name', type: 'text', showInTable: false },
+    { key: 'authorRole', label: 'Author role', type: 'text', showInTable: false, placeholder: 'e.g. Cirurgião-Dentista' },
+    { key: 'authorAvatarUrl', label: 'Author avatar', type: 'image', showInTable: false, placeholder: 'https://…' },
+    { key: 'authorBio', label: 'Author bio', type: 'textarea', span: 2, showInTable: false },
+  ]
+  return {
+    name: 'Post',
+    namePlural: 'Posts',
+    icon: 'Newspaper',
+    fields,
+    displayField: 'title',
+    subtitleField: 'slug',
+    facets: [{ field: 'status', allLabel: 'All' }],
+    data: {
+      table: BLOG_POSTS_TABLE,
+      tenantScoped: true,
+      searchColumns: ['title', 'slug', 'excerpt'],
+    },
+  }
+}
+
+export function buildBlogCategoryEntity(): EntityDef<BlogCategoryRow> {
+  const fields: FieldDef[] = [
+    { key: 'name', label: 'Name', type: 'text', required: true, searchable: true, showInTable: true, sortable: true },
+    { key: 'slug', label: 'Slug', type: 'text', required: true, searchable: true, showInTable: true, hint: 'URL identifier' },
+    { key: 'description', label: 'Description', type: 'textarea', span: 2, showInTable: false },
+  ]
+  return {
+    name: 'Category',
+    namePlural: 'Categories',
+    icon: 'Tags',
+    fields,
+    displayField: 'name',
+    data: {
+      table: BLOG_CATEGORIES_TABLE,
+      tenantScoped: true,
+      searchColumns: ['name', 'slug'],
+    },
+  }
+}

package/src/data/contentSupabase.ts

@@ -5,10 +5,11 @@ import type {
   ContentPost,
   SocialAccount,
 } from './contentTypes'
+import { T } from './tables'
 
 // ---------------------------------------------------------------------------
-// Supabase content-planner provider. Tables: mkt_social_accounts,
-// mkt_content_plans, mkt_content_posts (see src/migrations/001_content_planner.sql).
+// Supabase content-planner provider. Tables: plg_marketing_social_accounts,
+// plg_marketing_content_plans, plg_marketing_content_posts (see src/migrations/001_content_planner.sql).
 // RLS scopes rows to the user's tenants; we still filter tenant_id explicitly
 // on reads so multi-tenant sessions see only the active tenant.
 // ---------------------------------------------------------------------------
@@ -61,7 +62,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
       const tenantId = getActiveTenantId()
       if (!tenantId) return []
       const { data } = await getClient()
-        .from('mkt_social_accounts')
+        .from(T.socialAccounts)
         .select('*')
         .eq('tenant_id', tenantId)
         .eq('is_active', true)
@@ -77,7 +78,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
         if (input.platforms !== undefined) payload.platforms = input.platforms
         if (input.isActive !== undefined) payload.is_active = input.isActive
         const { data, error } = await getClient()
-          .from('mkt_social_accounts')
+          .from(T.socialAccounts)
           .update(payload)
           .eq('id', input.id)
           .select('*')
@@ -86,7 +87,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
         return toAccount(data)
       }
       const { data, error } = await getClient()
-        .from('mkt_social_accounts')
+        .from(T.socialAccounts)
         .insert({
           tenant_id: requireTenantId(),
           name: input.name,
@@ -101,7 +102,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
     },
 
     async deleteAccount(id) {
-      const { error } = await getClient().from('mkt_social_accounts').delete().eq('id', id)
+      const { error } = await getClient().from(T.socialAccounts).delete().eq('id', id)
       if (error) throw error
     },
 
@@ -109,7 +110,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
       const tenantId = getActiveTenantId()
       if (!tenantId) return []
       const { data } = await getClient()
-        .from('mkt_content_plans')
+        .from(T.contentPlans)
         .select('*')
         .eq('tenant_id', tenantId)
         .eq('account_id', accountId)
@@ -119,7 +120,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
 
     async getPlan(id) {
       const { data } = await getClient()
-        .from('mkt_content_plans')
+        .from(T.contentPlans)
         .select('*')
         .eq('id', id)
         .maybeSingle()
@@ -140,7 +141,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
         if (input.weeklyFrequency !== undefined) payload.weekly_frequency = input.weeklyFrequency
         if (input.briefMd !== undefined) payload.brief_md = input.briefMd
         const { data, error } = await getClient()
-          .from('mkt_content_plans')
+          .from(T.contentPlans)
           .update(payload)
           .eq('id', input.id)
           .select('*')
@@ -150,7 +151,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
       }
       if (!input.accountId) throw new Error('accountId is required')
       const { data, error } = await getClient()
-        .from('mkt_content_plans')
+        .from(T.contentPlans)
         .insert({
           tenant_id: requireTenantId(),
           account_id: input.accountId,
@@ -172,12 +173,12 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
     },
 
     async deletePlan(id) {
-      await getClient().from('mkt_content_plans').delete().eq('id', id)
+      await getClient().from(T.contentPlans).delete().eq('id', id)
     },
 
     async listPosts(planId) {
       const { data } = await getClient()
-        .from('mkt_content_posts')
+        .from(T.contentPosts)
         .select('*')
         .eq('plan_id', planId)
         .order('week_number', { ascending: true })
@@ -187,7 +188,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
 
     async getPost(id) {
       const { data } = await getClient()
-        .from('mkt_content_posts')
+        .from(T.contentPosts)
         .select('*')
         .eq('id', id)
         .maybeSingle()
@@ -210,7 +211,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
         if (input.cta !== undefined) payload.cta = input.cta
         if (input.contentMd !== undefined) payload.content_md = input.contentMd
         const { data, error } = await getClient()
-          .from('mkt_content_posts')
+          .from(T.contentPosts)
           .update(payload)
           .eq('id', input.id)
           .select('*')
@@ -223,7 +224,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
 
       // Next position within the (plan, week) group.
       const { data: maxData } = await getClient()
-        .from('mkt_content_posts')
+        .from(T.contentPosts)
         .select('position')
         .eq('plan_id', input.planId)
         .eq('week_number', week)
@@ -232,7 +233,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
       const maxPos = maxData?.[0]?.position ?? -1
 
       const { data, error } = await getClient()
-        .from('mkt_content_posts')
+        .from(T.contentPosts)
         .insert({
           tenant_id: requireTenantId(),
           plan_id: input.planId,
@@ -256,7 +257,7 @@ export function createSupabaseContentPlannerProvider(): ContentPlannerProvider {
     },
 
     async deletePost(id) {
-      await getClient().from('mkt_content_posts').delete().eq('id', id)
+      await getClient().from(T.contentPosts).delete().eq('id', id)
     },
   }
 }

package/src/data/tables.ts

@@ -0,0 +1,7 @@
+// Physical table names for the marketing plugin (plg_marketing_* prefix). Import T
+// and reference T.<key> in the data providers so a rename lands in one place.
+export const T = {
+  socialAccounts: 'plg_marketing_social_accounts',
+  contentPlans: 'plg_marketing_content_plans',
+  contentPosts: 'plg_marketing_content_posts',
+} as const

package/src/index.ts

@@ -22,7 +22,8 @@ import { createMockContentPlannerProvider } from './data/contentMock'
 import { createSupabaseContentPlannerProvider } from './data/contentSupabase'
 import { createMarketingStore } from './store'
 import { createContentPlannerStore } from './views/content/contentStore'
-import { MIGRATION_001_CONTENT_PLANNER, MIGRATION_002_MULTI_PLATFORM, MIGRATION_003_RECORDING_OPS } from './migrations'
+import { MIGRATION_000_PLG_RENAME, MIGRATION_001_CONTENT_PLANNER, MIGRATION_002_MULTI_PLATFORM, MIGRATION_003_RECORDING_OPS, MIGRATION_004_RANKLAYER } from './migrations'
+import { ranklayerConnectorDef } from './integrations/ranklayer/connectorDef'
 import { DEFAULT_CURRENCY, type MarketingCurrency } from './format'
 import { MARKETING_PRESETS, type MarketingDomain, type MarketingDomainModules } from './presets'
 import type { AcquisitionChannel, ConversionModel } from './types'
@@ -74,6 +75,8 @@ const DEFAULT_LABELS: MarketingLabels = {
   funnel: 'Funnel',
   landingPages: 'Landing pages',
   content: 'Content',
+  blog: 'Blog',
+  blogCategories: 'Categorias',
   settings: 'Settings',
 }
 
@@ -130,6 +133,8 @@ export function createMarketingPlugin(options?: MarketingPluginOptions): PluginM
         subtitle: config.labels.pageSubtitle,
         generalSettings: React.createElement(SettingsView),
         registries: marketingRegistries,
+        // Enables the "Integrações" tab (renders manifest connectors for this host).
+        hostPluginId: 'marketing',
         routeBase: '/settings/marketing',
       }))
   SettingsComponent.displayName = 'MarketingSettings'
@@ -141,12 +146,16 @@ export function createMarketingPlugin(options?: MarketingPluginOptions): PluginM
     version: '1.0.0',
     scope: options?.scope ?? 'universal',
     verticalId: options?.verticalId,
+    // Admin content-planning surface (campaigns, content calendar) — targets the
+    // saas/admin Panel world, not the ecommerce storefront/operator console.
+    scaffolds: ['saas'],
     defaultEnabled: true,
     dependencies: [],
     declaredFeatures: [
       { id: 'marketing', label: config.labels.pageTitle, group: 'Engage' },
       ...(config.modules.landingPages ? [{ id: 'marketing.landing-pages', label: config.labels.landingPages, group: 'Engage' }] : []),
       ...(config.modules.contentPlanner ? [{ id: 'marketing.content', label: config.labels.content, group: 'Engage' }] : []),
+      ...(config.modules.blog ? [{ id: 'marketing.blog', label: config.labels.blog, group: 'Engage' }] : []),
     ],
     navigation: [
       {
@@ -177,11 +186,17 @@ export function createMarketingPlugin(options?: MarketingPluginOptions): PluginM
       { name: 'marketing.content.post.updated', description: 'A content post was updated' },
     ],
     migrations: [
+      {
+        id: 'marketing-000-plg-rename',
+        version: '1.0.0',
+        sql: MIGRATION_000_PLG_RENAME,
+        description: 'Rename legacy mkt_* tables to plg_marketing_* in-place for pools provisioned before the industry-pool rename (guarded no-op on fresh pools)',
+      },
       {
         id: 'marketing-001-content-planner',
         version: '1.0.0',
         sql: MIGRATION_001_CONTENT_PLANNER,
-        description: 'Create mkt_social_accounts, mkt_content_plans and mkt_content_posts tables',
+        description: 'Create plg_marketing_social_accounts, plg_marketing_content_plans and plg_marketing_content_posts',
       },
       {
         id: 'marketing-002-multi-platform',
@@ -193,9 +208,18 @@ export function createMarketingPlugin(options?: MarketingPluginOptions): PluginM
         id: 'marketing-003-recording-ops',
         version: '1.2.0',
         sql: MIGRATION_003_RECORDING_OPS,
-        description: 'Recording-day checklist + media asset URL on posts; mkt-media storage bucket',
+        description: 'Recording-day checklist + media asset URL on posts; content-media storage bucket',
+      },
+      {
+        id: 'marketing-004-ranklayer',
+        version: '1.3.0',
+        sql: MIGRATION_004_RANKLAYER,
+        description: 'RankLayer connector state: plg_marketing_ranklayer_integrations + _sync_log (tenant RLS)',
       },
     ],
+    // RankLayer SEO connector — renders in the Integrações settings tab. Scaffold
+    // (control plane only); the real sync lands via an external PR (RANKLAYER.md).
+    connectors: [ranklayerConnectorDef],
     aiTools: [
       {
         id: 'marketing.channel-performance',

package/src/integrations/ranklayer/RANKLAYER.md

@@ -0,0 +1,40 @@
+# RankLayer connector
+
+Surfaces in **Marketing → settings → Integrações** (rendered by the shared
+`ConnectorsHub`). Follows the connector contract in
+`packages/core/src/integrations/index.ts` and mirrors the PlugBank precedent
+(`beauty-saas/src/plugins/openbanking`).
+
+## Status: SCAFFOLD
+
+This ships the control plane only:
+
+- `connectorDef.tsx` — the `ConnectorDefinition` (api-key form: API Key + site
+  domain, status badge, `ExtraPanel` with a "sync coming soon" note).
+- `data/supabase.ts` — persists the connection row and reads the sync log.
+- `../../migrations/004_ranklayer.sql` — `plg_marketing_ranklayer_integrations`
+  + `plg_marketing_ranklayer_sync_log` (tenant RLS).
+
+`testConnection` currently accepts any non-empty API key and **no real sync
+runs** — RankLayer has no public API wired yet.
+
+## What the RankLayer PR needs to fill in
+
+1. **Edge function** `functions/ranklayer-sync/index.ts` holding the RankLayer
+   API key server-side (move it out of the `api_key` column into a secret if the
+   provider requires it), with actions:
+   - `test_connection` — validate the key against RankLayer.
+   - `sync` — the agreed direction. RankLayer generates/publishes SEO pages and
+     articles, so the likely first flow is **inbound**: pull RankLayer-published
+     articles and upsert them as `plg_blog_posts` (status `published`) so they
+     appear on the site's `/blog`. Confirm direction with the RankLayer team.
+2. **Real `testConnection` / `sync`** in `data/supabase.ts` — replace the stubs
+   to invoke the edge function; write a `plg_marketing_ranklayer_sync_log` row
+   per run (the `SyncRun` audit shape).
+3. **ExtraPanel** — swap the "coming soon" note for a "Sync now" button + the
+   real history table (the history rendering is already wired).
+
+The connector is already registered on the marketing manifest
+(`connectors: [ranklayerConnectorDef]`) and the Integrações tab is enabled
+(`hostPluginId: 'marketing'` on the settings panel), so no wiring changes are
+needed — only the data-plane implementation above.