@fayz-ai/plugin-marketing 0.8.0 → 0.8.1

package/src/integrations/ranklayer/data/supabase.ts

@@ -0,0 +1,106 @@
+import { getSupabaseClientOptional, getActiveTenantId } from '@fayz-ai/core'
+import type { TestConnectionResult } from '@fayz-ai/core'
+import type { RankLayerIntegration, RankLayerSyncLogEntry } from '../types'
+
+// ---------------------------------------------------------------------------
+// RankLayer connector — control-plane client (SCAFFOLD).
+//
+// Reads/writes the connection row (plg_marketing_ranklayer_integrations) and
+// reads the sync log. `testConnection` and `sync` are stubbed: RankLayer has no
+// public API wired yet, so the real work (an edge function calling RankLayer)
+// lands via an external PR — see ../RANKLAYER.md. Everything here is safe to
+// ship: it only persists the tenant's API key + domain and surfaces status.
+// ---------------------------------------------------------------------------
+
+const INTEGRATIONS = 'plg_marketing_ranklayer_integrations'
+const SYNC_LOG = 'plg_marketing_ranklayer_sync_log'
+
+function getClient() {
+  const supabase = getSupabaseClientOptional() as { from: (t: string) => any } | null
+  if (!supabase) throw new Error('[ranklayer] Supabase not initialized')
+  return supabase
+}
+
+function requireTenantId(): string {
+  const tenantId = getActiveTenantId()
+  if (!tenantId) throw new Error('[ranklayer] No active tenant')
+  return tenantId
+}
+
+function toIntegration(row: Record<string, any>): RankLayerIntegration {
+  return {
+    id: row.id,
+    apiKey: row.api_key ?? undefined,
+    siteDomain: row.site_domain ?? undefined,
+    active: row.active ?? true,
+    lastSyncAt: row.last_sync_at ?? undefined,
+  }
+}
+
+export function createRankLayerProvider() {
+  return {
+    async getIntegration(): Promise<RankLayerIntegration | null> {
+      const tenantId = getActiveTenantId()
+      if (!tenantId) return null
+      const { data } = await getClient()
+        .from(INTEGRATIONS)
+        .select('*')
+        .eq('tenant_id', tenantId)
+        .maybeSingle()
+      return data ? toIntegration(data) : null
+    },
+
+    async saveIntegration(values: { apiKey: string; siteDomain?: string }): Promise<RankLayerIntegration> {
+      const tenantId = requireTenantId()
+      const payload = {
+        tenant_id: tenantId,
+        api_key: values.apiKey,
+        site_domain: values.siteDomain ?? null,
+        active: true,
+        updated_at: new Date().toISOString(),
+      }
+      // Upsert on the unique tenant_id.
+      const { data, error } = await getClient()
+        .from(INTEGRATIONS)
+        .upsert(payload, { onConflict: 'tenant_id' })
+        .select('*')
+        .single()
+      if (error) throw error
+      return toIntegration(data)
+    },
+
+    async disconnect(): Promise<void> {
+      const tenantId = getActiveTenantId()
+      if (!tenantId) return
+      await getClient().from(INTEGRATIONS).delete().eq('tenant_id', tenantId)
+    },
+
+    // SCAFFOLD: no RankLayer API yet — accept any non-empty key so the connect
+    // flow can be exercised. Replace with a real credential check in the PR.
+    async testConnection(values: { apiKey: string }): Promise<TestConnectionResult> {
+      if (!values.apiKey || values.apiKey.trim().length < 8) {
+        return { ok: false, message: 'Informe uma API Key válida da RankLayer.' }
+      }
+      return { ok: true, message: 'Chave aceita (validação real pendente — integração em preparação).' }
+    },
+
+    async getSyncLog(integrationId: string): Promise<RankLayerSyncLogEntry[]> {
+      const { data } = await getClient()
+        .from(SYNC_LOG)
+        .select('*')
+        .eq('integration_id', integrationId)
+        .order('created_at', { ascending: false })
+        .limit(20)
+      return (data ?? []).map((r: Record<string, any>) => ({
+        id: r.id,
+        createdAt: r.created_at,
+        status: r.status,
+        message: r.message ?? undefined,
+        fetched: r.fetched ?? 0,
+        written: r.written ?? 0,
+      }))
+    },
+  }
+}
+
+export type RankLayerProvider = ReturnType<typeof createRankLayerProvider>

