ampless 1.0.0-alpha.23 → 1.0.0-alpha.25

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`
@@ -1311,4 +1337,4 @@ declare function pickDefaultEntrypoint(files: readonly {
 
 declare const VERSION = "0.0.1";
 
-export { type AmplessEvent, type AmplessPlugin, type AuthContext, type BundleExtractResult, type CacheConfig, type CacheStrategy, type Config, type ContentEventPayload, type ContentEventType, type ContentFormat, type ContentTypeDefinition, type CreatePostInput, DEFAULT_ENTRYPOINT, type DateFormat, type EventPayloadOf, type EventType, type ExtractedFile, type FieldDefinition, type FieldType, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type LocalizedString, MAX_BUNDLE_BYTES, type Media, type MediaEventPayload, type MediaEventType, type MediaMetadata, type MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, PLUGIN_KEY_PATTERN, type Page, type PluginBooleanField, type PluginCapability, type PluginCodeField, type PluginEventHandler, type PluginJsonField, type PluginMetadata, type PluginNumberField, type PluginPackageManifest, type PluginPublicRenderContext, type PluginRuntimeContext, type PluginSelectField, type PluginSettingField, type PluginSettingsManifest, type PluginTextField, type PluginTextareaField, type PluginUrlField, type Post, type PostIndexEventPayload, type PostIndexEventType, type PostMetadata, type PostStatus, type PostsProvider, type PublicBodyDescriptor, type PublicHeadDescriptor, type PublicPostBodyDescriptor, type Role, SITE_CONFIG_PK, type ScriptStrategy, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, type StaticPostFileMeta, type StreamEventName, TEXT_EXTENSIONS, type ThemeColorField, type ThemeField, type ThemeFieldType, type ThemeFontFamilyField, type ThemeImageField, type ThemeLengthField, type ThemeLinkListField, type ThemeManifest, type ThemeModule, type ThemeRouteContext, type ThemeSelectField, type ThemeTextField, type TrustLevel, VERSION, type ValidationIssue, bundlePrefix, createPost, decodeAwsJson, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, encodeAwsJson, escapeXml, extractFirstImageUrl, findAbsolutePathRefs, flattenSettings, formatColorPair, formatDate, formatPublicAssetUrl, getKvStore, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isTagListUrl, isValidPluginKey, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolvePluginSettings, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, validatePluginSettingValue, validatePublicAssetKey, validateThemeValue };
+export { type AmplessEvent, type AmplessPlugin, type AuthContext, type BundleExtractResult, type CacheConfig, type CacheStrategy, type Config, type ContentEventPayload, type ContentEventType, type ContentFormat, type ContentTypeDefinition, type CreatePostInput, DEFAULT_ENTRYPOINT, type DateFormat, type EventPayloadOf, type EventType, type ExtractedFile, type FieldDefinition, type FieldType, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type LocalizedString, MAX_BUNDLE_BYTES, type Media, type MediaEventPayload, type MediaEventType, type MediaMetadata, type MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, PLUGIN_KEY_PATTERN, type Page, type PluginBooleanField, type PluginCapability, type PluginCodeField, type PluginEventHandler, type PluginJsonField, type PluginMetadata, type PluginNumberField, type PluginPackageManifest, type PluginPublicRenderContext, type PluginRepeatableField, type PluginRepeatableSubField, type PluginRuntimeContext, type PluginSelectField, type PluginSettingField, type PluginSettingsManifest, type PluginTextField, type PluginTextareaField, type PluginUrlField, type Post, type PostIndexEventPayload, type PostIndexEventType, type PostMetadata, type PostStatus, type PostsProvider, type PublicBodyDescriptor, type PublicHeadDescriptor, type PublicPostBodyDescriptor, type Role, SITE_CONFIG_PK, type ScriptStrategy, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, type StaticPostFileMeta, type StreamEventName, TEXT_EXTENSIONS, type ThemeColorField, type ThemeField, type ThemeFieldType, type ThemeFontFamilyField, type ThemeImageField, type ThemeLengthField, type ThemeLinkListField, type ThemeManifest, type ThemeModule, type ThemeRouteContext, type ThemeSelectField, type ThemeTextField, type TrustLevel, VERSION, type ValidationIssue, bundlePrefix, createPost, decodeAwsJson, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, encodeAwsJson, escapeXml, extractFirstImageUrl, findAbsolutePathRefs, flattenSettings, formatColorPair, formatDate, formatPublicAssetUrl, getKvStore, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isTagListUrl, isValidPluginKey, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolvePluginSettings, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, validatePluginSettingValue, validatePublicAssetKey, validateThemeValue };

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.25",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",