@bernierllc/content-management-nextjs 0.0.1 → 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,363 @@
+/**
+ * Local type stubs matching the content management suite's interface contracts.
+ * These will be replaced by imports from @bernierllc/content-management-suite at merge time.
+ */
+interface ContentItem {
+    id: string;
+    type: string;
+    createdAt: string;
+    title?: string;
+    body?: string;
+    data?: Record<string, unknown>;
+    status?: string;
+    channels?: string[];
+    metadata?: Record<string, unknown>;
+    updatedAt?: string;
+    publishedAt?: string;
+    scheduledFor?: Date;
+    workflowId?: string;
+    workflowStage?: string;
+    sourceType?: string | null;
+    sourceId?: string | null;
+}
+interface CreateContentInput {
+    type: string;
+    title?: string;
+    body?: string;
+    data?: Record<string, unknown>;
+    channels?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface UpdateContentInput {
+    title?: string;
+    body?: string;
+    data?: Record<string, unknown>;
+    channels?: string[];
+    metadata?: Record<string, unknown>;
+    status?: string;
+}
+interface ContentFilters {
+    type?: string;
+    status?: string;
+    page?: number;
+    limit?: number;
+}
+interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}
+interface AIReview {
+    id: string;
+    contentId: string;
+    score: number;
+    suggestions: AIReviewSuggestion[];
+    passesThreshold: boolean;
+    rawResult: Record<string, unknown>;
+    createdAt: string;
+}
+interface AIReviewSuggestion {
+    category: string;
+    severity: 'info' | 'warning' | 'error';
+    message: string;
+    originalText?: string;
+    suggestedFix?: string;
+}
+interface SocialPost {
+    id: string;
+    contentId: string;
+    platform: string;
+    body: string;
+    status: 'draft' | 'published' | 'failed';
+    platformPostId?: string | null;
+    publishedAt?: string | null;
+    workflowId?: string;
+    workflowStage?: string;
+    createdAt: string;
+}
+interface Workflow {
+    id: string;
+    name: string;
+    stages: WorkflowStage[];
+    contentType?: string;
+    description?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface WorkflowStage {
+    id: string;
+    name: string;
+    order: number;
+    isPublishStage?: boolean;
+    allowsScheduling?: boolean;
+    description?: string;
+    permissions?: string[];
+    conditions?: StageConditions;
+}
+interface StageConditions {
+    autoAdvance?: boolean;
+    minScore?: number;
+    requiresHumanReview?: boolean;
+}
+interface User {
+    id: string;
+    name: string;
+    email: string;
+    role?: string;
+    permissions?: string[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface ContentTypeDefinition {
+    id: string;
+    name: string;
+    schema?: unknown;
+    defaults?: Record<string, unknown>;
+    description?: string;
+}
+interface PublishResult {
+    channelId: string;
+    success: boolean;
+    url?: string;
+    error?: string;
+}
+interface ContentPublishResult {
+    item: ContentItem;
+    results: PublishResult[];
+}
+interface IngestResult {
+    created: boolean;
+    content: ContentItem;
+}
+interface PlatformPublishResult {
+    platform: string;
+    success: boolean;
+    platformPostId?: string;
+    url?: string;
+    error?: string;
+}
+interface ContentSource {
+    id: string;
+    name: string;
+    outputTypes: string[];
+}
+interface ContentPublisher {
+    id: string;
+    name: string;
+    acceptedTypes: string[];
+}
+interface EnhancedContent {
+    original: string;
+    enhanced: string;
+    changes: Array<{
+        type: string;
+        description: string;
+    }>;
+}
+interface Suggestion {
+    category: string;
+    severity: 'info' | 'warning' | 'error';
+    message: string;
+    suggestedFix?: string;
+}
+interface EnhanceOptions {
+    tone?: string;
+    style?: string;
+    instructions?: string;
+}
+interface PlatformInfo {
+    id: string;
+    name: string;
+    acceptedTypes: string[];
+    hasPreview: boolean;
+    hasMetrics: boolean;
+}
+interface PreviewResult {
+    html?: string;
+    url?: string;
+    text?: string;
+}
+interface SocialMetrics {
+    platform: string;
+    platformPostId: string;
+    impressions?: number;
+    engagement?: number;
+    clicks?: number;
+    shares?: number;
+    raw?: Record<string, unknown>;
+}
+interface ContentNamespace {
+    list(filters?: ContentFilters): Promise<PaginatedResult<ContentItem>>;
+    get(id: string): Promise<ContentItem | null>;
+    create(input: CreateContentInput): Promise<ContentItem>;
+    update(id: string, input: UpdateContentInput): Promise<ContentItem>;
+    delete(id: string): Promise<void>;
+    publish(id: string, options?: {
+        channels?: string[];
+    }): Promise<ContentPublishResult>;
+}
+interface ContentTypesNamespace {
+    register(definition: ContentTypeDefinition): void;
+    unregister(id: string): void;
+    list(): ContentTypeDefinition[];
+    get(id: string): ContentTypeDefinition | undefined;
+}
+interface WorkflowsNamespace {
+    list(): Promise<Workflow[]>;
+    get(id: string): Promise<Workflow>;
+    create(input: Partial<Workflow>): Promise<Workflow>;
+    update(id: string, input: Partial<Workflow>): Promise<Workflow>;
+    delete(id: string): Promise<void>;
+}
+interface PublishersNamespace {
+    register(publisher: ContentPublisher): void;
+    unregister(id: string): void;
+    list(): ContentPublisher[];
+    get(id: string): ContentPublisher | undefined;
+}
+interface SourcesNamespace {
+    register(source: ContentSource): void;
+    unregister(id: string): void;
+    list(): ContentSource[];
+    get(id: string): ContentSource | undefined;
+    ingest(sourceId: string, rawPayload: unknown): Promise<IngestResult>;
+}
+interface AINamespace {
+    review(contentId: string): Promise<AIReview>;
+    generateSocialPosts(contentId: string, platforms: string[]): Promise<SocialPost[]>;
+    enhance(contentId: string, opts?: EnhanceOptions): Promise<EnhancedContent>;
+    suggest(contentId: string): Promise<Suggestion[]>;
+}
+interface SocialNamespace {
+    registerPlatform(adapter: unknown): void;
+    unregisterPlatform(id: string): void;
+    listPlatforms(): PlatformInfo[];
+    publish(contentId: string, platforms: string[]): Promise<PlatformPublishResult[]>;
+    preview(contentId: string, platform: string): Promise<PreviewResult>;
+    getMetrics(contentId: string, platform: string): Promise<SocialMetrics>;
+}
+interface UsersNamespace {
+    list(): Promise<User[]>;
+    get(id: string): Promise<User | null>;
+    create(input: Partial<User>): Promise<User>;
+    update(id: string, input: Partial<User>): Promise<User>;
+    delete(id: string): Promise<void>;
+}
+interface PermissionsNamespace {
+    check(userId: string, permission: string): Promise<boolean>;
+    grant(userId: string, permission: string): Promise<void>;
+    revoke(userId: string, permission: string): Promise<void>;
+    list(userId: string): Promise<string[]>;
+}
+interface ConfigNamespace {
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T): void;
+    getAll(): Record<string, unknown>;
+}
+interface PluginsNamespace {
+    register(plugin: unknown): void;
+    unregister(id: string): void;
+    list(): unknown[];
+    get(id: string): unknown | undefined;
+}
+interface ContentManagementSuite {
+    readonly content: ContentNamespace;
+    readonly contentTypes: ContentTypesNamespace;
+    readonly workflows: WorkflowsNamespace;
+    readonly publishers: PublishersNamespace;
+    readonly sources: SourcesNamespace;
+    readonly ai: AINamespace;
+    readonly social: SocialNamespace;
+    readonly users: UsersNamespace;
+    readonly permissions: PermissionsNamespace;
+    readonly config: ConfigNamespace;
+    readonly plugins: PluginsNamespace;
+    initialize(): Promise<void>;
+    dispose(): Promise<void>;
+}
+declare class ContentManagementError extends Error {
+    readonly code: string;
+    readonly context: Record<string, unknown> | undefined;
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+        context?: Record<string, unknown>;
+    });
+}
+declare class ValidationError extends ContentManagementError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+        context?: Record<string, unknown>;
+    });
+}
+declare class NotFoundError extends ContentManagementError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+        context?: Record<string, unknown>;
+    });
+}
+declare class UnauthorizedError extends ContentManagementError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+        context?: Record<string, unknown>;
+    });
+}
+declare class ForbiddenError extends ContentManagementError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+        context?: Record<string, unknown>;
+    });
+}
+declare class ConflictError extends ContentManagementError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+        context?: Record<string, unknown>;
+    });
+}
+declare class InternalError extends ContentManagementError {
+    constructor(message: string, options?: {
+        cause?: Error;
+        code?: string;
+        context?: Record<string, unknown>;
+    });
+}
+interface RouteHandlerOptions {
+    auth: (request: Request) => Promise<{
+        userId: string;
+    } | null>;
+    basePath?: string;
+}
+interface AuthUser {
+    userId: string;
+}
+
+interface RouteHandlers {
+    GET: (request: Request) => Promise<Response>;
+    POST: (request: Request) => Promise<Response>;
+    PUT: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Promise<Response>;
+}
+/**
+ * Create Next.js App Router route handlers for the content management suite.
+ *
+ * Returns GET, POST, PUT, DELETE functions that internally route based on the URL path.
+ */
+declare function createContentRouteHandlers(suite: ContentManagementSuite, options: RouteHandlerOptions): RouteHandlers;
+
+/**
+ * Map error instances to HTTP status codes.
+ */
+declare function errorToStatusCode(error: unknown): number;
+/**
+ * Extract an error message suitable for HTTP responses.
+ */
+declare function errorToMessage(error: unknown): string;
+
+export { type AIReview, type AIReviewSuggestion, type AuthUser, ConflictError, type ContentFilters, type ContentItem, ContentManagementError, type ContentManagementSuite, type ContentPublishResult, type ContentPublisher, type ContentSource, type ContentTypeDefinition, type CreateContentInput, ForbiddenError, type IngestResult, InternalError, NotFoundError, type PaginatedResult, type PlatformPublishResult, type PublishResult, type RouteHandlerOptions, type RouteHandlers, type SocialPost, type StageConditions, UnauthorizedError, type UpdateContentInput, type User, ValidationError, type Workflow, type WorkflowStage, createContentRouteHandlers, errorToMessage, errorToStatusCode };