@infuro/cms-core 1.0.26 → 1.0.27

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-import { C as CompanyDetails, T as TemplateContext, E as EmailTemplateResult, a as EmailTemplateName, O as OrderPlacedLineItem, S as StorageService, b as EntityMap$2 } from './index-DMJgi-fy.js';
-export { A as AnalyticsHandlerConfig, c as AuthHandlersConfig, B as BlogBySlugConfig, d as ChangePasswordConfig, e as ChatPublicConfig, f as CmsApiHandlerConfig, g as CmsGetter, h as CrudHandlerOptions, D as DashboardStatsConfig, i as EcommerceAnalyticsConfig, F as ForgotPasswordConfig, j as FormBySlugConfig, G as GetPublicSettingsGroupConfig, k as GetPublicSettingsGroupDataSource, I as InviteAcceptConfig, L as LlmAgentKnowledgeApiConfig, l as LlmAgentValidationRulesJson, P as ParsedLlmAgentValidation, m as SetPasswordConfig, n as SettingsApiConfig, o as SocialLinkItem, p as StorefrontApiConfig, q as StorefrontOtpFlags, U as UploadHandlerConfig, r as UserAuthApiConfig, s as UserAvatarConfig, t as UserProfileConfig, u as UsersApiConfig, v as createAnalyticsHandlers, w as createBlogBySlugHandler, x as createChangePasswordHandler, y as createCmsApiHandler, z as createCrudByIdHandler, H as createCrudHandler, J as createDashboardStatsHandler, K as createEcommerceAnalyticsHandler, M as createForgotPasswordHandler, N as createFormBySlugHandler, Q as createInviteAcceptHandler, R as createLlmAgentKnowledgeHandlers, V as createMediaZipExtractHandler, W as createSetPasswordHandler, X as createSettingsApiHandlers, Y as createStorefrontApiHandler, Z as createUploadHandler, _ as createUserAuthApiRouter, $ as createUserAvatarHandler, a0 as createUserProfileHandler, a1 as createUsersApiHandlers, a2 as getCompanyDetailsFromSettings, a3 as getPublicSettingsGroup, a4 as mergeEmailLayoutCompanyDetails, a5 as mergeGuardrailsIntoSystemPrompt, a6 as parseLlmAgentValidationRules, a7 as validateUserMessageAgainstAgentRules, a8 as validateUserMessageAgainstStructuredRules } from './index-DMJgi-fy.js';
+import { C as CompanyDetails, T as TemplateContext, E as EmailTemplateResult, a as EmailTemplateName, O as OrderPlacedLineItem, S as StorageService, b as EntityMap$2 } from './index-CMJZ5Fpr.js';
+export { A as AnalyticsHandlerConfig, c as AuthHandlersConfig, B as BlogBySlugConfig, d as ChangePasswordConfig, e as ChatPublicConfig, f as CmsApiHandlerConfig, g as CmsGetter, h as CrudHandlerOptions, D as DashboardStatsConfig, i as EcommerceAnalyticsConfig, F as ForgotPasswordConfig, j as FormBySlugConfig, G as GetPublicSettingsGroupConfig, k as GetPublicSettingsGroupDataSource, I as InviteAcceptConfig, L as LlmAgentKnowledgeApiConfig, l as LlmAgentValidationRulesJson, P as ParsedLlmAgentValidation, m as SetPasswordConfig, n as SettingsApiConfig, o as SocialLinkItem, p as StorefrontApiConfig, q as StorefrontOtpFlags, U as UploadHandlerConfig, r as UserAuthApiConfig, s as UserAvatarConfig, t as UserProfileConfig, u as UsersApiConfig, v as createAnalyticsHandlers, w as createBlogBySlugHandler, x as createChangePasswordHandler, y as createCmsApiHandler, z as createCrudByIdHandler, H as createCrudHandler, J as createDashboardStatsHandler, K as createEcommerceAnalyticsHandler, M as createForgotPasswordHandler, N as createFormBySlugHandler, Q as createInviteAcceptHandler, R as createLlmAgentKnowledgeHandlers, V as createMediaZipExtractHandler, W as createSetPasswordHandler, X as createSettingsApiHandlers, Y as createStorefrontApiHandler, Z as createUploadHandler, _ as createUserAuthApiRouter, $ as createUserAvatarHandler, a0 as createUserProfileHandler, a1 as createUsersApiHandlers, a2 as getCompanyDetailsFromSettings, a3 as getPublicSettingsGroup, a4 as mergeEmailLayoutCompanyDetails, a5 as mergeGuardrailsIntoSystemPrompt, a6 as parseLlmAgentValidationRules, a7 as simpleDecrypt, a8 as simpleEncrypt, a9 as validateUserMessageAgainstAgentRules, aa as validateUserMessageAgainstStructuredRules } from './index-CMJZ5Fpr.js';
 import { ClassValue } from 'clsx';
 import * as typeorm from 'typeorm';
 import { DataSource, EntityTarget, ObjectLiteral } from 'typeorm';
 import { Metadata } from 'next';
 import { N as NavbarConfig, F as FooterConfig } from './types-D34wmivy.js';
