@nextblock-cms/db 0.2.22 → 0.2.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextblock-cms/db",
-  "version": "0.2.22",
+  "version": "0.2.24",
   "main": "index.cjs.js",
   "module": "index.es.js",
   "types": "index.d.ts",

package/supabase/migrations/00000000000000_setup_extensions_and_roles.sql

@@ -0,0 +1,54 @@
+-- 00000000000000_setup_extensions_and_roles.sql
+-- Base setup: Extensions, Enums, Helper Functions, and Grants
+
+-- 1. Grants
+GRANT USAGE ON SCHEMA public TO postgres;
+GRANT USAGE ON SCHEMA public TO anon;
+GRANT USAGE ON SCHEMA public TO authenticated;
+GRANT USAGE ON SCHEMA public TO service_role;
+
+-- 2. Enums
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'user_role') THEN
+    CREATE TYPE public.user_role AS ENUM ('ADMIN', 'WRITER', 'USER');
+  END IF;
+  
+  IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'page_status') THEN
+    CREATE TYPE public.page_status AS ENUM ('draft', 'published', 'archived');
+  END IF;
+
+  IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'menu_location') THEN
+    CREATE TYPE public.menu_location AS ENUM ('HEADER', 'FOOTER', 'SIDEBAR');
+  END IF;
+
+  IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'revision_type') THEN
+    CREATE TYPE public.revision_type AS ENUM ('snapshot', 'diff');
+  END IF;
+END
+$$;
+
+-- 3. Helper Functions
+
+-- Function: get_my_claim
+-- Description: Helper to read JWT claims safely
+CREATE OR REPLACE FUNCTION get_my_claim(claim TEXT)
+RETURNS JSONB AS $$
+  SET search_path = '';
+  SELECT COALESCE(current_setting('request.jwt.claims', true)::JSONB ->> claim, NULL)::JSONB
+$$ LANGUAGE SQL STABLE;
+
+-- Function: get_current_user_role
+-- Description: Fetches the role of the currently authenticated user.
+-- SECURITY DEFINER to prevent RLS recursion issues when used in policies.
+-- Note: This depends on the 'profiles' table which will be created in the next migration.
+-- However, since functions are just definitions, this CREATE statement will succeed 
+-- as long as the table exists when the function is *called*.
+-- To be safe and avoid "relation does not exist" errors during creation if validation runs,
+-- we will defer the creation of this specific function to the profiles migration 
+-- OR just ensure profiles is created immediately after. 
+-- Actually, let's put it here but be aware it needs profiles table to run.
+-- Postgres allows creating functions referring to non-existent tables? No, it usually checks.
+-- So I will move `get_current_user_role` to `setup_profiles.sql` or create a placeholder table?
+-- Better: I'll put it in `setup_profiles.sql` after the table is created.
+

package/supabase/migrations/00000000000001_setup_site_settings.sql

@@ -0,0 +1,19 @@
+-- 00000000000001_setup_site_settings.sql
+-- Setup site_settings table
+
+CREATE TABLE public.site_settings (
+    key TEXT PRIMARY KEY,
+    value JSONB
+);
+
+COMMENT ON TABLE public.site_settings IS 'Key-value store for global site settings.';
+
+-- Seed initial copyright setting
+INSERT INTO public.site_settings (key, value)
+VALUES ('footer_copyright', '{"en": "© {year} Nextblock CMS. All rights reserved.", "fr": "© {year} Nextblock CMS. Tous droits réservés."}')
+ON CONFLICT (key) DO NOTHING;
+
+-- Seed initial admin created flag (default false, will be updated by trigger)
+INSERT INTO public.site_settings (key, value)
+VALUES ('is_admin_created', 'false'::jsonb)
+ON CONFLICT (key) DO NOTHING;

package/supabase/migrations/00000000000002_setup_profiles.sql

