@contentful/mcp-server 1.1.0 → 1.2.0

package/build/tools/assets/mockClient.js

@@ -0,0 +1,159 @@
+import { vi } from 'vitest';
+import { createToolClient } from '../../utils/tools.js';
+/**
+ * Shared mock objects for asset tests
+ * Provides standardized mock client and asset objects used across all asset tests
+ */
+// Create mock functions for the client
+export const mockAssetGet = vi.fn();
+export const mockAssetCreate = vi.fn();
+export const mockAssetUpdate = vi.fn();
+export const mockAssetDelete = vi.fn();
+export const mockAssetPublish = vi.fn();
+export const mockAssetUnpublish = vi.fn();
+export const mockAssetGetMany = vi.fn();
+export const mockAssetProcessForAllLocales = vi.fn();
+// Mock bulk operations
+export const mockBulkActionPublish = vi.fn();
+export const mockBulkActionUnpublish = vi.fn();
+export const mockBulkActionGet = vi.fn();
+/**
+ * Standard mock Contentful client with all asset operations
+ */
+export const mockClient = {
+    asset: {
+        get: mockAssetGet,
+        create: mockAssetCreate,
+        update: mockAssetUpdate,
+        delete: mockAssetDelete,
+        publish: mockAssetPublish,
+        unpublish: mockAssetUnpublish,
+        getMany: mockAssetGetMany,
+        processForAllLocales: mockAssetProcessForAllLocales,
+    },
+    bulkAction: {
+        publish: mockBulkActionPublish,
+        unpublish: mockBulkActionUnpublish,
+        get: mockBulkActionGet,
+    },
+};
+/**
+ * Sets up the mock client for tests
+ * Call this in beforeEach to ensure the mock is properly configured
+ */
+export function setupMockClient() {
+    vi.mocked(createToolClient).mockReturnValue(mockClient);
+}
+/**
+ * Standard mock asset object used across tests
+ */
+export const mockAsset = {
+    sys: {
+        id: 'test-asset-id',
+        type: 'Asset',
+        version: 1,
+        space: {
+            sys: {
+                type: 'Link',
+                linkType: 'Space',
+                id: 'test-space-id',
+            },
+        },
+        environment: {
+            sys: {
+                type: 'Link',
+                linkType: 'Environment',
+                id: 'test-environment',
+            },
+        },
+        createdAt: '2023-01-01T00:00:00Z',
+        updatedAt: '2023-01-01T00:00:00Z',
+        publishedVersion: 1,
+    },
+    fields: {
+        title: {
+            'en-US': 'Test Asset',
+        },
+        description: {
+            'en-US': 'A test asset for unit tests',
+        },
+        file: {
+            'en-US': {
+                fileName: 'test-image.jpg',
+                contentType: 'image/jpeg',
+                url: 'https://images.ctfassets.net/test/test-image.jpg',
+                details: {
+                    size: 12345,
+                    image: {
+                        width: 800,
+                        height: 600,
+                    },
+                },
+            },
+        },
+    },
+};
+/**
+ * Standard test arguments for asset operations
+ */
+export const mockArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment',
+    assetId: 'test-asset-id',
+};
+/**
+ * Mock file object for upload tests
+ */
+export const mockFile = {
+    fileName: 'test-image.jpg',
+    contentType: 'image/jpeg',
+    upload: 'https://upload.example.com/test-upload-url',
+};
+/**
+ * Mock assets list response
+ */
+export const mockAssetsResponse = {
+    total: 2,
+    skip: 0,
+    limit: 3,
+    items: [
+        mockAsset,
+        {
+            ...mockAsset,
+            sys: { ...mockAsset.sys, id: 'another-asset-id' },
+            fields: {
+                ...mockAsset.fields,
+                title: { 'en-US': 'Another Test Asset' },
+            },
+        },
+    ],
+};
+/**
+ * Mock bulk action response
+ */
+export const mockBulkAction = {
+    sys: {
+        id: 'bulk-action-id',
+        type: 'BulkAction',
+        status: 'succeeded',
+        createdAt: '2023-01-01T00:00:00Z',
+        updatedAt: '2023-01-01T00:00:00Z',
+    },
+    action: 'publish',
+    payload: {},
+};
+/**
+ * Mock processed asset for upload
+ */
+export const mockProcessedAsset = {
+    ...mockAsset,
+    fields: {
+        ...mockAsset.fields,
+        file: {
+            'en-US': {
+                ...mockAsset.fields.file['en-US'],
+                url: 'https://images.ctfassets.net/processed/test-image.jpg',
+            },
+        },
+    },
+};

package/build/tools/content-types/createContentType.js