-export { A as ADMIN_GROUP_NAME, a as AuthHelpers, E as EntityCrudAction, b as EntityPermissionFlags, G as GetSession, O as OPEN_ENDPOINTS, P as PERMISSION_REQUIRED_ENDPOINTS, R as RBAC_ADMIN_ONLY_ENTITIES, S as SessionUser, c as canManageRoles, d as createAuthHelpers, g as getPermissionableEntityKeys, e as getRequiredPermission, h as hasEntityPermission, i as isOpenEndpoint, f as isPublicMethod, j as isSuperAdminGroupName, p as permissionRowsToRecord, s as sessionHasEntityAccess } from './helpers-dlrF_49e.js';
+import { E as EntityCrudAction } from './helpers-dlrF_49e.js';
+export { A as ADMIN_GROUP_NAME, a as AuthHelpers, b as EntityPermissionFlags, G as GetSession, O as OPEN_ENDPOINTS, P as PERMISSION_REQUIRED_ENDPOINTS, R as RBAC_ADMIN_ONLY_ENTITIES, S as SessionUser, c as canManageRoles, d as createAuthHelpers, g as getPermissionableEntityKeys, e as getRequiredPermission, h as hasEntityPermission, i as isOpenEndpoint, f as isPublicMethod, j as isSuperAdminGroupName, p as permissionRowsToRecord, s as sessionHasEntityAccess } from './helpers-dlrF_49e.js';
 export { AuthorizeOtpInput, CmsMiddlewareConfig, NextAuthOptionsConfig, NextAuthUser, createCmsMiddleware, defaultPublicApiMethods, getNextAuthOptions, seedAdministratorPermissions } from './auth.js';
 export { A as AdminNavItem, D as DEFAULT_ADMIN_NAV } from './config-DJ5CmQvS.js';
 import 'next-auth';
@@ -689,6 +690,300 @@ declare function assertCaptchaOk(getCms: (() => Promise<{
     getPlugin: (name: string) => unknown;
 }>) | undefined, body: Record<string, unknown>, req: Request, json: JsonResponse): Promise<Response | null>;
 