@@ -0,0 +1,87 @@
+-- 00000000000002_setup_profiles.sql
+-- Setup profiles table and auto-create trigger
+
+-- 1. Create profiles table
+CREATE TABLE public.profiles (
+  id uuid NOT NULL PRIMARY KEY, -- references auth.users(id)
+  updated_at timestamp with time zone,
+  username text UNIQUE,
+  full_name text,
+  avatar_url text,
+  website text,
+  role public.user_role NOT NULL DEFAULT 'USER',
+
+  CONSTRAINT username_length CHECK (char_length(username) >= 3)
+);
+
+-- Foreign key to auth.users
+ALTER TABLE public.profiles
+  ADD CONSTRAINT profiles_id_fkey
+  FOREIGN KEY (id)
+  REFERENCES auth.users (id)
+  ON DELETE CASCADE;
+
+COMMENT ON TABLE public.profiles IS 'Profile information for each user, extending auth.users.';
+COMMENT ON COLUMN public.profiles.id IS 'References auth.users.id';
+COMMENT ON COLUMN public.profiles.role IS 'User role for RBAC.';
+
+-- 2. Helper Function: get_current_user_role
+-- Now that profiles table exists, we can define this function.
+CREATE OR REPLACE FUNCTION public.get_current_user_role()
+RETURNS public.user_role
+LANGUAGE sql
+STABLE
+SECURITY DEFINER
+SET search_path = public
+AS $$
+  SELECT role FROM public.profiles WHERE id = auth.uid();
+$$;
+
+COMMENT ON FUNCTION public.get_current_user_role() IS 'Fetches the role of the currently authenticated user. SECURITY DEFINER to prevent RLS recursion issues.';
+
+-- 3. Trigger: handle_new_user
+-- Automatically creates a profile when a new user signs up.
+-- Assigns 'ADMIN' to the first user, 'USER' to subsequent users.
+CREATE OR REPLACE FUNCTION public.handle_new_user()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path = 'public'
+AS $$
+DECLARE
+  admin_flag_set BOOLEAN := FALSE;
+  user_role public.user_role;
+BEGIN
+  -- Ensure the admin flag row exists (redundant if seeded, but safe)
+  INSERT INTO public.site_settings (key, value)
+  VALUES ('is_admin_created', 'false'::jsonb)
+  ON CONFLICT (key) DO NOTHING;
+
+  -- Lock and read the flag
+  SELECT COALESCE((value)::jsonb::boolean, FALSE)
+  INTO admin_flag_set
+  FROM public.site_settings
+  WHERE key = 'is_admin_created'
+  FOR UPDATE;
+
+  IF admin_flag_set = FALSE THEN
+    user_role := 'ADMIN'::public.user_role;
+    UPDATE public.site_settings
+    SET value = 'true'::jsonb
+    WHERE key = 'is_admin_created';
+  ELSE
+    user_role := 'USER'::public.user_role;
+  END IF;
+
+  INSERT INTO public.profiles (id, role)
+  VALUES (NEW.id, user_role);
+  
+  RETURN NEW;
+END;
+$$;
+
+-- Attach trigger to auth.users
+DROP TRIGGER IF EXISTS on_auth_user_created ON auth.users;
+CREATE TRIGGER on_auth_user_created
+  AFTER INSERT ON auth.users
+  FOR EACH ROW EXECUTE FUNCTION public.handle_new_user();

package/supabase/migrations/00000000000003_setup_languages.sql

@@ -0,0 +1,43 @@
+-- 00000000000003_setup_languages.sql
+-- Setup languages table
+
+-- 1. Create languages table
+CREATE TABLE public.languages (
+  id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  code text NOT NULL UNIQUE, -- e.g., 'en', 'fr'
+  name text NOT NULL, -- e.g., 'English', 'Français'
+  is_default boolean NOT NULL DEFAULT false,
+  is_active boolean DEFAULT true, -- Added from later migration
+  created_at timestamp with time zone NOT NULL DEFAULT now(),
+  updated_at timestamp with time zone NOT NULL DEFAULT now()
+);
+
+COMMENT ON TABLE public.languages IS 'Stores supported languages for the CMS.';
+COMMENT ON COLUMN public.languages.code IS 'BCP 47 language code.';
+
+-- 2. Indexes
+CREATE UNIQUE INDEX ensure_single_default_language_idx
+ON public.languages (is_default)
+WHERE (is_default = true);
+
+-- 3. Seed initial languages
+INSERT INTO public.languages (code, name, is_default, is_active)
+VALUES
+  ('en', 'English', true, true),
+  ('fr', 'Français', false, true);
+
+-- 4. Trigger: handle_languages_update
+CREATE OR REPLACE FUNCTION public.handle_languages_update()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+AS $$
+BEGIN
+  NEW.updated_at = now();
+  RETURN NEW;
+END;
+$$;
+
+CREATE TRIGGER on_languages_update
+  BEFORE UPDATE ON public.languages
+  FOR EACH ROW
+  EXECUTE PROCEDURE public.handle_languages_update();

