ampless 1.0.0-alpha.23 → 1.0.0-alpha.24

package/dist/index.d.ts

@@ -615,7 +615,33 @@ interface PluginJsonField extends PluginFieldBase<unknown> {
     placeholder?: string;
     rows?: number;
 }
-type PluginSettingField = PluginTextField | PluginTextareaField | PluginBooleanField | PluginNumberField | PluginSelectField | PluginUrlField | PluginCodeField | PluginJsonField;
+/**
+ * Sub-fields allowed inside a `PluginRepeatableField`. Restricted to
+ * the scalar-shape field types so the v1 admin editor can render each
+ * cell with the existing `renderScalarInput` seam. Code / json /
+ * repeatable are excluded — code is rarely useful per-item, json
+ * recurses into "json inside json" UX that we explicitly want to
+ * avoid, and nested repeatable is deferred.
+ */
+type PluginRepeatableSubField = PluginTextField | PluginTextareaField | PluginBooleanField | PluginNumberField | PluginSelectField | PluginUrlField;
+interface PluginRepeatableField extends PluginFieldBase<ReadonlyArray<Readonly<Record<string, unknown>>>> {
+    type: 'repeatable';
+    /** Shape of each item — every item is a flat object keyed by sub-field `key`. */
+    fields: ReadonlyArray<PluginRepeatableSubField>;
+    /** Hard cap on item count (default 50). Exceeding rejects the whole field. */
+    maxItems?: number;
+    /** Minimum item count (default 0). Below rejects the whole field. */
+    minItems?: number;
+    /** Label for the "+ Add item" button in the admin editor. */
+    addLabel?: LocalizedString;
+    /**
+     * Sub-field key used as the per-item heading in the admin editor
+     * (e.g. `'id'` so categories[0] reads "analytics" not "Item 1").
+     * Falls back to "Item N" when absent or empty.
+     */
+    itemLabelKey?: string;
+}
+type PluginSettingField = PluginTextField | PluginTextareaField | PluginBooleanField | PluginNumberField | PluginSelectField | PluginUrlField | PluginCodeField | PluginJsonField | PluginRepeatableField;
 /**
  * Static manifest declared in a plugin package's `package.json` under
  * the `amplessPlugin` key. The plugin package must also expose
@@ -1186,7 +1212,7 @@ declare function isValidPluginKey(key: string): boolean;
  * `boolean`, `json` stores the decoded value (object / array /
  * primitive — never the source string), etc.
  */
-declare function validatePluginSettingValue(field: PluginSettingField, raw: unknown): unknown | null;
+declare function validatePluginSettingValue(field: PluginSettingField, raw: unknown, mode?: 'strict' | 'lenient'): unknown | null;
 /**
  * Merge stored values on top of manifest defaults for one plugin
  * instance. Both sides are validated through `validatePluginSettingValue`

package/dist/index.js

@@ -239,7 +239,7 @@ var PLUGIN_KEY_PATTERN = /^[a-zA-Z0-9_-]+$/;
 function isValidPluginKey(key) {
   return typeof key === "string" && PLUGIN_KEY_PATTERN.test(key);
 }
-function validatePluginSettingValue(field, raw) {
+function validatePluginSettingValue(field, raw, mode = "lenient") {
   if (raw === void 0) return null;
   switch (field.type) {
     case "text":
@@ -318,6 +318,60 @@ function validatePluginSettingValue(field, raw) {
       if (typeof raw === "string") return null;
       return raw;
     }
+    case "repeatable": {
+      if (!Array.isArray(raw)) return null;
+      const maxItems = typeof field.maxItems === "number" ? field.maxItems : 50;
+      const minItems = typeof field.minItems === "number" ? field.minItems : 0;
+      if (raw.length > maxItems) return null;
+      if (raw.length < minItems) return null;
+      const subFieldMap = /* @__PURE__ */ new Map();
+      for (const sf of field.fields) {
+        subFieldMap.set(sf.key, sf);
+      }
+      const validatedItems = [];
+      for (const item of raw) {
+        if (typeof item !== "object" || item === null || Array.isArray(item)) {
+          if (mode === "strict") return null;
+          continue;
+        }
+        const rawItem = item;
+        let itemValid = true;
+        const validatedItem = {};
+        for (const sf of field.fields) {
+          const rawSubVal = Object.prototype.hasOwnProperty.call(rawItem, sf.key) ? rawItem[sf.key] : void 0;
+          if (rawSubVal === void 0) {
+            if (sf.required) {
+              if (mode === "strict") return null;
+              itemValid = false;
+              break;
+            }
+            if (sf.default !== void 0) {
+              const validatedDefault = validatePluginSettingValue(sf, sf.default, mode);
+              if (validatedDefault !== null) {
+                validatedItem[sf.key] = validatedDefault;
+              }
+            }
+            continue;
+          }
+          const validatedSubVal = validatePluginSettingValue(sf, rawSubVal, mode);
+          if (validatedSubVal === null) {
+            if (sf.required) {
+              if (mode === "strict") return null;
+              itemValid = false;
+              break;
+            }
+            continue;
+          }
+          validatedItem[sf.key] = validatedSubVal;
+        }
+        if (!itemValid) {
+          continue;
+        }
+        validatedItems.push(validatedItem);
+      }
+      if (validatedItems.length < minItems) return null;
+      return validatedItems;
+    }
   }
 }
 function resolvePluginSettings(manifest, stored) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ampless",
-  "version": "1.0.0-alpha.23",
+  "version": "1.0.0-alpha.24",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",