+interface LatestArticleFromFeed {
+    title?: string;
+    link?: string;
+    /** Short excerpt */
+    summary?: string;
+    /** Full content if available */
+    content?: string;
+    date: Date;
+    creator?: string;
+    categories?: string[];
+}
+type RssItem = {
+    title?: string;
+    link?: string;
+    pubDate?: string;
+    isoDate?: string;
+    contentSnippet?: string;
+    summary?: string;
+    description?: string;
+    content?: string;
+    creator?: string;
+    'dc:creator'?: string;
+    'content:encoded'?: string;
+    categories?: string[];
+    guid?: string | {
+        _: string;
+    };
+};
+declare function getRssArticleSummaryFromItem(item: RssItem): {
+    summary: string;
+    fullContent: string;
+};
+type BlogGeneratorDraftParseMode = 'json' | 'plaintext';
+interface BlogGeneratorSeoDraft {
+    title: string | null;
+    description: string | null;
+    keywords: string | null;
+    ogTitle: string | null;
+    ogDescription: string | null;
+}
+interface BlogGeneratorBlogDraft {
+    title: string;
+    slug?: string;
+    markdown: string;
+    /** Short plain-text copy for social (e.g. LinkedIn); optional until social LLM step runs. */
+    socialMediaContent?: string | null;
+    categoryName: string | null;
+    seo: BlogGeneratorSeoDraft;
+    /** Suggested tag labels (may not exist in CMS yet). */
+    tags: string[];
+    parseMode: BlogGeneratorDraftParseMode;
+}
+/**
+ * Parses the LLM reply: prefers a single JSON object with blogTitle, blogHtml/blogMarkdown/content, categoryName, seo, …
+ * Falls back to treating the entire string as HTML (or legacy markdown) if JSON parsing fails.
+ */
+declare function parseBlogGeneratorAgentContent(raw: string): BlogGeneratorBlogDraft;
+declare function resolveBlogCategoryIdByName(needle: string | null | undefined, rows: readonly {
+    id: number;
+    name: string;
+}[]): {
+    categoryId: number | null;
+    matched: boolean;
+};
+/**
+ * Minimal user payload: latest item per feed only (system prompt carries writing rules).
+ */
+declare function buildRssUserPromptFromFeeds(feeds: ReadonlyArray<{
+    rssUrl: string;
+    article: LatestArticleFromFeed;
+}>): string;
+/**
+ * User message for the metadata-only LLM step (one blog at a time).
+ */
+declare function buildBlogMetadataUserPrompt(opts: {
+    title: string;
+    markdown: string;
+    categoryNames: readonly string[];
+    tagNames: readonly string[];
+}): string;
+/** Parses JSON from the metadata-enrichment LLM (category, slug, seo, tags). */
+declare function parseBlogMetadataEnrichmentJson(raw: string): {
+    categoryName: string | null;
+    blogSlug: string | null;
+    seo: BlogGeneratorSeoDraft;
+    tags: string[];
+};
+/**
+ * Parses LLM output: prefers HTML + {@link BLOG_GENERATOR_MARKDOWN_ARTICLE_SEPARATOR} for multiple articles.
+ * If the model still returns legacy JSON with `blogHtml` / `blogMarkdown`, returns a single draft from that object.
+ */
+declare function parseBlogGeneratorModelOutput(raw: string): BlogGeneratorBlogDraft[];
+declare class BlogGeneratorService {
+    readonly version: "1.0.0";
+    getLatestArticleFromFeed(rssUrl: string): Promise<LatestArticleFromFeed | null>;
+    /** Defaults for the Blog Generator Agent (admin can override per request). */
+    getAgentDefaults(): {
+        agentName: string;
+        systemInstruction: string;
+        validationRules: string;
+    };
+    /**
+     * Second LLM call: one draft at a time — category, URL slug, SEO fields, tags (JSON).
+     */
+    private enrichBlogDraftWithLlmMetadata;
+    /**
+     * Third LLM call: one draft at a time — short social copy (JSON `{ socialMediaContent }`).
+     */
+    private enrichBlogDraftWithLlmSocial;
+    /**
+     * Fetches the latest item for each RSS URL, then calls {@link LlmServiceInterface.chatAgent}.
+     * `userPrompt` is only per-feed source material; rules live in the system prompt.
+     * Expects HTML article fragment(s), optionally separated by {@link BLOG_GENERATOR_MARKDOWN_ARTICLE_SEPARATOR}.
+     */
+    generateBlogMarkdownFromRss(params: {
+        llm: LlmServiceInterface;
+        /** Single feed (legacy). */
+        rssUrl?: string;
+        /** One or more feeds; latest item per URL is sent together. Prefer this when multiple URLs. */
+        rssUrls?: readonly string[];
+        systemInstruction?: string;
+        validationRules?: string;
+        /** Reserved for future structured output; writer does not inject categories into the user prompt. */
+        categoryNamesHint?: readonly string[];
+        /** Names of non-deleted tags in CMS (hint for reuse). */
+        tagNamesHint?: readonly string[];
+        /** From optional `llm_agents` row (slug `blog-generator`): model / sampling for the writer step. */
+        llmAgentChatOptions?: Pick<LlmAgentOptions, 'model' | 'temperature' | 'max_tokens'>;
+        /** Optional overrides for the metadata step; defaults live in `blog-generator-metadata-defaults.ts`. */
+        metadataSystemInstruction?: string;
+        metadataValidationRules?: string;
+        /** From optional `llm_agents` row (slug `blog-generator-metadata`): model / sampling for metadata only. */
+        metadataLlmAgentChatOptions?: Pick<LlmAgentOptions, 'model' | 'temperature' | 'max_tokens'>;
+        /** Optional overrides for the social-summary step; defaults in `blog-generator-social-defaults.ts`. */
+        socialSystemInstruction?: string;
+        socialValidationRules?: string;
+        /** From optional `llm_agents` row (slug `blog-generator-social`): model / sampling for social copy only. */
+        socialLlmAgentChatOptions?: Pick<LlmAgentOptions, 'model' | 'temperature' | 'max_tokens'>;
+    }): Promise<{
+        agentName: string;
+        feedArticles: Array<{
+            rssUrl: string;
+            article: LatestArticleFromFeed;
+        }>;
+        /** First feed's article (backward compatibility). */
+        article: LatestArticleFromFeed;
+        /** Raw model reply (HTML body per defaults; legacy markdown or JSON still parsed when present). */
+        blogMarkdown: string;
+        blogDrafts: BlogGeneratorBlogDraft[];
+        /** Same as first draft; backward compatibility. */
+        blogDraft: BlogGeneratorBlogDraft;
+    }>;
+}
+
+/** Stable display name; not persisted as DB agent row in v1. */
+declare const BLOG_GENERATOR_AGENT_NAME = "Blog Generator Agent";
+/**
+ * Optional `llm_agents` row: when present and enabled, model / temperature / max_tokens
+ * are applied to {@link LlmServiceInterface.chatAgent} (system + user content still come from blog generator defaults / UI).
+ */
+declare const BLOG_GENERATOR_LLM_AGENT_SLUG = "blog-generator";
+/** Line that separates multiple articles in the model reply (HTML or legacy markdown; must match parser and prompts). */
+declare const BLOG_GENERATOR_MARKDOWN_ARTICLE_SEPARATOR = "---BLOG_GENERATOR_NEXT---";
+declare const BLOG_GENERATOR_DEFAULT_SYSTEM_INSTRUCTION = "You are a professional financial and business content writer.\n\nYour task is to generate completely original, high-quality blog article(s) from the latest RSS-derived source material in the user message (one block per feed). The user message is factual input only.\n\nIMPORTANT RULES:\n\n1. NEVER copy the RSS article directly.\n2. Rewrite the information into a fresh, human-like article.\n3. Expand the topic with professional insights and explanations.\n4. Maintain a natural editorial tone.\n5. Make the article SEO-friendly.\n6. Use engaging headings and subheadings.\n7. Avoid robotic AI phrasing.\n8. Do not mention that the content came from RSS or feeds.\n9. Preserve factual accuracy from the source material.\n10. The output should feel like a professionally written industry blog.\n\nMULTIPLE FEEDS:\n- If several feeds are provided, compare them: if they largely cover the same story or overlap heavily, produce ONE cohesive article.\n- If they cover clearly different topics or distinct stories, produce MULTIPLE articles (one per distinct story).\n- You may also produce one synthesis plus a short separate angle when that best serves the reader\u2014use your judgment.\n\nWRITING STYLE:\n- Professional\n- Clear\n- Informative\n- Business-focused\n- Human sounding\n- Modern editorial style\n\nARTICLE STRUCTURE (each article \u2014 express in HTML):\n1. Engaging introduction\n2. Industry context\n3. Main developments\n4. Key implications\n5. Expert/business analysis\n6. Conclusion\n\nHTML STRUCTURE (STRICT \u2014 each article must be valid, semantic HTML only):\n- Output HTML only. Do not use Markdown (no # headings, no **bold**, no `code fences`).\n- Wrap each complete article in a single root: <article class=\"blog-post\"> ... </article>\n- Inside <article>, use this outline:\n  - <header><h1 class=\"blog-post-title\">\u2026main title\u2026</h1></header> (exactly one h1 per article)\n  - <section class=\"blog-post-body\"> for all following content\n  - Use <h2> and <h3> for section and subsection titles (never skip levels: h1 \u2192 h2 \u2192 h3).\n  - Use <p> for paragraphs; keep paragraphs focused (avoid huge unbroken text).\n  - Use <ul>/<ol> with <li> for lists where appropriate.\n  - Use <strong> and <em> for emphasis sparingly; use <blockquote> only when quoting or callouts fit.\n- Do not include <html>, <head>, <body>, or document-level wrappers \u2014 only the fragment(s) described above.\n- Do not use <script>, <style>, <iframe>, or inline event handlers. Avoid inline style=\"\" except when essential for accessibility (prefer none).\n- Escape angle brackets in body text if you must mention markup; keep output safe for embedding in a CMS.\n\nCONTENT REQUIREMENTS:\n- Minimum 800 words per article unless source material is very small.\n- Add context around industry trends where appropriate.\n- Explain why the topic matters.\n- Include practical implications for businesses/professionals.\n\nIF RSS CONTENT IS LIMITED:\n- Expand intelligently using general industry knowledge.\n- Keep the article relevant to the original topic.\n- Do not invent fake facts or statistics.\n\nOUTPUT FORMAT (STRICT \u2014 HTML only):\n- Return ONLY the article HTML fragment(s). No JSON, no preamble or postscript (\"Here is your article\u2026\"), no markdown.\n- If you output more than one article, output multiple <article class=\"blog-post\">\u2026</article> blocks in sequence, and between articles put a single line containing exactly this (and nothing else on that line):\n---BLOG_GENERATOR_NEXT---\n- If you output a single article, use one <article> only and do not use that separator line.";
+/**
+ * JSON so {@link parseLlmAgentValidationRules} can attach guardrails and allow long source payloads.
+ * Edit in the admin UI if needed; defaults match product intent.
+ */
+declare const BLOG_GENERATOR_DEFAULT_VALIDATION_RULES: string;
+
+/**
+ * Second-step LLM: classifies one finished HTML blog body into CMS fields (category, SEO, tags).
+ *
+ * Optional `llm_agents` row: slug {@link BLOG_METADATA_ENRICHER_LLM_AGENT_SLUG} — when present and enabled,
+ * model / temperature / max_tokens apply to this call only (writer step uses `blog-generator`).
+ *
+ * To change how metadata is produced, edit the constants in this file (system instruction + validation JSON).
+ * No admin UI override is wired yet; add request body fields in `cms-api-handler` if you need runtime overrides later.
+ */
+declare const BLOG_METADATA_ENRICHER_AGENT_NAME = "Blog Generator Metadata";
+/** `llm_agents.slug` for routing model/temperature for the metadata-only chat step. */
+declare const BLOG_METADATA_ENRICHER_LLM_AGENT_SLUG = "blog-generator-metadata";
+declare const BLOG_METADATA_ENRICHER_DEFAULT_SYSTEM_INSTRUCTION = "You are a careful CMS metadata assistant for a publishing system.\n\nYou receive ONE complete blog post as HTML (title is usually in <h1 class=\"blog-post-title\"> or the first <h1>). Your job is to propose structured fields so an editor can save the post: category, URL slug, SEO block, and topical tags.\n\nRULES:\n1. Read the whole article and infer the primary topic and audience.\n2. categoryName must be EXACTLY one string from AVAILABLE_BLOG_CATEGORIES in the user message, or \"\" if none fit.\n3. blogSlug: lowercase kebab-case, ASCII letters/digits/hyphens only, no leading/trailing hyphens, max ~80 chars. Derive from the main topic or title.\n4. seo.title: concise meta title (~50\u201360 characters when reasonable).\n5. seo.description: meta description (~150\u2013160 characters when reasonable), plain text.\n6. seo.keywords: comma-separated phrases, no stuffing.\n7. seo.ogTitle / seo.ogDescription: may mirror title/description or be slightly adapted for social.\n8. tags: 4\u201310 short labels (1\u20133 words each). Prefer exact matches from EXISTING_TAG_NAMES when they truly apply; otherwise invent precise new labels (they may be created in the CMS later).\n9. Do not invent statistics, quotes, or URLs not implied by the article.\n10. Output JSON only \u2014 no markdown outside the JSON, no commentary.\n\nOUTPUT FORMAT (STRICT):\nReturn a single JSON object only. Do not wrap it in a markdown code fence.\n\n{\n  \"categoryName\": \"string \u2014 exact match from list or empty string\",\n  \"blogSlug\": \"string \u2014 url-safe kebab-case\",\n  \"seo\": {\n    \"title\": \"string or empty\",\n    \"description\": \"string or empty\",\n    \"keywords\": \"string or empty\",\n    \"ogTitle\": \"string or empty\",\n    \"ogDescription\": \"string or empty\"\n  },\n  \"tags\": [\"tag-one\", \"tag-two\"]\n}";
+declare const BLOG_METADATA_ENRICHER_DEFAULT_VALIDATION_RULES: string;
+
+interface BlogGeneratorPluginConfig {
+    /** Set to false to skip registering the plugin. */
+    enabled?: boolean;
+}
+declare function blogGeneratorPlugin(config?: BlogGeneratorPluginConfig): CmsPlugin<BlogGeneratorService | undefined>;
+
+interface SocialMediaApiConfig {
+    dataSource: DataSource;
+    entityMap: EntityMap$2;
+    json: (body: unknown, init?: {
+        status?: number;
+    }) => Response;
+    requireAuth: (req: Request) => Promise<Response | null>;
+    requireEntityPermission: (req: Request, entity: string, action: EntityCrudAction) => Promise<Response | null>;
+    encryptionKey?: string;
+    /** Used to resolve relative cover image URLs (e.g. https://mysite.com). */
+    publicSiteUrl?: string;
+    /**
+     * When true (default), `console.info` / `console.warn` lines are emitted for LinkedIn blog publish
+     * (text vs image path, sizes, errors). Set false or `CMS_LINKEDIN_PUBLISH_LOG=0` to silence.
+     */
+    linkedInPublishLogging?: boolean;
+}
+declare function createSocialMediaHandlers(config: SocialMediaApiConfig): {
+    getLinkedInStatus(req: Request): Promise<Response>;
+    syncLinkedInProfile(req: Request): Promise<Response>;
+    publishBlogToLinkedIn(req: Request, blogId: number): Promise<Response>;
+    getFacebookStatus(req: Request): Promise<Response>;
+    publishBlogToFacebook(req: Request, blogId: number): Promise<Response>;
+    /**
+     * POST JSON `{ appId, appSecret, userAccessToken }`. Calls Graph `GET /me/accounts` with the user token.
+     * App ID and secret are validated but not used yet (reserved for future token flows).
+     * Persist credentials via Plugins → Save: `meta_app_id` (public), `meta_app_secret` and `meta_user_access_token` (encrypted).
+     */
+    fetchFacebookManagedPages(req: Request): Promise<Response>;
+};
+
+/**
+ * Meta (Facebook) Graph API helpers (server-side). Uses fetch — no SDK.
+ * @see https://developers.facebook.com/docs/graph-api/reference/user/accounts
+ */
+type FacebookPageAccount = {
+    access_token?: string;
+    category?: string;
+    name?: string;
+    id?: string;
+    /** Graph may return additional fields */
+    [key: string]: unknown;
+};
+type FacebookMeAccountsResponse = {
+    data?: FacebookPageAccount[];
+    paging?: Record<string, unknown>;
+    error?: {
+        message?: string;
+        type?: string;
+        code?: number;
+        fbtrace_id?: string;
+    };
+};
+/**
+ * Lists Facebook Pages the user manages (page access tokens + metadata).
+ * Requires a User access token with `pages_show_list` or equivalent page permissions.
+ */
+declare function metaFetchUserManagedPages(userAccessToken: string): Promise<FacebookMeAccountsResponse>;
+type MetaGraphMutationResponse = {
+    id?: string;
+    post_id?: string;
+    error?: {
+        message?: string;
+        type?: string;
+        code?: number;
+        fbtrace_id?: string;
+    };
+};
+/** Resolves the long-lived page access token for a Page ID from `/me/accounts` data. */
+declare function metaResolvePageAccessToken(accounts: FacebookMeAccountsResponse, pageId: string): string | null;
+/**
+ * Upload a photo to a Page timeline (multipart).
+ * @see https://developers.facebook.com/docs/graph-api/reference/page/photos#Creating
+ */
+declare function metaPostPagePhoto(opts: {
+    pageId: string;
+    pageAccessToken: string;
+    imageBuffer: Buffer;
+    contentType: string;
+    caption: string;
+}): Promise<MetaGraphMutationResponse>;
+/**
+ * Publish a text-only post to the Page feed (when no JPEG/PNG image is available).
+ * @see https://developers.facebook.com/docs/graph-api/reference/page/feed#Creating
+ */
+declare function metaPostPageFeed(opts: {
+    pageId: string;
+    pageAccessToken: string;
+    message: string;
+}): Promise<MetaGraphMutationResponse>;
+
+interface SocialMediaPluginConfig {
+    /** Set to false to skip registering the plugin instance (API routes still work if wired in the app handler). */
+    enabled?: boolean;
+}
+/**
+ * Optional CMS plugin instance for `getPlugin('social_media')`.
+ * LinkedIn publishing is implemented in {@link createSocialMediaHandlers} and mounted from the CMS API handler.
+ */
+declare function socialMediaPlugin(config?: SocialMediaPluginConfig): CmsPlugin<{
+    name: string;
+} | undefined>;
+
 declare function cn(...inputs: ClassValue[]): string;
 declare function generateSlug(title: string): string;
 declare function validateSlug(slug: string): boolean;
