@revealui/ai 0.1.0

package/dist/tools/cms/factory.js

@@ -0,0 +1,462 @@
+/**
+ * CMS Tools Factory
+ * Creates CMS tools with API client injected for actual execution
+ */
+import { createDocumentTool, deleteDocumentTool, findDocumentsTool, getDocumentTool, listCollectionsTool, updateDocumentTool, } from './collection-tools.js';
+import { getGlobalTool, listGlobalsTool, updateGlobalTool } from './global-tools.js';
+import { deleteMediaTool, getMediaTool, listMediaTool, updateMediaTool, uploadMediaTool, } from './media-tools.js';
+import { createUserTool, deleteUserTool, getCurrentUserTool, listUsersTool, updateUserTool, } from './user-tools.js';
+/**
+ * Create CMS tools with API client injected
+ * This factory function creates functional tools by injecting the actual API implementation
+ */
+export function createCMSTools(config) {
+    const { apiClient, collections, globals, user } = config;
+    // Clone tools and inject API client implementation
+    const tools = [];
+    // Collection Tools
+    tools.push({
+        ...listCollectionsTool,
+        async execute() {
+            if (collections && collections.length > 0) {
+                return {
+                    success: true,
+                    data: { collections, count: collections.length },
+                };
+            }
+            return listCollectionsTool.execute({});
+        },
+    });
+    tools.push({
+        ...findDocumentsTool,
+        async execute(params) {
+            const { collection, page, limit, where, sort } = params;
+            try {
+                const response = await apiClient.find({
+                    collection,
+                    page,
+                    limit,
+                    where,
+                    sort,
+                });
+                return {
+                    success: true,
+                    data: {
+                        documents: response.docs || [],
+                        totalDocs: response.totalDocs || 0,
+                        page: response.page || 1,
+                        totalPages: response.totalPages || 1,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to find documents: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...getDocumentTool,
+        async execute(params) {
+            const { collection, id } = params;
+            try {
+                const document = await apiClient.findById(collection, id);
+                return {
+                    success: true,
+                    data: document,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to get document: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...createDocumentTool,
+        async execute(params) {
+            const { collection, data } = params;
+            try {
+                const document = await apiClient.create({ collection, data });
+                return {
+                    success: true,
+                    data: document,
+                    metadata: {
+                        message: `Created ${collection} document successfully`,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to create document: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...updateDocumentTool,
+        async execute(params) {
+            const { collection, id, data } = params;
+            try {
+                const document = await apiClient.update({ collection, id, data });
+                return {
+                    success: true,
+                    data: document,
+                    metadata: {
+                        message: `Updated ${collection} document successfully`,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to update document: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...deleteDocumentTool,
+        async execute(params) {
+            const { collection, id } = params;
+            try {
+                await apiClient.delete({ collection, id });
+                return {
+                    success: true,
+                    metadata: {
+                        message: `Deleted ${collection} document successfully`,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to delete document: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    // Global Tools
+    tools.push({
+        ...listGlobalsTool,
+        async execute() {
+            if (globals && globals.length > 0) {
+                return {
+                    success: true,
+                    data: { globals, count: globals.length },
+                };
+            }
+            return listGlobalsTool.execute({});
+        },
+    });
+    tools.push({
+        ...getGlobalTool,
+        async execute(params) {
+            const { slug, depth } = params;
+            try {
+                const global = await apiClient.findGlobal({ slug, depth });
+                return {
+                    success: true,
+                    data: global,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to get global: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...updateGlobalTool,
+        async execute(params) {
+            const { slug, data } = params;
+            try {
+                const global = await apiClient.updateGlobal({ slug, data });
+                return {
+                    success: true,
+                    data: global,
+                    metadata: {
+                        message: `Updated ${slug} global successfully`,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to update global: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    // Media Tools (use collection 'media' for now)
+    tools.push({
+        ...listMediaTool,
+        async execute(params) {
+            const { page, limit, mimeType } = params;
+            try {
+                const where = mimeType ? { mimeType } : undefined;
+                const response = await apiClient.find({
+                    collection: 'media',
+                    page,
+                    limit,
+                    where,
+                });
+                return {
+                    success: true,
+                    data: {
+                        media: response.docs || [],
+                        totalDocs: response.totalDocs || 0,
+                        page: response.page || 1,
+                        totalPages: response.totalPages || 1,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to list media: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...getMediaTool,
+        async execute(params) {
+            const { id } = params;
+            try {
+                const media = await apiClient.findById('media', id);
+                return {
+                    success: true,
+                    data: media,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to get media: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...uploadMediaTool,
+        async execute(params) {
+            const { filename, mimeType, data: _data, alt, } = params;
+            try {
+                // For now, create media document
+                // In full implementation, would upload to storage first
+                const media = await apiClient.create({
+                    collection: 'media',
+                    data: {
+                        filename,
+                        mimeType,
+                        alt,
+                        // Note: Actual file upload would happen here
+                    },
+                });
+                return {
+                    success: true,
+                    data: media,
+                    metadata: {
+                        message: `Uploaded ${filename} successfully`,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to upload media: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...updateMediaTool,
+        async execute(params) {
+            const { id, alt, title, description } = params;
+            try {
+                const data = {};
+                if (alt !== undefined)
+                    data.alt = alt;
+                if (title !== undefined)
+                    data.title = title;
+                if (description !== undefined)
+                    data.description = description;
+                const media = await apiClient.update({
+                    collection: 'media',
+                    id,
+                    data,
+                });
+                return {
+                    success: true,
+                    data: media,
+                    metadata: {
+                        message: 'Updated media metadata successfully',
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to update media: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...deleteMediaTool,
+        async execute(params) {
+            const { id } = params;
+            try {
+                await apiClient.delete({ collection: 'media', id });
+                return {
+                    success: true,
+                    metadata: {
+                        message: 'Deleted media successfully',
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to delete media: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    // User Tools (use collection 'users' for now)
+    tools.push({
+        ...getCurrentUserTool,
+        async execute() {
+            if (user) {
+                return {
+                    success: true,
+                    data: user,
+                };
+            }
+            return {
+                success: false,
+                error: 'No user context available',
+            };
+        },
+    });
+    tools.push({
+        ...listUsersTool,
+        async execute(params) {
+            const { page, limit, role } = params;
+            try {
+                const where = role ? { role } : undefined;
+                const response = await apiClient.find({
+                    collection: 'users',
+                    page,
+                    limit,
+                    where,
+                });
+                return {
+                    success: true,
+                    data: {
+                        users: response.docs || [],
+                        totalDocs: response.totalDocs || 0,
+                        page: response.page || 1,
+                        totalPages: response.totalPages || 1,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to list users: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...createUserTool,
+        async execute(params) {
+            const { email, password, name, role } = params;
+            try {
+                const user = await apiClient.create({
+                    collection: 'users',
+                    data: { email, password, name, role },
+                });
+                return {
+                    success: true,
+                    data: user,
+                    metadata: {
+                        message: `Created user ${email} successfully`,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to create user: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...updateUserTool,
+        async execute(params) {
+            const { id, email, name, role, password } = params;
+            try {
+                const data = {};
+                if (email !== undefined)
+                    data.email = email;
+                if (name !== undefined)
+                    data.name = name;
+                if (role !== undefined)
+                    data.role = role;
+                if (password !== undefined)
+                    data.password = password;
+                const user = await apiClient.update({
+                    collection: 'users',
+                    id,
+                    data,
+                });
+                return {
+                    success: true,
+                    data: user,
+                    metadata: {
+                        message: 'Updated user successfully',
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to update user: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    tools.push({
+        ...deleteUserTool,
+        async execute(params) {
+            const { id } = params;
+            try {
+                await apiClient.delete({ collection: 'users', id });
+                return {
+                    success: true,
+                    metadata: {
+                        message: 'Deleted user successfully',
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: `Failed to delete user: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        },
+    });
+    return tools;
+}

package/dist/tools/cms/global-tools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CMS Global Tools
+ * Tools for managing global content (Header, Footer, Settings)
+ */
+import type { Tool } from '../base.js';
+/**
+ * Tool: List all globals
+ * Returns available global configurations
+ */
+export declare const listGlobalsTool: Tool;
+/**
+ * Tool: Get a global by slug
+ * Retrieve global configuration data
+ */
+export declare const getGlobalTool: Tool;
+/**
+ * Tool: Update a global
+ * Modify global configuration
+ */
+export declare const updateGlobalTool: Tool;
+//# sourceMappingURL=global-tools.d.ts.map

package/dist/tools/cms/global-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/global-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAwB3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,IA+B9B,CAAA"}

package/dist/tools/cms/global-tools.js

@@ -0,0 +1,92 @@
+/**
+ * CMS Global Tools
+ * Tools for managing global content (Header, Footer, Settings)
+ */
+import { z } from 'zod/v4';
+/**
+ * Tool: List all globals
+ * Returns available global configurations
+ */
+export const listGlobalsTool = {
+    name: 'list_globals',
+    description: 'Get a list of all available CMS globals. Globals are site-wide settings like Header, Footer, and Settings.',
+    parameters: z.object({}),
+    async execute() {
+        try {
+            // This will be injected with RevealUI config at runtime
+            const globals = [
+                { slug: 'header', label: 'Header', description: 'Site header and navigation' },
+                { slug: 'footer', label: 'Footer', description: 'Site footer content' },
+                { slug: 'settings', label: 'Settings', description: 'Global site settings' },
+            ];
+            return {
+                success: true,
+                data: {
+                    globals,
+                    count: globals.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to list globals: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+/**
+ * Tool: Get a global by slug
+ * Retrieve global configuration data
+ */
+export const getGlobalTool = {
+    name: 'get_global',
+    description: 'Get the current configuration of a CMS global. Use this to see the current state before updating (e.g., current header navigation items).',
+    parameters: z.object({
+        slug: z.string().describe('The global slug (e.g., "header", "footer", "settings")'),
+        depth: z.number().optional().describe('Depth of populated relationships (default: 0, max: 10)'),
+    }),
+    async execute(params) {
+        const { slug: _slug, depth: _depth = 0 } = params;
+        try {
+            // API client will be injected at runtime
+            throw new Error('API client not configured. This tool must be registered with an API client instance.');
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to get global: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+/**
+ * Tool: Update a global
+ * Modify global configuration
+ */
+export const updateGlobalTool = {
+    name: 'update_global',
+    description: 'Update a CMS global configuration. Use this to modify site-wide settings like header navigation, footer links, or global settings. Common uses:\n- Add/remove navigation links in header\n- Update footer content\n- Change site-wide settings\n\nExample for header navigation:\n{\n  "slug": "header",\n  "data": {\n    "navItems": [\n      {"link": {"type": "custom", "label": "Home", "url": "/"}},\n      {"link": {"type": "custom", "label": "About", "url": "/about"}}\n    ]\n  }\n}',
+    parameters: z.object({
+        slug: z.string().describe('The global slug (e.g., "header", "footer", "settings")'),
+        data: z
+            .record(z.string(), z.unknown())
+            .describe('The global data to update as key-value pairs. For header/footer, this typically includes:\n' +
+            '- navItems: Array of navigation items\n' +
+            '- Each navItem has a "link" object with type, label, url, and optional newTab\n' +
+            'Example: {navItems: [{link: {type: "custom", label: "Home", url: "/"}}]}'),
+    }),
+    async execute(params) {
+        const { slug: _slug, data: _data } = params;
+        try {
+            // API client will be injected at runtime
+            throw new Error('API client not configured. This tool must be registered with an API client instance.');
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to update global: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};

package/dist/tools/cms/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CMS Tools Package
+ * Complete set of tools for AI-powered CMS management
+ */
+export { createDocumentTool, deleteDocumentTool, findDocumentsTool, getDocumentTool, listCollectionsTool, updateDocumentTool, } from './collection-tools.js';
+export type { CMSAPIClient, CMSToolsConfig, CollectionMetadata, GlobalMetadata, UserContext, } from './factory.js';
+export { createCMSTools } from './factory.js';
+export { getGlobalTool, listGlobalsTool, updateGlobalTool } from './global-tools.js';
+export { deleteMediaTool, getMediaTool, listMediaTool, updateMediaTool, uploadMediaTool, } from './media-tools.js';
+export { createUserTool, deleteUserTool, getCurrentUserTool, listUsersTool, updateUserTool, } from './user-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/cms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAA"}

package/dist/tools/cms/index.js

@@ -0,0 +1,11 @@
+/**
+ * CMS Tools Package
+ * Complete set of tools for AI-powered CMS management
+ */
+// Export individual tool definitions (for documentation/reference)
+export { createDocumentTool, deleteDocumentTool, findDocumentsTool, getDocumentTool, listCollectionsTool, updateDocumentTool, } from './collection-tools.js';
+// Export factory for creating functional tools
+export { createCMSTools } from './factory.js';
+export { getGlobalTool, listGlobalsTool, updateGlobalTool } from './global-tools.js';
+export { deleteMediaTool, getMediaTool, listMediaTool, updateMediaTool, uploadMediaTool, } from './media-tools.js';
+export { createUserTool, deleteUserTool, getCurrentUserTool, listUsersTool, updateUserTool, } from './user-tools.js';

package/dist/tools/cms/media-tools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CMS Media Tools
+ * Tools for managing media files (images, videos, documents)
+ */
+import type { Tool } from '../base.js';
+/**
+ * Tool: List media files
+ * Browse the media library
+ */
+export declare const listMediaTool: Tool;
+/**
+ * Tool: Get media by ID
+ * Retrieve a specific media file
+ */
+export declare const getMediaTool: Tool;
+/**
+ * Tool: Upload media
+ * Upload a new media file
+ */
+export declare const uploadMediaTool: Tool;
+/**
+ * Tool: Delete media
+ * Remove a media file from the library
+ */
+export declare const deleteMediaTool: Tool;
+/**
+ * Tool: Update media metadata
+ * Update media file metadata (alt text, title, etc.)
+ */
+export declare const updateMediaTool: Tool;
+//# sourceMappingURL=media-tools.d.ts.map

package/dist/tools/cms/media-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/media-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAqC3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,IAsB1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAyC7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAuB7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAoC7B,CAAA"}