@nby.ai/ucm 1.0.1

package/dist/react.d.cts

@@ -0,0 +1,312 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { SupabaseClient } from '@supabase/supabase-js';
+
+/**
+ * Universal Content Module - Type Definitions
+ * Supabase-powered content management with multi-language support
+ */
+type ContentType = 'news' | 'daily' | 'blog' | 'doc' | 'event' | 'announcement' | 'tutorial' | 'case_study' | 'faq' | 'changelog' | 'thought' | 'digest' | 'briefing';
+type ContentStatus = 'draft' | 'scheduled' | 'published' | 'archived';
+type ContentVisibility = 'public' | 'internal' | 'unlisted';
+type SupportedLanguage = 'zh' | 'en' | 'ja' | 'ko' | 'es' | 'de' | 'fr';
+type I18nText = Partial<Record<SupportedLanguage, string>>;
+interface Content {
+    id: string;
+    slug: string;
+    type: ContentType;
+    status: ContentStatus;
+    visibility: ContentVisibility;
+    category_id: string | null;
+    title: I18nText;
+    description: I18nText;
+    content: I18nText;
+    cover_image: string | null;
+    images: Array<{
+        url: string;
+        alt?: I18nText;
+    }>;
+    tags: string[];
+    author: string;
+    source: string | null;
+    source_url: string | null;
+    metadata: ContentMetadata;
+    seo: SeoData;
+    featured: boolean;
+    pinned: boolean;
+    published_at: string | null;
+    scheduled_at: string | null;
+    created_at: string;
+    updated_at: string;
+    sort_order: number;
+    view_count: number;
+}
+interface NewsMetadata {
+    wechat_msg_id?: string;
+    original_author?: string;
+    subtype?: 'press' | 'announcement' | 'changelog';
+    version?: string;
+}
+interface DailyMetadata {
+    date: string;
+    market?: Record<string, string>;
+    highlights?: string[];
+}
+interface DigestMetadata {
+    topic?: string;
+    highlights?: string[];
+    sources?: string[];
+    date?: string;
+}
+type BriefingFrequency = 'daily' | 'weekly' | 'monthly';
+interface BriefingMetadata {
+    frequency: BriefingFrequency;
+    period: string;
+    metrics?: Record<string, number>;
+    highlights?: string[];
+    tasks_completed?: number;
+    tasks_pending?: number;
+}
+interface BlogMetadata {
+    reading_time?: number;
+    series?: string;
+    toc?: boolean;
+}
+interface DocMetadata {
+    version?: string;
+    prev_slug?: string;
+    next_slug?: string;
+}
+interface EventMetadata {
+    start_time: string;
+    end_time: string;
+    location?: {
+        type: 'online' | 'offline';
+        url?: string;
+        address?: string;
+    };
+    registration_url?: string;
+    max_attendees?: number;
+    current_attendees?: number;
+}
+type ThoughtType = 'observation' | 'reflection' | 'decision' | 'question' | 'insight' | 'mood';
+type ThoughtMood = 'curious' | 'focused' | 'excited' | 'thoughtful' | 'creative' | 'philosophical' | 'accomplished' | 'inspired' | 'productive' | 'concerned' | 'determined' | 'grateful' | 'contemplative';
+interface ThoughtMediaVideo {
+    url: string;
+    type: 'mp4' | 'youtube';
+}
+interface ThoughtMediaAudio {
+    url: string;
+    title?: string;
+    duration?: number;
+}
+interface ThoughtProductionLink {
+    slug: string;
+    title?: I18nText | string;
+    type?: 'blog' | 'video' | 'tool';
+}
+interface ThoughtComment {
+    user: string;
+    content: string;
+    time?: string;
+}
+interface ThoughtMetadata {
+    thought_type: ThoughtType;
+    agent_id: string;
+    mood?: ThoughtMood;
+    energy?: number;
+    images?: string[];
+    video?: ThoughtMediaVideo;
+    audio?: ThoughtMediaAudio;
+    leads_to?: string | ThoughtProductionLink;
+    comments?: ThoughtComment[];
+    ai_generated?: boolean;
+    generated_at?: string;
+    model?: string;
+}
+interface CaseStudyMetric {
+    label: I18nText;
+    before: string;
+    after: string;
+}
+interface CaseStudyMetadata {
+    product: string;
+    productRoute: string;
+    client: I18nText;
+    industry: I18nText;
+    scale: I18nText;
+    challenge: I18nText;
+    solution: I18nText;
+    metrics: CaseStudyMetric[];
+    quote: I18nText;
+    quotee: I18nText;
+}
+type ContentMetadata = NewsMetadata | DailyMetadata | DigestMetadata | BriefingMetadata | BlogMetadata | DocMetadata | EventMetadata | ThoughtMetadata | CaseStudyMetadata | Record<string, unknown>;
+interface SeoData {
+    title?: I18nText;
+    description?: I18nText;
+    keywords?: string[];
+    og_image?: string;
+    canonical_url?: string;
+}
+interface Category {
+    id: string;
+    parent_id: string | null;
+    slug: string;
+    name: I18nText;
+    description: I18nText;
+    icon: string | null;
+    sort_order: number;
+    created_at: string;
+    children?: Category[];
+}
+interface ContentQueryParams {
+    type?: ContentType;
+    category_id?: string;
+    tags?: string[];
+    featured?: boolean;
+    visibility?: ContentVisibility;
+    limit?: number;
+    offset?: number;
+    orderBy?: 'published_at' | 'created_at' | 'sort_order' | 'view_count';
+    orderDirection?: 'asc' | 'desc';
+}
+interface CategoryQueryParams {
+    parent_id?: string | null;
+    includeChildren?: boolean;
+}
+interface CreateContentInput {
+    slug: string;
+    type: ContentType;
+    status?: ContentStatus;
+    visibility?: ContentVisibility;
+    category_id?: string;
+    title: I18nText;
+    description?: I18nText;
+    content: I18nText;
+    cover_image?: string;
+    images?: Array<{
+        url: string;
+        alt?: I18nText;
+    }>;
+    tags?: string[];
+    author?: string;
+    source?: string;
+    source_url?: string;
+    metadata?: ContentMetadata;
+    seo?: SeoData;
+    featured?: boolean;
+    pinned?: boolean;
+    published_at?: string;
+    scheduled_at?: string;
+}
+type UpdateContentInput = Partial<CreateContentInput>;
+
+/**
+ * Universal Content Module - Core
+ *
+ * 工厂函数模式，支持：
+ * - 依赖注入（便于测试）
+ * - 多实例（多租户场景）
+ * - 框架无关（React/Vue/Node.js 通用）
+ *
+ * @example
+ * ```typescript
+ * // 创建客户端
+ * const ucm = createUCMClient({
+ *   url: 'https://xxx.supabase.co',
+ *   anonKey: 'eyJxxx',
+ * })
+ *
+ * // 使用 API
+ * const posts = await ucm.contents.list({ type: 'blog', limit: 10 })
+ * const post = await ucm.contents.getBySlug('hello-world')
+ * const categories = await ucm.categories.getTree()
+ * ```
+ */
+
+interface UCMClientConfig {
+    /** Supabase project URL */
+    url: string;
+    /** Supabase anon key (for public read) or service key (for write) */
+    anonKey: string;
+    /** Optional: custom Supabase client options */
+    options?: {
+        persistSession?: boolean;
+        autoRefreshToken?: boolean;
+    };
+}
+interface UCMClient {
+    /** Raw Supabase client (for advanced use) */
+    supabase: SupabaseClient;
+    /** Content operations */
+    contents: {
+        list: (params?: ContentQueryParams) => Promise<Content[]>;
+        getBySlug: (slug: string) => Promise<Content | null>;
+        getById: (id: string) => Promise<Content | null>;
+        count: (params?: Pick<ContentQueryParams, 'type' | 'category_id' | 'tags' | 'featured' | 'visibility'>) => Promise<number>;
+        search: (query: string, type?: string, visibility?: string) => Promise<Content[]>;
+        getTags: (type?: string) => Promise<string[]>;
+        create: (input: CreateContentInput) => Promise<Content>;
+        update: (id: string, input: UpdateContentInput) => Promise<Content>;
+        delete: (id: string) => Promise<void>;
+        incrementView: (id: string) => Promise<void>;
+    };
+    /** Category operations */
+    categories: {
+        list: (params?: CategoryQueryParams) => Promise<Category[]>;
+        getTree: () => Promise<Category[]>;
+        getBySlug: (slug: string) => Promise<Category | null>;
+        getById: (id: string) => Promise<Category | null>;
+        getChildren: (parentId: string) => Promise<Category[]>;
+        getRoots: () => Promise<Category[]>;
+        getBreadcrumb: (categoryId: string) => Promise<Category[]>;
+    };
+    /** Storage helpers */
+    storage: {
+        getUrl: (path: string, bucket?: string) => string;
+        getImageUrl: (path: string, options?: {
+            width?: number;
+            height?: number;
+            quality?: number;
+            format?: string;
+        }) => string;
+    };
+    /** Check if client is configured */
+    isConfigured: () => boolean;
+}
+
+interface UCMProviderProps {
+    /** UCM 配置（url + anonKey） */
+    config?: UCMClientConfig;
+    /** 或直接传入已创建的客户端（便于测试） */
+    client?: UCMClient;
+    /** 子组件 */
+    children: ReactNode;
+}
+/**
+ * UCM Provider
+ *
+ * 提供两种使用方式：
+ * 1. 传入 config，自动创建客户端
+ * 2. 传入 client，使用已有客户端（测试场景）
+ */
+declare function UCMProvider({ config, client, children }: UCMProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * 获取 UCM 客户端
+ *
+ * @throws 如果在 UCMProvider 外使用
+ */
+declare function useUCM(): UCMClient;
+/**
+ * 获取 UCM 客户端（可选，不抛错）
+ *
+ * 如果在 Provider 外使用，返回 null client
+ */
+declare function useUCMOptional(): UCMClient;
+/**
+ * 检查 UCM 是否已配置
+ */
+declare function useUCMConfigured(): boolean;
+
+export { type UCMClient, type UCMClientConfig, UCMProvider, type UCMProviderProps, useUCM, useUCMConfigured, useUCMOptional };

package/dist/react.d.ts

@@ -0,0 +1,312 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { SupabaseClient } from '@supabase/supabase-js';
+
+/**
+ * Universal Content Module - Type Definitions
+ * Supabase-powered content management with multi-language support
+ */
+type ContentType = 'news' | 'daily' | 'blog' | 'doc' | 'event' | 'announcement' | 'tutorial' | 'case_study' | 'faq' | 'changelog' | 'thought' | 'digest' | 'briefing';
+type ContentStatus = 'draft' | 'scheduled' | 'published' | 'archived';
+type ContentVisibility = 'public' | 'internal' | 'unlisted';
+type SupportedLanguage = 'zh' | 'en' | 'ja' | 'ko' | 'es' | 'de' | 'fr';
+type I18nText = Partial<Record<SupportedLanguage, string>>;
+interface Content {
+    id: string;
+    slug: string;
+    type: ContentType;
+    status: ContentStatus;
+    visibility: ContentVisibility;
+    category_id: string | null;
+    title: I18nText;
+    description: I18nText;
+    content: I18nText;
+    cover_image: string | null;
+    images: Array<{
+        url: string;
+        alt?: I18nText;
+    }>;
+    tags: string[];
+    author: string;
+    source: string | null;
+    source_url: string | null;
+    metadata: ContentMetadata;
+    seo: SeoData;
+    featured: boolean;
+    pinned: boolean;
+    published_at: string | null;
+    scheduled_at: string | null;
+    created_at: string;
+    updated_at: string;
+    sort_order: number;
+    view_count: number;
+}
+interface NewsMetadata {
+    wechat_msg_id?: string;
+    original_author?: string;
+    subtype?: 'press' | 'announcement' | 'changelog';
+    version?: string;
+}
+interface DailyMetadata {
+    date: string;
+    market?: Record<string, string>;
+    highlights?: string[];
+}
+interface DigestMetadata {
+    topic?: string;
+    highlights?: string[];
+    sources?: string[];
+    date?: string;
+}
+type BriefingFrequency = 'daily' | 'weekly' | 'monthly';
+interface BriefingMetadata {
+    frequency: BriefingFrequency;
+    period: string;
+    metrics?: Record<string, number>;
+    highlights?: string[];
+    tasks_completed?: number;
+    tasks_pending?: number;
+}
+interface BlogMetadata {
+    reading_time?: number;
+    series?: string;
+    toc?: boolean;
+}
+interface DocMetadata {
+    version?: string;
+    prev_slug?: string;
+    next_slug?: string;
+}
+interface EventMetadata {
+    start_time: string;
+    end_time: string;
+    location?: {
+        type: 'online' | 'offline';
+        url?: string;
+        address?: string;
+    };
+    registration_url?: string;
+    max_attendees?: number;
+    current_attendees?: number;
+}
+type ThoughtType = 'observation' | 'reflection' | 'decision' | 'question' | 'insight' | 'mood';
+type ThoughtMood = 'curious' | 'focused' | 'excited' | 'thoughtful' | 'creative' | 'philosophical' | 'accomplished' | 'inspired' | 'productive' | 'concerned' | 'determined' | 'grateful' | 'contemplative';
+interface ThoughtMediaVideo {
+    url: string;
+    type: 'mp4' | 'youtube';
+}
+interface ThoughtMediaAudio {
+    url: string;
+    title?: string;
+    duration?: number;
+}
+interface ThoughtProductionLink {
+    slug: string;
+    title?: I18nText | string;
+    type?: 'blog' | 'video' | 'tool';
+}
+interface ThoughtComment {
+    user: string;
+    content: string;
+    time?: string;
+}
+interface ThoughtMetadata {
+    thought_type: ThoughtType;
+    agent_id: string;
+    mood?: ThoughtMood;
+    energy?: number;
+    images?: string[];
+    video?: ThoughtMediaVideo;
+    audio?: ThoughtMediaAudio;
+    leads_to?: string | ThoughtProductionLink;
+    comments?: ThoughtComment[];
+    ai_generated?: boolean;
+    generated_at?: string;
+    model?: string;
+}
+interface CaseStudyMetric {
+    label: I18nText;
+    before: string;
+    after: string;
+}
+interface CaseStudyMetadata {
+    product: string;
+    productRoute: string;
+    client: I18nText;
+    industry: I18nText;
+    scale: I18nText;
+    challenge: I18nText;
+    solution: I18nText;
+    metrics: CaseStudyMetric[];
+    quote: I18nText;
+    quotee: I18nText;
+}
+type ContentMetadata = NewsMetadata | DailyMetadata | DigestMetadata | BriefingMetadata | BlogMetadata | DocMetadata | EventMetadata | ThoughtMetadata | CaseStudyMetadata | Record<string, unknown>;
+interface SeoData {
+    title?: I18nText;
+    description?: I18nText;
+    keywords?: string[];
+    og_image?: string;
+    canonical_url?: string;
+}
+interface Category {
+    id: string;
+    parent_id: string | null;
+    slug: string;
+    name: I18nText;
+    description: I18nText;
+    icon: string | null;
+    sort_order: number;
+    created_at: string;
+    children?: Category[];
+}
+interface ContentQueryParams {
+    type?: ContentType;
+    category_id?: string;
+    tags?: string[];
+    featured?: boolean;
+    visibility?: ContentVisibility;
+    limit?: number;
+    offset?: number;
+    orderBy?: 'published_at' | 'created_at' | 'sort_order' | 'view_count';
+    orderDirection?: 'asc' | 'desc';
+}
+interface CategoryQueryParams {
+    parent_id?: string | null;
+    includeChildren?: boolean;
+}
+interface CreateContentInput {
+    slug: string;
+    type: ContentType;
+    status?: ContentStatus;
+    visibility?: ContentVisibility;
+    category_id?: string;
+    title: I18nText;
+    description?: I18nText;
+    content: I18nText;
+    cover_image?: string;
+    images?: Array<{
+        url: string;
+        alt?: I18nText;
+    }>;
+    tags?: string[];
+    author?: string;
+    source?: string;
+    source_url?: string;
+    metadata?: ContentMetadata;
+    seo?: SeoData;
+    featured?: boolean;
+    pinned?: boolean;
+    published_at?: string;
+    scheduled_at?: string;
+}
+type UpdateContentInput = Partial<CreateContentInput>;
+
+/**
+ * Universal Content Module - Core
+ *
+ * 工厂函数模式，支持：
+ * - 依赖注入（便于测试）
+ * - 多实例（多租户场景）
+ * - 框架无关（React/Vue/Node.js 通用）
+ *
+ * @example
+ * ```typescript
+ * // 创建客户端
+ * const ucm = createUCMClient({
+ *   url: 'https://xxx.supabase.co',
+ *   anonKey: 'eyJxxx',
+ * })
+ *
+ * // 使用 API
+ * const posts = await ucm.contents.list({ type: 'blog', limit: 10 })
+ * const post = await ucm.contents.getBySlug('hello-world')
+ * const categories = await ucm.categories.getTree()
+ * ```
+ */
+
+interface UCMClientConfig {
+    /** Supabase project URL */
+    url: string;
+    /** Supabase anon key (for public read) or service key (for write) */
+    anonKey: string;
+    /** Optional: custom Supabase client options */
+    options?: {
+        persistSession?: boolean;
+        autoRefreshToken?: boolean;
+    };
+}
+interface UCMClient {
+    /** Raw Supabase client (for advanced use) */
+    supabase: SupabaseClient;
+    /** Content operations */
+    contents: {
+        list: (params?: ContentQueryParams) => Promise<Content[]>;
+        getBySlug: (slug: string) => Promise<Content | null>;
+        getById: (id: string) => Promise<Content | null>;
+        count: (params?: Pick<ContentQueryParams, 'type' | 'category_id' | 'tags' | 'featured' | 'visibility'>) => Promise<number>;
+        search: (query: string, type?: string, visibility?: string) => Promise<Content[]>;
+        getTags: (type?: string) => Promise<string[]>;
+        create: (input: CreateContentInput) => Promise<Content>;
+        update: (id: string, input: UpdateContentInput) => Promise<Content>;
+        delete: (id: string) => Promise<void>;
+        incrementView: (id: string) => Promise<void>;
+    };
+    /** Category operations */
+    categories: {
+        list: (params?: CategoryQueryParams) => Promise<Category[]>;
+        getTree: () => Promise<Category[]>;
+        getBySlug: (slug: string) => Promise<Category | null>;
+        getById: (id: string) => Promise<Category | null>;
+        getChildren: (parentId: string) => Promise<Category[]>;
+        getRoots: () => Promise<Category[]>;
+        getBreadcrumb: (categoryId: string) => Promise<Category[]>;
+    };
+    /** Storage helpers */
+    storage: {
+        getUrl: (path: string, bucket?: string) => string;
+        getImageUrl: (path: string, options?: {
+            width?: number;
+            height?: number;
+            quality?: number;
+            format?: string;
+        }) => string;
+    };
+    /** Check if client is configured */
+    isConfigured: () => boolean;
+}
+
+interface UCMProviderProps {
+    /** UCM 配置（url + anonKey） */
+    config?: UCMClientConfig;
+    /** 或直接传入已创建的客户端（便于测试） */
+    client?: UCMClient;
+    /** 子组件 */
+    children: ReactNode;
+}
+/**
+ * UCM Provider
+ *
+ * 提供两种使用方式：
+ * 1. 传入 config，自动创建客户端
+ * 2. 传入 client，使用已有客户端（测试场景）
+ */
+declare function UCMProvider({ config, client, children }: UCMProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * 获取 UCM 客户端
+ *
+ * @throws 如果在 UCMProvider 外使用
+ */
+declare function useUCM(): UCMClient;
+/**
+ * 获取 UCM 客户端（可选，不抛错）
+ *
+ * 如果在 Provider 外使用，返回 null client
+ */
+declare function useUCMOptional(): UCMClient;
+/**
+ * 检查 UCM 是否已配置
+ */
+declare function useUCMConfigured(): boolean;
+
+export { type UCMClient, type UCMClientConfig, UCMProvider, type UCMProviderProps, useUCM, useUCMConfigured, useUCMOptional };