v0.9.1 — CollectorRequestSection round-trip for customFieldKeys[]

CollectorRequestSection lacked a customFieldKeys field, so the section's
reference into request.customFields[] was lost on serialize/deserialize. Added
private #customFieldKeys plus public customFieldKeys getter,
setCustomFieldKeys(keys) and addCustomFieldKey(key) setters, parsing in
setContent() and serialization in getData(). Discovered during Phase 6
mcp-chrome smoke test of an uploaded AppTemplate — request had customFields
but the per-section pointers were dropped.

Author: perki

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-04-28
+
+### Fixed — `CollectorRequestSection` round-trip for `customFieldKeys[]`
+
+`CollectorRequestSection` lacked a `customFieldKeys` field, so the section's reference into `request.customFields[]` was lost on serialize/deserialize. Added private `#customFieldKeys` plus public `customFieldKeys` getter, `setCustomFieldKeys(keys)` and `addCustomFieldKey(key)` setters, parsing in `setContent()` and serialization in `getData()`. Discovered during Phase 6 mcp-chrome smoke test — a template uploaded via `loadTemplate()` had its custom fields surfaced on the request but the per-section pointers dropped.
+
 ## [0.9.0] - 2026-04-28
 
 ### Added — custom fields & template loader (45-custom-fields-appTemplates Phase 3 + 3.5)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hds-lib",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Health Data Safe - Library",
   "type": "module",
   "engines": {

ts/appTemplates/CollectorRequest.ts

@@ -133,6 +133,9 @@ export class CollectorRequest {
             section.setItemCustomization(itemKey, customization as Record<string, unknown>);
           }
         }
+        if (Array.isArray(sectionData.customFieldKeys)) {
+          section.setCustomFieldKeys(sectionData.customFieldKeys);
+        }
       }
       delete futureContent.sections;
     }
@@ -435,12 +438,14 @@ class CollectorRequestSection implements CollectorSectionInterface {
   #key: string;
   #itemKeys: Array<string>;
   #itemCustomizations: Record<string, Record<string, unknown>>;
+  #customFieldKeys: Array<string>;
 
   constructor (key: string, type: RequestSectionType) {
     this.#key = key;
     this.#type = type;
     this.#itemKeys = [];
     this.#itemCustomizations = {};
+    this.#customFieldKeys = [];
     this.#name = {
       en: ''
     };
@@ -493,6 +498,19 @@ class CollectorRequestSection implements CollectorSectionInterface {
     return this.#itemCustomizations[key];
   }
 
+  // Plan 45 — section's reference into request.customFields[]
+  get customFieldKeys (): Array<string> { return this.#customFieldKeys; }
+  setCustomFieldKeys (keys: Array<string>) {
+    if (!Array.isArray(keys)) throw new HDSLibError('customFieldKeys must be an array', keys);
+    this.#customFieldKeys = keys.slice();
+  }
+
+  addCustomFieldKey (key: string) {
+    if (typeof key !== 'string' || key.length === 0) throw new HDSLibError('customFieldKey must be a non-empty string', key);
+    if (this.#customFieldKeys.includes(key)) return;
+    this.#customFieldKeys.push(key);
+  }
+
   getData () {
     const data: any = {
       key: this.key,
@@ -503,6 +521,9 @@ class CollectorRequestSection implements CollectorSectionInterface {
     if (Object.keys(this.#itemCustomizations).length > 0) {
       data.itemCustomizations = this.#itemCustomizations;
     }
+    if (this.#customFieldKeys.length > 0) {
+      data.customFieldKeys = this.#customFieldKeys;
+    }
     return data;
   }
 }