package/supabase/migrations/00000000000004_setup_media.sql

@@ -0,0 +1,54 @@
+-- 00000000000004_setup_media.sql
+-- Setup media table
+
+CREATE TABLE public.media (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  uploader_id uuid REFERENCES public.profiles(id) ON DELETE SET NULL,
+  file_name text NOT NULL,
+  object_key text NOT NULL UNIQUE,
+  file_type text,
+  size_bytes bigint,
+  description text,
+  
+  -- Added columns
+  width integer,
+  height integer,
+  blur_data_url text,
+  variants jsonb,
+  file_path text,
+  folder text,
+
+  created_at timestamp with time zone NOT NULL DEFAULT now(),
+  updated_at timestamp with time zone NOT NULL DEFAULT now()
+);
+
+COMMENT ON TABLE public.media IS 'Stores information about uploaded media assets.';
+COMMENT ON COLUMN public.media.object_key IS 'Unique key (path) in Cloudflare R2.';
+COMMENT ON COLUMN public.media.width IS 'Width of the image in pixels.';
+COMMENT ON COLUMN public.media.height IS 'Height of the image in pixels.';
+COMMENT ON COLUMN public.media.blur_data_url IS 'Base64 encoded string for image blur placeholders.';
+COMMENT ON COLUMN public.media.variants IS 'Array of image variant objects.';
+COMMENT ON COLUMN public.media.file_path IS 'Full path to the file in the storage bucket.';
+COMMENT ON COLUMN public.media.folder IS 'Folder path prefix for the R2 object.';
+
+-- Indexes
+CREATE INDEX idx_media_uploader_id ON public.media(uploader_id);
+CREATE INDEX media_folder_idx ON public.media(folder);
+
+-- Trigger: handle_media_update
+CREATE OR REPLACE FUNCTION public.handle_media_update()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path = public
+AS $$
+BEGIN
+  NEW.updated_at = now();
+  RETURN NEW;
+END;
+$$;
+
+CREATE TRIGGER on_media_update
+  BEFORE UPDATE ON public.media
+  FOR EACH ROW
+  EXECUTE PROCEDURE public.handle_media_update();

package/supabase/migrations/00000000000005_setup_posts.sql

