AI-Powered Content Pipelines & GraphQL Enhancements

📋 Overview

Version 3.5.0 brings a significant leap in how FlowCMS handles content orchestration. We've rebuilt our pipeline engine from the ground up to support AI-assisted transformations, reduced API latency by 40%, and introduced native support for GraphQL subscriptions in real-time content feeds.

This release is fully backward compatible with v3.4.x, though we highly recommend reviewing the breaking changes section if you're utilizing custom middleware or legacy REST endpoints.

🚀 New Features

AI-Powered Content Pipelines

Create automated workflows that trigger on content publish, update, or deletion. Use our new @trigger directive to pipe content through AI summarization, image optimization, or multilingual translation without writing custom code.

type Article @model {
  id: ID!
  title: String!
  body: Markdown!
  summary: String @ai(generate: "summary", maxTokens: 150)
  translations: [Translation!] @trigger(event: "publish", action: "translate")
}

GraphQL Subscriptions & Real-Time Feeds

Stream content changes directly to your frontend or edge functions. Subscriptions now support filtering by content type, author, and custom metadata fields.

const { data } = useSubscription(
  gql`
    subscription OnContentPublished($contentType: String!) {
      contentPublished(contentType: $contentType) {
        id
        title
        status
        publishedAt
      }
    }
  `,
  { variables: { contentType: "blog_post" } }
);
console.log("New content:", data?.contentPublished);

Edge Cache Purge API

Purge specific CDN paths instantly via our new REST endpoint. Supports glob patterns and tag-based invalidation for precise cache management.

⚡ Improvements

• API Latency: Average response time reduced from 120ms to 72ms on standard tier endpoints.
• CLI v3.2: Added flowcms doctor command to diagnose authentication, network, and config issues automatically.
• Markdown Parser: Upgraded to CommonMark 0.31 with native support for GitHub-flavored tables and task lists.
• Webhook Retries: Exponential backoff now includes jitter to prevent thundering herd problems during high-traffic releases.
• Dashboard UX: Content tree now supports virtualized scrolling for projects with 10,000+ entries.

🐛 Bug Fixes

• Fixed null reference error when filtering by array fields in GraphQL queries.
• Resolved race condition in concurrent webhook deliveries causing duplicate payloads.
• Corrected timezone handling in publishedAt field returning UTC instead of configured locale.
• Fixed image transformation URL generation when using custom CDN domains.
• Patched XSS vulnerability in rich-text preview sandbox (CVE-2024-XXXXX).

⚠️ Breaking Changes

Legacy REST Endpoints Deprecation

The /api/v1/content route has been officially removed. All clients must migrate to /api/v2 or the GraphQL endpoint. The v1 schema will return 410 Gone effective immediately.

Authentication Header Change

Bearer tokens must now be prefixed with FlowBearer instead of Bearer. Update your HTTP clients accordingly:

Authorization: FlowBearer sk_live_8x92kLm...

Environment Variables Rename

FLOW_API_KEY is now FLOWCMS_TOKEN. The old variable will be ignored in v3.5+.

📦 Upgrade Instructions

Upgrade using your preferred package manager or CLI. The process typically takes 2-5 minutes depending on your project size.

# Using npm
npm install @flowcms/sdk@latest

# Using CLI
flowcms upgrade --version 3.5.0

# Verify installation
flowcms doctor

After upgrading, run a local build to verify compatibility. If you encounter schema mismatches, use the auto-migration tool:

flowcms migrate --auto --dry-run