@@ -9,6 +9,10 @@ export const CreateContentTypeToolParams = BaseToolSchema.extend({
         .string()
         .optional()
         .describe('Description of the content type'),
+    contentTypeId: z
+        .string()
+        .optional()
+        .describe('Optional ID for the content type. If provided, will use createWithId method'),
     fields: z
         .array(FieldSchema)
         .describe('Array of field definitions for the content type'),
@@ -19,13 +23,16 @@ async function tool(args) {
         environmentId: args.environmentId,
     };
     const contentfulClient = createToolClient(args);
-    // Create the content type
-    const contentType = await contentfulClient.contentType.create(params, {
+    const contentTypeData = {
         name: args.name,
         displayField: args.displayField,
         description: args.description,
         fields: args.fields,
-    });
+    };
+    // Create the content type with or without ID
+    const contentType = args.contentTypeId
+        ? await contentfulClient.contentType.createWithId({ ...params, contentTypeId: args.contentTypeId }, contentTypeData)
+        : await contentfulClient.contentType.create(params, contentTypeData);
     return createSuccessResponse('Content type created successfully', {
         contentType,
     });

package/build/tools/content-types/mockClient.js

@@ -1,38 +1,42 @@
 import { vi } from 'vitest';
-import { createToolClient } from '../../utils/tools.js';
 /**
  * Shared mock objects for content type tests
  * Provides standardized mock client and content type objects used across all content type tests
  */
-// Create mock functions for the client
-export const mockContentTypeGet = vi.fn();
-export const mockContentTypeCreate = vi.fn();
-export const mockContentTypeUpdate = vi.fn();
-export const mockContentTypeDelete = vi.fn();
-export const mockContentTypePublish = vi.fn();
-export const mockContentTypeUnpublish = vi.fn();
-export const mockContentTypeGetMany = vi.fn();
-/**
- * Standard mock Contentful client with all content type operations
- */
-export const mockClient = {
-    contentType: {
-        get: mockContentTypeGet,
-        create: mockContentTypeCreate,
-        update: mockContentTypeUpdate,
-        delete: mockContentTypeDelete,
-        publish: mockContentTypePublish,
-        unpublish: mockContentTypeUnpublish,
-        getMany: mockContentTypeGetMany,
-    },
-};
-/**
- * Sets up the mock client for tests
- * Call this in beforeEach to ensure the mock is properly configured
- */
-export function setupMockClient() {
-    vi.mocked(createToolClient).mockReturnValue(mockClient);
-}
+const { mockContentTypeGet, mockContentTypeCreate, mockContentTypeCreateWithId, mockContentTypeUpdate, mockContentTypeDelete, mockContentTypePublish, mockContentTypeUnpublish, mockContentTypeGetMany, mockCreateToolClient, } = vi.hoisted(() => {
+    return {
+        mockContentTypeGet: vi.fn(),
+        mockContentTypeCreate: vi.fn(),
+        mockContentTypeCreateWithId: vi.fn(),
+        mockContentTypeUpdate: vi.fn(),
+        mockContentTypeDelete: vi.fn(),
+        mockContentTypePublish: vi.fn(),
+        mockContentTypeUnpublish: vi.fn(),
+        mockContentTypeGetMany: vi.fn(),
+        mockCreateToolClient: vi.fn(() => {
+            return {
+                contentType: {
+                    get: mockContentTypeGet,
+                    create: mockContentTypeCreate,
+                    createWithId: mockContentTypeCreateWithId,
+                    update: mockContentTypeUpdate,
+                    delete: mockContentTypeDelete,
+                    publish: mockContentTypePublish,
+                    unpublish: mockContentTypeUnpublish,
+                    getMany: mockContentTypeGetMany,
+                },
+            };
+        }),
+    };
+});
+vi.mock('../../utils/tools.js', async (importOriginal) => {
+    const org = await importOriginal();
+    return {
+        ...org,
+        createToolClient: mockCreateToolClient,
+    };
+});
+export { mockContentTypeGet, mockContentTypeCreate, mockContentTypeCreateWithId, mockContentTypeUpdate, mockContentTypeDelete, mockContentTypePublish, mockContentTypeUnpublish, mockContentTypeGetMany, mockCreateToolClient, };
 /**
  * Standard mock content type object used across tests
  */

package/build/tools/locales/mockClient.js

@@ -0,0 +1,54 @@
+import { vi } from 'vitest';
+const { mockLocaleCreate, mockLocaleGet, mockLocaleDelete, mockLocaleGetMany, mockLocaleUpdate, mockCreateToolClient, } = vi.hoisted(() => {
+    return {
+        mockLocaleCreate: vi.fn(),
+        mockLocaleGet: vi.fn(),
+        mockLocaleDelete: vi.fn(),
+        mockLocaleGetMany: vi.fn(),
+        mockLocaleUpdate: vi.fn(),
+        mockCreateToolClient: vi.fn(() => {
+            return {
+                locale: {
+                    create: mockLocaleCreate,
+                    get: mockLocaleGet,
+                    delete: mockLocaleDelete,
+                    getMany: mockLocaleGetMany,
+                    update: mockLocaleUpdate,
+                },
+            };
+        }),
+    };
+});
+vi.mock('../../utils/tools.js', async (importOriginal) => {
+    const org = await importOriginal();
+    return {
+        ...org,
+        createToolClient: mockCreateToolClient,
+    };
+});
+export { mockLocaleCreate, mockLocaleGet, mockLocaleDelete, mockLocaleGetMany, mockLocaleUpdate, mockCreateToolClient, };
+export const testLocale = {
+    name: 'Test Locale',
+    code: 'en-US',
+    fallbackCode: null,
+    contentDeliveryApi: true,
+    contentManagementApi: true,
+    default: true,
+    optional: false,
+    sys: {
+        id: 'test-locale-id',
+        type: 'Locale',
+        space: { sys: { type: 'Link', linkType: 'Space', id: 'test-space-id' } },
+        environment: {
+            sys: { type: 'Link', linkType: 'Environment', id: 'test-environment-id' },
+        },
+        createdAt: '2025-08-25T10:00:00Z',
+        updatedAt: '2025-08-25T10:00:00Z',
+        version: 1,
+    },
+};
+export const mockArgs = {
+    spaceId: 'test-space-id',
+    environmentId: 'test-environment-id',
+    cmaToken: 'test-cma-token',
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-server",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/contentful/contentful-mcp-server"