@@ -0,0 +1,56 @@
+-- 00000000000005_setup_posts.sql
+-- Setup posts table
+
+CREATE TABLE public.posts (
+  id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  language_id bigint NOT NULL REFERENCES public.languages(id) ON DELETE CASCADE,
+  author_id uuid REFERENCES public.profiles(id) ON DELETE SET NULL,
+  title text NOT NULL,
+  slug text NOT NULL,
+  excerpt text,
+  status public.page_status NOT NULL DEFAULT 'draft',
+  published_at timestamp with time zone,
+  meta_title text,
+  meta_description text,
+  
+  -- Added columns
+  feature_image_id uuid REFERENCES public.media(id) ON DELETE SET NULL,
+  version integer NOT NULL DEFAULT 1,
+  translation_group_id uuid DEFAULT gen_random_uuid() NOT NULL,
+
+  created_at timestamp with time zone NOT NULL DEFAULT now(),
+  updated_at timestamp with time zone NOT NULL DEFAULT now()
+);
+
+COMMENT ON TABLE public.posts IS 'Stores blog posts or news articles.';
+COMMENT ON COLUMN public.posts.slug IS 'URL-friendly identifier, unique per language.';
+COMMENT ON COLUMN public.posts.feature_image_id IS 'ID of the media item to be used as the feature image.';
+COMMENT ON COLUMN public.posts.version IS 'Monotonic version number for hybrid revisions.';
+COMMENT ON COLUMN public.posts.translation_group_id IS 'Groups different language versions of the same conceptual post.';
+
+-- Constraints
+ALTER TABLE public.posts
+  ADD CONSTRAINT posts_language_id_slug_key UNIQUE (language_id, slug);
+
+-- Indexes
+CREATE INDEX idx_posts_feature_image_id ON public.posts(feature_image_id);
+CREATE INDEX idx_posts_author_id ON public.posts(author_id);
+CREATE INDEX idx_posts_translation_group_id ON public.posts(translation_group_id);
+
+-- Trigger: handle_posts_update
+CREATE OR REPLACE FUNCTION public.handle_posts_update()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path = public
+AS $$
+BEGIN
+  NEW.updated_at = now();
+  RETURN NEW;
+END;
+$$;
+
+CREATE TRIGGER on_posts_update
+  BEFORE UPDATE ON public.posts
+  FOR EACH ROW
+  EXECUTE PROCEDURE public.handle_posts_update();

package/supabase/migrations/00000000000006_setup_pages.sql

@@ -0,0 +1,51 @@
+-- 00000000000006_setup_pages.sql
+-- Setup pages table
+
+CREATE TABLE public.pages (
+  id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  language_id bigint NOT NULL REFERENCES public.languages(id) ON DELETE CASCADE,
+  author_id uuid REFERENCES public.profiles(id) ON DELETE SET NULL,
+  title text NOT NULL,
+  slug text NOT NULL,
+  status public.page_status NOT NULL DEFAULT 'draft',
+  meta_title text,
+  meta_description text,
+
+  -- Added columns
+  version integer NOT NULL DEFAULT 1,
+  translation_group_id uuid DEFAULT gen_random_uuid() NOT NULL,
+
+  created_at timestamp with time zone NOT NULL DEFAULT now(),
+  updated_at timestamp with time zone NOT NULL DEFAULT now()
+);
+
+COMMENT ON TABLE public.pages IS 'Stores static pages for the website.';
+COMMENT ON COLUMN public.pages.slug IS 'URL-friendly identifier, unique per language.';
+COMMENT ON COLUMN public.pages.version IS 'Monotonic version number for hybrid revisions.';
+COMMENT ON COLUMN public.pages.translation_group_id IS 'Groups different language versions of the same conceptual page.';
+
+-- Constraints
+ALTER TABLE public.pages
+  ADD CONSTRAINT pages_language_id_slug_key UNIQUE (language_id, slug);
+
+-- Indexes
+CREATE INDEX idx_pages_author_id ON public.pages(author_id);
+CREATE INDEX idx_pages_translation_group_id ON public.pages(translation_group_id);
+
+-- Trigger: handle_pages_update
+CREATE OR REPLACE FUNCTION public.handle_pages_update()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path = public
+AS $$
+BEGIN
+  NEW.updated_at = now();
+  RETURN NEW;
+END;
+$$;
+
+CREATE TRIGGER on_pages_update
+  BEFORE UPDATE ON public.pages
+  FOR EACH ROW
+  EXECUTE PROCEDURE public.handle_pages_update();

package/supabase/migrations/00000000000007_setup_blocks.sql