package/src/integrations/ranklayer/types.ts

@@ -0,0 +1,16 @@
+export interface RankLayerIntegration {
+  id: string
+  apiKey?: string
+  siteDomain?: string
+  active: boolean
+  lastSyncAt?: string
+}
+
+export interface RankLayerSyncLogEntry {
+  id: string
+  createdAt: string
+  status: 'success' | 'partial' | 'error'
+  message?: string
+  fetched: number
+  written: number
+}

package/src/migrations/004_ranklayer.sql

@@ -0,0 +1,50 @@
+-- Marketing Plugin: RankLayer integration (SEO content publishing).
+-- Control-plane state for the RankLayer connector rendered in Marketing →
+-- Integrações. Prefix: plg_marketing_ranklayer_. Scaffold: the real sync
+-- (edge function + RankLayer API calls) lands via an external PR — see
+-- src/integrations/ranklayer/RANKLAYER.md.
+
+CREATE TABLE IF NOT EXISTS public.plg_marketing_ranklayer_integrations (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  api_key text,
+  site_domain text,
+  active boolean NOT NULL DEFAULT true,
+  last_sync_at timestamptz,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.plg_marketing_ranklayer_integrations ENABLE ROW LEVEL SECURITY;
+CREATE UNIQUE INDEX IF NOT EXISTS uq_plg_marketing_ranklayer_integrations_tenant
+  ON public.plg_marketing_ranklayer_integrations(tenant_id);
+
+CREATE TABLE IF NOT EXISTS public.plg_marketing_ranklayer_sync_log (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  integration_id uuid REFERENCES public.plg_marketing_ranklayer_integrations(id) ON DELETE CASCADE,
+  status text NOT NULL DEFAULT 'success' CHECK (status IN ('success', 'partial', 'error')),
+  message text,
+  fetched integer NOT NULL DEFAULT 0,
+  written integer NOT NULL DEFAULT 0,
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.plg_marketing_ranklayer_sync_log ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_plg_marketing_ranklayer_sync_log_tenant
+  ON public.plg_marketing_ranklayer_sync_log(tenant_id, created_at DESC);
+
+-- RLS: authenticated tenant CRUD
+DROP POLICY IF EXISTS plg_marketing_ranklayer_integrations_select ON public.plg_marketing_ranklayer_integrations;
+DROP POLICY IF EXISTS plg_marketing_ranklayer_integrations_insert ON public.plg_marketing_ranklayer_integrations;
+DROP POLICY IF EXISTS plg_marketing_ranklayer_integrations_update ON public.plg_marketing_ranklayer_integrations;
+DROP POLICY IF EXISTS plg_marketing_ranklayer_integrations_delete ON public.plg_marketing_ranklayer_integrations;
+CREATE POLICY plg_marketing_ranklayer_integrations_select ON public.plg_marketing_ranklayer_integrations FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_marketing_ranklayer_integrations_insert ON public.plg_marketing_ranklayer_integrations FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_marketing_ranklayer_integrations_update ON public.plg_marketing_ranklayer_integrations FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_marketing_ranklayer_integrations_delete ON public.plg_marketing_ranklayer_integrations FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+GRANT SELECT, INSERT, UPDATE, DELETE ON public.plg_marketing_ranklayer_integrations TO authenticated;
+
+DROP POLICY IF EXISTS plg_marketing_ranklayer_sync_log_select ON public.plg_marketing_ranklayer_sync_log;
+DROP POLICY IF EXISTS plg_marketing_ranklayer_sync_log_insert ON public.plg_marketing_ranklayer_sync_log;
+CREATE POLICY plg_marketing_ranklayer_sync_log_select ON public.plg_marketing_ranklayer_sync_log FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_marketing_ranklayer_sync_log_insert ON public.plg_marketing_ranklayer_sync_log FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+GRANT SELECT, INSERT ON public.plg_marketing_ranklayer_sync_log TO authenticated;

package/src/migrations/index.ts

@@ -1,4 +1,4 @@
-// AUTO-GENERATED from 000_plg_rename.sql, 001_content_planner.sql, 002_multi_platform.sql, 003_recording_ops.sql — regenerate with scripts/embed-migrations.mjs
+// AUTO-GENERATED from 000_plg_rename.sql, 001_content_planner.sql, 002_multi_platform.sql, 003_recording_ops.sql, 004_ranklayer.sql — regenerate with scripts/embed-migrations.mjs
 // SQL files are the source of truth; this inline copy lets the manifest declare
 // migrations as data. Do not edit by hand — run the embed script instead.
 
@@ -169,9 +169,62 @@ CREATE POLICY plg_marketing_media_update ON storage.objects FOR UPDATE TO authen
 CREATE POLICY plg_marketing_media_delete ON storage.objects FOR DELETE TO authenticated USING (bucket_id = 'mkt-media');
 `
 
+export const MIGRATION_004_RANKLAYER = `-- Marketing Plugin: RankLayer integration (SEO content publishing).
+-- Control-plane state for the RankLayer connector rendered in Marketing →
+-- Integrações. Prefix: plg_marketing_ranklayer_. Scaffold: the real sync
+-- (edge function + RankLayer API calls) lands via an external PR — see
+-- src/integrations/ranklayer/RANKLAYER.md.
+
+CREATE TABLE IF NOT EXISTS public.plg_marketing_ranklayer_integrations (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  api_key text,
+  site_domain text,
+  active boolean NOT NULL DEFAULT true,
+  last_sync_at timestamptz,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.plg_marketing_ranklayer_integrations ENABLE ROW LEVEL SECURITY;
+CREATE UNIQUE INDEX IF NOT EXISTS uq_plg_marketing_ranklayer_integrations_tenant
+  ON public.plg_marketing_ranklayer_integrations(tenant_id);
+
+CREATE TABLE IF NOT EXISTS public.plg_marketing_ranklayer_sync_log (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  integration_id uuid REFERENCES public.plg_marketing_ranklayer_integrations(id) ON DELETE CASCADE,
+  status text NOT NULL DEFAULT 'success' CHECK (status IN ('success', 'partial', 'error')),
+  message text,
+  fetched integer NOT NULL DEFAULT 0,
+  written integer NOT NULL DEFAULT 0,
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+ALTER TABLE public.plg_marketing_ranklayer_sync_log ENABLE ROW LEVEL SECURITY;
+CREATE INDEX IF NOT EXISTS idx_plg_marketing_ranklayer_sync_log_tenant
+  ON public.plg_marketing_ranklayer_sync_log(tenant_id, created_at DESC);
+
+-- RLS: authenticated tenant CRUD
+DROP POLICY IF EXISTS plg_marketing_ranklayer_integrations_select ON public.plg_marketing_ranklayer_integrations;
+DROP POLICY IF EXISTS plg_marketing_ranklayer_integrations_insert ON public.plg_marketing_ranklayer_integrations;
+DROP POLICY IF EXISTS plg_marketing_ranklayer_integrations_update ON public.plg_marketing_ranklayer_integrations;
+DROP POLICY IF EXISTS plg_marketing_ranklayer_integrations_delete ON public.plg_marketing_ranklayer_integrations;
+CREATE POLICY plg_marketing_ranklayer_integrations_select ON public.plg_marketing_ranklayer_integrations FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_marketing_ranklayer_integrations_insert ON public.plg_marketing_ranklayer_integrations FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_marketing_ranklayer_integrations_update ON public.plg_marketing_ranklayer_integrations FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_marketing_ranklayer_integrations_delete ON public.plg_marketing_ranklayer_integrations FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+GRANT SELECT, INSERT, UPDATE, DELETE ON public.plg_marketing_ranklayer_integrations TO authenticated;
+
+DROP POLICY IF EXISTS plg_marketing_ranklayer_sync_log_select ON public.plg_marketing_ranklayer_sync_log;
+DROP POLICY IF EXISTS plg_marketing_ranklayer_sync_log_insert ON public.plg_marketing_ranklayer_sync_log;
+CREATE POLICY plg_marketing_ranklayer_sync_log_select ON public.plg_marketing_ranklayer_sync_log FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+CREATE POLICY plg_marketing_ranklayer_sync_log_insert ON public.plg_marketing_ranklayer_sync_log FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+GRANT SELECT, INSERT ON public.plg_marketing_ranklayer_sync_log TO authenticated;
+`
+
 export const MIGRATIONS: Array<{ id: string; sql: string }> = [
   { id: "000_plg_rename", sql: MIGRATION_000_PLG_RENAME },
   { id: "001_content_planner", sql: MIGRATION_001_CONTENT_PLANNER },
   { id: "002_multi_platform", sql: MIGRATION_002_MULTI_PLATFORM },
   { id: "003_recording_ops", sql: MIGRATION_003_RECORDING_OPS },
+  { id: "004_ranklayer", sql: MIGRATION_004_RANKLAYER },
 ]

package/src/presets.ts

@@ -16,6 +16,8 @@ export interface MarketingDomainModules {
   landingPages: boolean
   /** Social content planner — accounts, week board, markdown post pages. */
   contentPlanner: boolean
+  /** Blog backoffice — posts + categories CMS feeding @fayz-ai/plugin-blog. Off by default. */
+  blog: boolean
   /** Outbound — reserved, off by default, implemented in a later milestone. */
   broadcasts: boolean
   journeys: boolean
@@ -44,7 +46,7 @@ const AGENCY: MarketingDomainPreset = {
     { id: 'referral', label: 'Referral', icon: 'Users', kind: 'referral' },
     { id: 'direct', label: 'Direct', icon: 'MousePointerClick', kind: 'direct' },
   ],
-  modules: { channels: true, campaigns: true, funnel: true, landingPages: true, contentPlanner: false, broadcasts: false, journeys: false },
+  modules: { channels: true, campaigns: true, funnel: true, landingPages: true, contentPlanner: false, blog: false, broadcasts: false, journeys: false },
 }
 
 const BEAUTY: MarketingDomainPreset = {
@@ -63,7 +65,7 @@ const BEAUTY: MarketingDomainPreset = {
     { id: 'whatsapp', label: 'WhatsApp', icon: 'MessageCircle', kind: 'social' },
     { id: 'walkin', label: 'Walk-in', icon: 'DoorOpen', kind: 'direct' },
   ],
-  modules: { channels: true, campaigns: true, funnel: true, landingPages: false, contentPlanner: true, broadcasts: false, journeys: false },
+  modules: { channels: true, campaigns: true, funnel: true, landingPages: false, contentPlanner: true, blog: false, broadcasts: false, journeys: false },
 }
 
 const RESTO: MarketingDomainPreset = {
@@ -82,7 +84,7 @@ const RESTO: MarketingDomainPreset = {
     { id: 'instagram', label: 'Instagram', icon: 'Instagram', kind: 'social' },
     { id: 'walkin', label: 'Walk-in', icon: 'DoorOpen', kind: 'direct' },
   ],
-  modules: { channels: true, campaigns: true, funnel: true, landingPages: false, contentPlanner: false, broadcasts: false, journeys: false },
+  modules: { channels: true, campaigns: true, funnel: true, landingPages: false, contentPlanner: false, blog: false, broadcasts: false, journeys: false },
 }
 
 export const MARKETING_PRESETS: Record<MarketingDomain, MarketingDomainPreset> = {

package/src/views/blog/BlogAdminView.tsx

@@ -0,0 +1,99 @@
+import React, { useEffect, useMemo, useState } from 'react'
+import { CrudListView } from '@fayz-ai/saas'
+import { SegmentedControl } from '@fayz-ai/ui'
+import { useMarketingConfig } from '../../MarketingContext'
+import { buildBlogPostEntity, buildBlogCategoryEntity } from '../../data/blogEntities'
+import { useEntityCrud } from './useEntityCrud'
+
+// ---------------------------------------------------------------------------
+// Blog backoffice — an in-page marketing tab with two lenses (Posts /
+// Categories), each a generic CrudListView backed by the blog tables. Follows
+// the content-planner pattern: this plugin owns the data + routing; create/edit
+// deep-link through the marketing module nav (navigate('blog-post:id') etc.).
+// ---------------------------------------------------------------------------
+
+function PostsList({ navigate }: { navigate: (view: string) => void }) {
+  const entity = useMemo(() => buildBlogPostEntity(), [])
+  const { items, total, fetch } = useEntityCrud(entity)
+  const [search, setSearch] = useState('')
+  const [statusFilter, setStatusFilter] = useState<string | undefined>()
+  const [loadedOnce, setLoadedOnce] = useState(false)
+
+  useEffect(() => {
+    let active = true
+    Promise.resolve(
+      fetch({ search: search || undefined, filters: statusFilter ? { status: statusFilter } : undefined }),
+    ).finally(() => { if (active) setLoadedOnce(true) })
+    return () => { active = false }
+  }, [search, statusFilter, fetch])
+
+  const facets = useMemo(() => [{
+    field: 'status',
+    allLabel: 'All',
+    options: [{ value: 'draft', label: 'Draft' }, { value: 'published', label: 'Published' }],
+  }], [])
+
+  return (
+    <CrudListView
+      entityDef={entity}
+      items={loadedOnce ? items : null}
+      total={total}
+      search={search}
+      onSearchChange={setSearch}
+      searchPlaceholder="Search posts…"
+      facets={facets}
+      activeFilters={{ status: statusFilter }}
+      onFacetChange={(_field, value) => setStatusFilter(value)}
+      onNew={() => navigate('blog-new')}
+      addLabel="New post"
+      onRowClick={(row) => navigate(`blog-post:${(row as { id: string }).id}`)}
+    />
+  )
+}
+
+function CategoriesList({ navigate }: { navigate: (view: string) => void }) {
+  const entity = useMemo(() => buildBlogCategoryEntity(), [])
+  const { items, total, fetch } = useEntityCrud(entity)
+  const [search, setSearch] = useState('')
+  const [loadedOnce, setLoadedOnce] = useState(false)
+
+  useEffect(() => {
+    let active = true
+    Promise.resolve(fetch({ search: search || undefined })).finally(() => { if (active) setLoadedOnce(true) })
+    return () => { active = false }
+  }, [search, fetch])
+
+  return (
+    <CrudListView
+      entityDef={entity}
+      items={loadedOnce ? items : null}
+      total={total}
+      search={search}
+      onSearchChange={setSearch}
+      searchPlaceholder="Search categories…"
+      onNew={() => navigate('blog-cat-new')}
+      addLabel="New category"
+      onRowClick={(row) => navigate(`blog-cat:${(row as { id: string }).id}`)}
+    />
+  )
+}
+
+export function BlogAdminView({ navigate }: { navigate: (view: string) => void }) {
+  const { labels } = useMarketingConfig()
+  const [lens, setLens] = useState<'posts' | 'categories'>('posts')
+
+  return (
+    <div className="space-y-4">
+      <SegmentedControl
+        aria-label="Blog section"
+        options={[
+          { value: 'posts', label: labels.blog },
+          { value: 'categories', label: labels.blogCategories },
+        ]}
+        value={lens}
+        onChange={(v) => setLens(v as 'posts' | 'categories')}
+      />
+      {lens === 'posts' ? <PostsList navigate={navigate} /> : <CategoriesList navigate={navigate} />}
+    </div>
+  )
+}

package/src/views/blog/BlogEntityForm.tsx

@@ -0,0 +1,92 @@
+import React from 'react'
+import { SubpageHeader, Button, toast } from '@fayz-ai/ui'
+import { CrudFormPage } from '@fayz-ai/saas'
+import type { EntityDef } from '@fayz-ai/core'
+import { useEntityCrud } from './useEntityCrud'
+
+// ---------------------------------------------------------------------------
+// Generic create/edit for a blog entity (post or category), rendered through
+// the shared CrudFormPage (declarative EntityDef → fields, incl. the markdown
+// body + category relation). Persistence flows through the generic Supabase
+// provider; this only wires load / save / delete + the back link.
+// ---------------------------------------------------------------------------
+
+export function BlogEntityForm<T extends { id: string }>({
+  entity,
+  editId,
+  parentLabel,
+  onDone,
+}: {
+  entity: EntityDef<T>
+  editId?: string
+  parentLabel: string
+  onDone: () => void
+}) {
+  const { getById, create, update, remove } = useEntityCrud(entity)
+  const isEdit = !!editId
+  const namePlural = entity.namePlural ?? entity.name + 's'
+  const [initialData, setInitialData] = React.useState<Record<string, any> | null>(isEdit ? null : {})
+
+  React.useEffect(() => {
+    if (!editId) return
+    let cancelled = false
+    ;(async () => {
+      const item = await getById(editId)
+      if (!cancelled) setInitialData((item as Record<string, any>) ?? {})
+    })()
+    return () => { cancelled = true }
+  }, [editId, getById])
+
+  async function save(values: Record<string, any>) {
+    try {
+      if (isEdit) await update(editId!, values)
+      else await create(values)
+      toast.success(isEdit ? `${entity.name} updated` : `${entity.name} created`)
+      onDone()
+    } catch (err) {
+      toast.error(`Failed to save ${entity.name.toLowerCase()}`)
+      throw err
+    }
+  }
+
+  async function del() {
+    if (!editId) return
+    try {
+      await remove(editId)
+      toast.success(`${entity.name} deleted`)
+      onDone()
+    } catch {
+      toast.error(`Failed to delete ${entity.name.toLowerCase()}`)
+    }
+  }
+
+  const title = isEdit
+    ? (initialData?.[entity.displayField ?? 'name'] ?? entity.name)
+    : `New ${entity.name.toLowerCase()}`
+
+  return (
+    <div className="space-y-4">
+      <SubpageHeader
+        title={String(title)}
+        onBack={onDone}
+        parentLabel={parentLabel}
+        actions={isEdit ? (
+          <Button variant="ghost" className="text-destructive hover:text-destructive" onClick={del}>
+            Delete
+          </Button>
+        ) : undefined}
+      />
+      {initialData !== null && (
+        <CrudFormPage
+          entityDef={entity}
+          mode={isEdit ? 'edit' : 'create'}
+          initialData={initialData}
+          namePlural={namePlural}
+          onCancel={onDone}
+          onSubmit={save}
+          hideBreadcrumb
+        />
+      )}
+    </div>
+  )
+}

package/src/views/blog/useEntityCrud.ts

@@ -0,0 +1,50 @@
+import { useMemo, useState, useCallback } from 'react'
+import { resolveDataProvider } from '@fayz-ai/core'
+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 function useEntityCrud<T extends { id: string }>(entity: EntityDef<T>) {
+  const provider = useMemo(() => resolveDataProvider<T>(entity), [entity])
+  const [items, setItems] = useState<T[] | null>(null)
+  const [total, setTotal] = useState(0)
+
+  const fetch = useCallback(async (query: ListQuery = {}) => {
+    try {
+      const res = await provider.list(query as any)
+      setItems(res.data)
+      setTotal(res.total)
+    } catch (err) {
+      // Table not provisioned yet (migration not applied to this pool) or a
+      // transient error — surface an empty list instead of a perpetual skeleton.
+      console.warn('[blog] list failed; showing empty. Apply the plugin-blog migration to this pool.', err)
+      setItems([])
+      setTotal(0)
+    }
+  }, [provider])
+
+  const getById = useCallback(async (id: string): Promise<T | null> => {
+    const res = await provider.list({ filters: { id }, page: 1, pageSize: 1 } as any)
+    return res.data[0] ?? null
+  }, [provider])
+
+  const create = useCallback((data: Record<string, unknown>) => provider.create(data as any), [provider])
+  const update = useCallback((id: string, data: Record<string, unknown>) => provider.update(id, data as any), [provider])
+  const remove = useCallback((id: string) => provider.remove(id), [provider])
+
+  return { items, total, fetch, getById, create, update, remove }
+}