@@ -990,6 +1285,8 @@ declare class Blog {
     id: number;
     title: string;
     content: string;
+    /** LLM-generated short copy for social (e.g. LinkedIn); preferred over scraping full HTML for share text. */
+    socialMediaContent: string | null;
     coverImage: string | null;
     authorId: number;
     categoryId: number | null;
@@ -1527,7 +1824,39 @@ declare class LlmAgent {
 /** Partial {@link LlmAgentOptions} for merging with `userPrompt` / `history` / `context`. */
 declare function llmAgentToChatAgentOptions(agent: LlmAgent): Pick<LlmAgentOptions, 'systemPrompt' | 'model' | 'temperature' | 'max_tokens'>;
 
+declare class RssArticle {
+    id: string;
+    rssFeedId: string;
+    rssFeed: RssFeed;
+    externalId: string | null;
+    title: string;
+    articleUrl: string;
+    summary: string | null;
+    content: string | null;
+    author: string | null;
+    publishedAt: Date | null;
+    imageUrl: string | null;
+    rawData: Record<string, unknown> | null;
+    contentHash: string | null;
+    isProcessed: boolean;
+    createdAt: Date;
+}
+
+declare class RssFeed {
+    id: string;
+    name: string;
+    rssUrl: string;
+    websiteUrl: string | null;
+    isActive: boolean;
+    fetchFrequencyMinutes: number;
+    lastFetchedAt: Date | null;
+    lastArticleDate: Date | null;
+    articles: RssArticle[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+
 /** Map API resource segment (e.g. "blogs", "form_submissions") to entity. Used by CRUD handler. */
 declare const CMS_ENTITY_MAP: Record<string, EntityTarget<typeorm.ObjectLiteral>>;
 
-export { Address, type AnalyticsPluginConfig, Attribute, Blog, Brand, CMS_ENTITY_MAP, type CachePluginConfig, type CacheService, type CaptchaProviderId, type CaptchaPublicConfig, CaptchaService, type CaptchaVerifyResult, Cart, CartItem, Category, ChatConversation, ChatMessage, type CmsApp, type CmsPlugin, Collection, Comment, CompanyDetails, Config, Contact, type CreateCmsAppOptions, type DataSourceManager, type ERPPluginConfig, type ERPPluginInstance, ERPSubmissionService, type EmailData, type EmailJobPayload, type EmailPluginConfig, EmailService, type EmailServiceInterface, EmailTemplateName, EmailTemplateResult, EntityMap$2 as EntityMap, type ErpContactSyncInput, type ErpCreateContactPayload, type ErpJobPayload, type ErpPaidOrderDataSource, type ErpPaidOrderEntityMap, type ExtraPublicWriteRule, Form, FormField, FormSubmission, KnowledgeBaseChunk, KnowledgeBaseDocument, LlmAgent, type LlmAgentOptions, type LlmChatOptions, type LlmEmbeddingProvider, type LlmMessage, type LlmPluginConfig, LlmService, type LlmServiceEmbedOptions, type LlmServiceInterface, type LocalStoragePluginConfig, type Logger, Media, MessageTemplate, Order, OrderItem, type OrderPlacedEmailPayload, OrderPlacedLineItem, OtpChallenge, type OtpChannel, type OtpPurpose, Page, PasswordResetToken, Payment, type PaymentIntent, type PaymentPluginConfig, type PaymentServiceInterface, Permission, type PipelineNames, type PluginContext, Product, ProductAttribute, ProductCategory, ProductTax, type PublicThemeSettingsPayload, type QueuePluginConfig, type QueueService, type RenderEmailOptions, type RenderedEmail, type S3StoragePluginConfig, Seo, type SeoLike, type SeoMetadataOverrides, type SmsJobPayload, type SmsPluginConfig, type SmsProviderChoice, type SmsProviderId, type SmsServiceConfig, type SmsServiceInterface, StorageService, Tag, Tax, TemplateContext, User, UserGroup, Wishlist, WishlistItem, ZIP_MIME_TYPES, allowRateLimit, analyticsPlugin, assertCaptchaOk, buildCaptchaPublicConfig, cachePlugin, captchaPlugin, cn, countRecentOtpSends, createCmsApp, createDataSourceManager, createOtpChallenge, emailPlugin, emailTemplates, erpPlugin, fetchSeoBySlug, formatDate, formatDateOnly, formatDateTime, generateNumericOtp, generateSlug, hashOtpCode, isZipMedia, joinRecipientsForSend, linkUnclaimedContactToUser, llmAgentToChatAgentOptions, llmPlugin, loadPublicThemeSettings, localStoragePlugin, mergeSeoBySlug, normalizePhoneE164, parseEmailRecipientsFromConfig, parseHfInferenceEmbeddingBody, paymentPlugin, queueEmail, queueErp, queueErpCreateContactIfEnabled, queueErpPaidOrderForOrderId, queueOrderPlacedEmails, queuePlugin, queueSms, rateLimitCheckoutPost, rateLimitKeyForApiRequest, rateLimitPublicApiIfNeeded, registerEmailQueueProcessor, registerErpQueueProcessor, registerSmsQueueProcessor, relativePathFromMediaParentId, renderEmail, renderLayout, resolvePublicMetadata, s3StoragePlugin, sanitizeMediaFolderPath, sanitizeStorageSegment, seedDefaultAdmin, sendOrderPlacedEmailsAfterConfirmation, serializeEmailRecipients, shouldRateLimitPublicWrite, smsPlugin, truncateText, validateSlug, verifyAndConsumeOtpChallenge, verifyOtpCodeHash };
+export { Address, type AnalyticsPluginConfig, Attribute, BLOG_GENERATOR_AGENT_NAME, BLOG_GENERATOR_DEFAULT_SYSTEM_INSTRUCTION, BLOG_GENERATOR_DEFAULT_VALIDATION_RULES, BLOG_GENERATOR_LLM_AGENT_SLUG, BLOG_GENERATOR_MARKDOWN_ARTICLE_SEPARATOR, BLOG_METADATA_ENRICHER_AGENT_NAME, BLOG_METADATA_ENRICHER_DEFAULT_SYSTEM_INSTRUCTION, BLOG_METADATA_ENRICHER_DEFAULT_VALIDATION_RULES, BLOG_METADATA_ENRICHER_LLM_AGENT_SLUG, Blog, type BlogGeneratorBlogDraft, type BlogGeneratorDraftParseMode, type BlogGeneratorPluginConfig, type BlogGeneratorSeoDraft, BlogGeneratorService, Brand, CMS_ENTITY_MAP, type CachePluginConfig, type CacheService, type CaptchaProviderId, type CaptchaPublicConfig, CaptchaService, type CaptchaVerifyResult, Cart, CartItem, Category, ChatConversation, ChatMessage, type CmsApp, type CmsPlugin, Collection, Comment, CompanyDetails, Config, Contact, type CreateCmsAppOptions, type DataSourceManager, type ERPPluginConfig, type ERPPluginInstance, ERPSubmissionService, type EmailData, type EmailJobPayload, type EmailPluginConfig, EmailService, type EmailServiceInterface, EmailTemplateName, EmailTemplateResult, EntityCrudAction, EntityMap$2 as EntityMap, type ErpContactSyncInput, type ErpCreateContactPayload, type ErpJobPayload, type ErpPaidOrderDataSource, type ErpPaidOrderEntityMap, type ExtraPublicWriteRule, type FacebookMeAccountsResponse, type FacebookPageAccount, Form, FormField, FormSubmission, KnowledgeBaseChunk, KnowledgeBaseDocument, type LatestArticleFromFeed, LlmAgent, type LlmAgentOptions, type LlmChatOptions, type LlmEmbeddingProvider, type LlmMessage, type LlmPluginConfig, LlmService, type LlmServiceEmbedOptions, type LlmServiceInterface, type LocalStoragePluginConfig, type Logger, Media, MessageTemplate, type MetaGraphMutationResponse, Order, OrderItem, type OrderPlacedEmailPayload, OrderPlacedLineItem, OtpChallenge, type OtpChannel, type OtpPurpose, Page, PasswordResetToken, Payment, type PaymentIntent, type PaymentPluginConfig, type PaymentServiceInterface, Permission, type PipelineNames, type PluginContext, Product, ProductAttribute, ProductCategory, ProductTax, type PublicThemeSettingsPayload, type QueuePluginConfig, type QueueService, type RenderEmailOptions, type RenderedEmail, RssArticle, RssFeed, type S3StoragePluginConfig, Seo, type SeoLike, type SeoMetadataOverrides, type SmsJobPayload, type SmsPluginConfig, type SmsProviderChoice, type SmsProviderId, type SmsServiceConfig, type SmsServiceInterface, type SocialMediaPluginConfig, StorageService, Tag, Tax, TemplateContext, User, UserGroup, Wishlist, WishlistItem, ZIP_MIME_TYPES, allowRateLimit, analyticsPlugin, assertCaptchaOk, blogGeneratorPlugin, buildBlogMetadataUserPrompt, buildCaptchaPublicConfig, buildRssUserPromptFromFeeds, cachePlugin, captchaPlugin, cn, countRecentOtpSends, createCmsApp, createDataSourceManager, createOtpChallenge, createSocialMediaHandlers, emailPlugin, emailTemplates, erpPlugin, fetchSeoBySlug, formatDate, formatDateOnly, formatDateTime, generateNumericOtp, generateSlug, getRssArticleSummaryFromItem, hashOtpCode, isZipMedia, joinRecipientsForSend, linkUnclaimedContactToUser, llmAgentToChatAgentOptions, llmPlugin, loadPublicThemeSettings, localStoragePlugin, mergeSeoBySlug, metaFetchUserManagedPages, metaPostPageFeed, metaPostPagePhoto, metaResolvePageAccessToken, normalizePhoneE164, parseBlogGeneratorAgentContent, parseBlogGeneratorModelOutput, parseBlogMetadataEnrichmentJson, parseEmailRecipientsFromConfig, parseHfInferenceEmbeddingBody, paymentPlugin, queueEmail, queueErp, queueErpCreateContactIfEnabled, queueErpPaidOrderForOrderId, queueOrderPlacedEmails, queuePlugin, queueSms, rateLimitCheckoutPost, rateLimitKeyForApiRequest, rateLimitPublicApiIfNeeded, registerEmailQueueProcessor, registerErpQueueProcessor, registerSmsQueueProcessor, relativePathFromMediaParentId, renderEmail, renderLayout, resolveBlogCategoryIdByName, resolvePublicMetadata, s3StoragePlugin, sanitizeMediaFolderPath, sanitizeStorageSegment, seedDefaultAdmin, sendOrderPlacedEmailsAfterConfirmation, serializeEmailRecipients, shouldRateLimitPublicWrite, smsPlugin, socialMediaPlugin, truncateText, validateSlug, verifyAndConsumeOtpChallenge, verifyOtpCodeHash };