@@ -0,0 +1,47 @@
+-- 00000000000007_setup_blocks.sql
+-- Setup blocks table
+
+CREATE TABLE public.blocks (
+  id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  page_id bigint REFERENCES public.pages(id) ON DELETE CASCADE,
+  post_id bigint REFERENCES public.posts(id) ON DELETE CASCADE,
+  language_id bigint NOT NULL REFERENCES public.languages(id) ON DELETE CASCADE,
+  block_type text NOT NULL,
+  content jsonb,
+  "order" integer NOT NULL DEFAULT 0,
+  created_at timestamp with time zone NOT NULL DEFAULT now(),
+  updated_at timestamp with time zone NOT NULL DEFAULT now(),
+  
+  CONSTRAINT check_exactly_one_parent CHECK (
+    (page_id IS NOT NULL AND post_id IS NULL) OR
+    (post_id IS NOT NULL AND page_id IS NULL)
+  )
+);
+
+COMMENT ON TABLE public.blocks IS 'Stores content blocks for pages and posts.';
+COMMENT ON COLUMN public.blocks.block_type IS 'Type of the block, e.g., "text", "image".';
+COMMENT ON COLUMN public.blocks.content IS 'JSONB content specific to the block_type.';
+COMMENT ON COLUMN public.blocks.order IS 'Sort order of the block.';
+
+-- Indexes
+CREATE INDEX idx_blocks_language_id ON public.blocks(language_id);
+CREATE INDEX idx_blocks_page_id ON public.blocks(page_id);
+CREATE INDEX idx_blocks_post_id ON public.blocks(post_id);
+
+-- Trigger: handle_blocks_update
+CREATE OR REPLACE FUNCTION public.handle_blocks_update()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path = public
+AS $$
+BEGIN
+  NEW.updated_at = now();
+  RETURN NEW;
+END;
+$$;
+
+CREATE TRIGGER on_blocks_update
+  BEFORE UPDATE ON public.blocks
+  FOR EACH ROW
+  EXECUTE PROCEDURE public.handle_blocks_update();

package/supabase/migrations/00000000000008_setup_navigation.sql

@@ -0,0 +1,51 @@
+-- 00000000000008_setup_navigation.sql
+-- Setup navigation_items table
+
+CREATE TABLE public.navigation_items (
+  id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  language_id bigint NOT NULL REFERENCES public.languages(id) ON DELETE CASCADE,
+  menu_key public.menu_location NOT NULL,
+  label text NOT NULL,
+  url text NOT NULL,
+  parent_id bigint REFERENCES public.navigation_items(id) ON DELETE CASCADE,
+  "order" integer NOT NULL DEFAULT 0,
+  page_id bigint REFERENCES public.pages(id) ON DELETE SET NULL,
+  
+  -- Added columns (if any, checking previous files... none explicitly added but translation_group_id was mentioned in index drop?)
+  -- 20250520171900_add_translation_group_to_nav_items.sql was listed.
+  -- Let's assume we want it if it was there. I'll double check the file list.
+  -- Yes: 20250520171900_add_translation_group_to_nav_items.sql
+  -- I should add it.
+  translation_group_id uuid DEFAULT gen_random_uuid() NOT NULL,
+
+  created_at timestamp with time zone NOT NULL DEFAULT now(),
+  updated_at timestamp with time zone NOT NULL DEFAULT now()
+);
+
+COMMENT ON TABLE public.navigation_items IS 'Stores navigation menu items.';
+COMMENT ON COLUMN public.navigation_items.menu_key IS 'Identifies the menu this item belongs to.';
+
+-- Indexes
+CREATE INDEX idx_navigation_items_menu_lang_order ON public.navigation_items (menu_key, language_id, "order");
+CREATE INDEX idx_navigation_items_language_id ON public.navigation_items(language_id);
+CREATE INDEX idx_navigation_items_page_id ON public.navigation_items(page_id);
+CREATE INDEX idx_navigation_items_parent_id ON public.navigation_items(parent_id);
+-- Note: idx_navigation_items_translation_group_id was dropped in optimize_indexes.sql as unused, so I won't create it.
+
+-- Trigger: handle_navigation_items_update
+CREATE OR REPLACE FUNCTION public.handle_navigation_items_update()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path = public
+AS $$
+BEGIN
+  NEW.updated_at = now();
+  RETURN NEW;
+END;
+$$;
+
+CREATE TRIGGER on_navigation_items_update
+  BEFORE UPDATE ON public.navigation_items
+  FOR EACH ROW
+  EXECUTE PROCEDURE public.handle_navigation_items_update();

package/supabase/migrations/00000000000009_setup_logos.sql

