@terminalfour/terminalfour-js 1.0.1 → 1.0.2

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

@@ -239,6 +239,19 @@ 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>;

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);

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

@@ -239,6 +239,19 @@ 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>;

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);

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terminalfour/terminalfour-js",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "JavaScript / TypeScript SDK for the Terminalfour Web Services REST API",
   "keywords": [
     "terminalfour",