@terminalfour/terminalfour-js 1.0.0 → 1.0.2

package/dist/cjs/resources/content-type-resource.d.ts

@@ -239,10 +239,29 @@ export declare class ContentTypeResource {
                 maxRepeats?: number;
             };
         }>;
+        /**
+         * Existing fields to modify, matched by `name`. Only the provided
+         * properties are changed; omitted ones are left as-is. Use this to change
+         * an element's length (`maxSize`), description, or its `required`/`shown`
+         * flags. Throws if a named field does not exist on the content type.
+         */
+        updateFields?: Array<{
+            name: string;
+            maxSize?: number;
+            description?: string;
+            required?: boolean;
+            shown?: boolean;
+        }>;
         /** Field names to remove from the content type */
         removeFields?: string[];
     }): Promise<ContentType>;
-    /** Deletes a content type by ID. */
+    /**
+     * Deletes a content type by ID.
+     *
+     * System content types (`type === 30`) are managed by T4 and back core
+     * features; deleting one can break the instance, so this is blocked with a
+     * clear error. There is no override.
+     */
     delete(id: number): Promise<void>;
     /** Creates a new content type. */
     create(data: {

package/dist/cjs/resources/content-type-resource.js

@@ -809,6 +809,22 @@ class ContentTypeResource {
             ct.sharedGroups = data.sharedGroups;
         if (data.primaryGroup !== undefined)
             ct.primaryGroup = data.primaryGroup;
+        if (data.updateFields) {
+            for (const change of data.updateFields) {
+                const field = ct.fields[change.name];
+                if (!field) {
+                    throw new Error(`Cannot update field "${change.name}" because it does not exist on content type "${ct.name}".`);
+                }
+                if (change.maxSize !== undefined)
+                    field.maxSize = change.maxSize;
+                if (change.description !== undefined)
+                    field.description = change.description;
+                if (change.required !== undefined)
+                    field.required = change.required;
+                if (change.shown !== undefined)
+                    field.shown = change.shown;
+            }
+        }
         if (data.removeFields) {
             for (const fieldName of data.removeFields) {
                 ct.removeField(fieldName);
@@ -822,8 +838,23 @@ class ContentTypeResource {
         await ct.save();
         return ct;
     }
-    /** Deletes a content type by ID. */
+    /**
+     * Deletes a content type by ID.
+     *
+     * System content types (`type === 30`) are managed by T4 and back core
+     * features; deleting one can break the instance, so this is blocked with a
+     * clear error. There is no override.
+     */
     async delete(id) {
+        const raw = await this.httpClient.request({
+            method: 'GET',
+            path: `/contenttype/${id}`,
+        });
+        if (raw.type === SYSTEM_CONTENT_TYPE) {
+            const name = (0, utils_js_1.decodeHtmlEntities)(raw.alias || raw.name);
+            throw new Error(`Cannot delete content type "${name}" (${id}) because it is a system content type. ` +
+                'Deleting system content types is not allowed.');
+        }
         await this.httpClient.request({
             method: 'DELETE',
             path: `/contenttype/${id}`,

package/dist/esm/resources/content-type-resource.d.ts

@@ -239,10 +239,29 @@ export declare class ContentTypeResource {
                 maxRepeats?: number;
             };
         }>;
+        /**
+         * Existing fields to modify, matched by `name`. Only the provided
+         * properties are changed; omitted ones are left as-is. Use this to change
+         * an element's length (`maxSize`), description, or its `required`/`shown`
+         * flags. Throws if a named field does not exist on the content type.
+         */
+        updateFields?: Array<{
+            name: string;
+            maxSize?: number;
+            description?: string;
+            required?: boolean;
+            shown?: boolean;
+        }>;
         /** Field names to remove from the content type */
         removeFields?: string[];
     }): Promise<ContentType>;
-    /** Deletes a content type by ID. */
+    /**
+     * Deletes a content type by ID.
+     *
+     * System content types (`type === 30`) are managed by T4 and back core
+     * features; deleting one can break the instance, so this is blocked with a
+     * clear error. There is no override.
+     */
     delete(id: number): Promise<void>;
     /** Creates a new content type. */
     create(data: {

package/dist/esm/resources/content-type-resource.js

@@ -804,6 +804,22 @@ export class ContentTypeResource {
             ct.sharedGroups = data.sharedGroups;
         if (data.primaryGroup !== undefined)
             ct.primaryGroup = data.primaryGroup;
+        if (data.updateFields) {
+            for (const change of data.updateFields) {
+                const field = ct.fields[change.name];
+                if (!field) {
+                    throw new Error(`Cannot update field "${change.name}" because it does not exist on content type "${ct.name}".`);
+                }
+                if (change.maxSize !== undefined)
+                    field.maxSize = change.maxSize;
+                if (change.description !== undefined)
+                    field.description = change.description;
+                if (change.required !== undefined)
+                    field.required = change.required;
+                if (change.shown !== undefined)
+                    field.shown = change.shown;
+            }
+        }
         if (data.removeFields) {
             for (const fieldName of data.removeFields) {
                 ct.removeField(fieldName);
@@ -817,8 +833,23 @@ export class ContentTypeResource {
         await ct.save();
         return ct;
     }
-    /** Deletes a content type by ID. */
+    /**
+     * Deletes a content type by ID.
+     *
+     * System content types (`type === 30`) are managed by T4 and back core
+     * features; deleting one can break the instance, so this is blocked with a
+     * clear error. There is no override.
+     */
     async delete(id) {
+        const raw = await this.httpClient.request({
+            method: 'GET',
+            path: `/contenttype/${id}`,
+        });
+        if (raw.type === SYSTEM_CONTENT_TYPE) {
+            const name = decodeHtmlEntities(raw.alias || raw.name);
+            throw new Error(`Cannot delete content type "${name}" (${id}) because it is a system content type. ` +
+                'Deleting system content types is not allowed.');
+        }
         await this.httpClient.request({
             method: 'DELETE',
             path: `/contenttype/${id}`,

package/docs/content-types.md

@@ -167,6 +167,21 @@ await t4.contentTypes.update(44, {
 });
 ```
 
+Change properties of existing fields with `updateFields`. Fields are matched by `name`, and only the properties you supply are changed — anything you omit is left as-is. This is how you increase an element's length (`maxSize`):
+
+```typescript
+await t4.contentTypes.update(44, {
+  updateFields: [
+    { name: 'Title', maxSize: 500 },
+    { name: 'Summary', description: 'Short teaser', required: true, shown: false },
+  ],
+});
+```
+
+`updateFields` can change `maxSize`, `description`, `required`, and `shown`. It throws if a named field does not exist on the content type, and (like the other field operations) nothing is sent to T4 when it throws. To change a field's *type* or *name*, remove it and add a new one instead.
+
+`updateFields`, `removeFields`, and `addFields` can be combined in a single call; updates are applied first, then removals, then additions.
+
 ### Mutable item
 
 ```typescript
@@ -231,6 +246,8 @@ Delete a content type through the resource:
 await t4.contentTypes.delete(44);
 ```
 
+System content types cannot be deleted — see [System content types](#system-content-types) below.
+
 ## System content types
 
 System content types are managed by T4 and back core features. Removing or renaming their elements can break the instance, so the SDK blocks both on `save()` (and through `update({ removeFields })`):
@@ -249,10 +266,22 @@ On a system content type you can still:
 - Change an element's `maxSize`
 - Change the content type's `description` and any element's `description`
 
-Two system content types are exempt, because removing and renaming their elements is safe: the **Section Metadata** content type and the **Extended User** content type. On those two, removal and renaming work exactly like a regular content type.
+Two system content types are exempt from the element removal and renaming guard, because removing and renaming their elements is safe: the **Section Metadata** content type and the **Extended User** content type. On those two, removal and renaming work exactly like a regular content type.
 
 The check runs when you call `save()` or `update()`, not when you call `removeField()`. Because `removeField()` only stages the change in memory, nothing is sent to T4 when the guard blocks a save.
 
+### Deleting a system content type is always blocked
+
+`delete()` refuses to delete **any** system content type, with no exceptions. Deleting a system content type outright (rather than editing its elements) can break instance-wide features, so there is no override:
+
+```typescript
+await t4.contentTypes.delete(systemTypeId);
+// Error: Cannot delete content type "..." (<id>) because it is a system
+// content type. Deleting system content types is not allowed.
+```
+
+`delete()` fetches the content type first to check its type; if it is a system content type, nothing is deleted.
+
 ## Manage content layouts
 
 Access layouts through `layouts` on a `ContentType`. Layout operations use names; layout IDs are not exposed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terminalfour/terminalfour-js",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "JavaScript / TypeScript SDK for the Terminalfour Web Services REST API",
   "keywords": [
     "terminalfour",
@@ -59,7 +59,7 @@
     "@types/node": "^25.5.2",
     "fast-check": "^4.1.1",
     "typescript": "^5.7.0",
-    "vitest": "^3.2.1"
+    "vitest": "^5.0.0"
   },
   "license": "Elastic-2.0"
 }