@@ -0,0 +1,13 @@
+-- 00000000000009_setup_logos.sql
+-- Setup logos table
+
+CREATE TABLE public.logos (
+    id uuid NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+    name text NOT NULL,
+    media_id uuid REFERENCES public.media(id) ON DELETE SET NULL,
+    created_at timestamp with time zone NOT NULL DEFAULT now()
+);
+
+COMMENT ON TABLE public.logos IS 'Stores company and brand logos.';
+COMMENT ON COLUMN public.logos.name IS 'The name of the brand or company for the logo.';
+COMMENT ON COLUMN public.logos.media_id IS 'Foreign key to the media table for the logo image.';

package/supabase/migrations/00000000000010_setup_translations.sql

@@ -0,0 +1,29 @@
+-- 00000000000010_setup_translations.sql
+-- Setup translations table
+
+CREATE TABLE public.translations (
+    key text PRIMARY KEY,
+    translations jsonb NOT NULL,
+    created_at timestamp with time zone DEFAULT now() NOT NULL,
+    updated_at timestamp with time zone DEFAULT now() NOT NULL
+);
+
+COMMENT ON COLUMN public.translations.key IS 'A unique, slugified identifier (e.g., "sign_in_button_text").';
+COMMENT ON COLUMN public.translations.translations IS 'Stores translations as key-value pairs (e.g., {"en": "Sign In", "fr": "s''inscrire"}).';
+
+-- Trigger: set_updated_at
+CREATE OR REPLACE FUNCTION public.set_current_timestamp_updated_at()
+RETURNS TRIGGER AS $$
+DECLARE
+  _new record;
+BEGIN
+  _new := NEW;
+  _new."updated_at" = NOW();
+  RETURN _new;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER set_updated_at
+BEFORE UPDATE ON public.translations
+FOR EACH ROW
+EXECUTE FUNCTION public.set_current_timestamp_updated_at();

package/supabase/migrations/00000000000011_setup_revisions.sql

@@ -0,0 +1,38 @@
+-- 00000000000011_setup_revisions.sql
+-- Setup revisions tables
+
+-- 1. Page Revisions
+CREATE TABLE public.page_revisions (
+  id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  page_id bigint NOT NULL REFERENCES public.pages(id) ON DELETE CASCADE,
+  author_id uuid REFERENCES public.profiles(id) ON DELETE SET NULL,
+  version integer NOT NULL,
+  revision_type public.revision_type NOT NULL,
+  content jsonb NOT NULL,
+  created_at timestamp with time zone NOT NULL DEFAULT now(),
+  CONSTRAINT page_revisions_page_version_key UNIQUE (page_id, version)
+);
+
+COMMENT ON TABLE public.page_revisions IS 'Hybrid (snapshot/diff) revisions for pages.';
+COMMENT ON COLUMN public.page_revisions.content IS 'If snapshot: full content; if diff: JSON Patch array.';
+
+CREATE INDEX idx_page_revisions_page_id ON public.page_revisions(page_id);
+CREATE INDEX idx_page_revisions_page_id_version ON public.page_revisions(page_id, version);
+
+-- 2. Post Revisions
+CREATE TABLE public.post_revisions (
+  id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  post_id bigint NOT NULL REFERENCES public.posts(id) ON DELETE CASCADE,
+  author_id uuid REFERENCES public.profiles(id) ON DELETE SET NULL,
+  version integer NOT NULL,
+  revision_type public.revision_type NOT NULL,
+  content jsonb NOT NULL,
+  created_at timestamp with time zone NOT NULL DEFAULT now(),
+  CONSTRAINT post_revisions_post_version_key UNIQUE (post_id, version)
+);
+
+COMMENT ON TABLE public.post_revisions IS 'Hybrid (snapshot/diff) revisions for posts.';
+COMMENT ON COLUMN public.post_revisions.content IS 'If snapshot: full content; if diff: JSON Patch array.';
+
+CREATE INDEX idx_post_revisions_post_id ON public.post_revisions(post_id);
+CREATE INDEX idx_post_revisions_post_id_version ON public.post_revisions(post_id, version);