ampless 1.0.0-alpha.21 → 1.0.0-alpha.22

package/dist/index.d.ts

@@ -616,6 +616,39 @@ interface PluginJsonField extends PluginFieldBase<unknown> {
     rows?: number;
 }
 type PluginSettingField = PluginTextField | PluginTextareaField | PluginBooleanField | PluginNumberField | PluginSelectField | PluginUrlField | PluginCodeField | PluginJsonField;
+/**
+ * Static manifest declared in a plugin package's `package.json` under
+ * the `amplessPlugin` key. The plugin package must also expose
+ * `package.json` itself via `exports`:
+ *
+ *   "exports": {
+ *     ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" },
+ *     "./package.json": "./package.json"
+ *   }
+ *
+ * Without the subpath export, Node's package-exports gating rejects
+ * `import.meta.resolve('<pkg>/package.json')` and the runtime cannot
+ * load the manifest. Without `amplessPlugin`, the runtime skips
+ * cross-check silently and falls back to the existing per-factory
+ * capability mismatch checks (backward compatible).
+ */
+interface PluginPackageManifest {
+    /** Must match `AmplessPlugin.apiVersion`. Mismatch throws at runtime
+     *  to prevent loading a plugin built against a different ampless API. */
+    apiVersion: 1;
+    /** Should match `AmplessPlugin.name`. Mismatch warns. */
+    name: string;
+    /** Should match `AmplessPlugin.trust_level`. Mismatch warns. */
+    trustLevel: TrustLevel;
+    /** Should match `AmplessPlugin.capabilities`. Disagreement warns. */
+    capabilities: readonly PluginCapability[];
+    /** Optional admin UI label. */
+    displayName?: LocalizedString;
+    /** Optional short description (1 line). */
+    description?: LocalizedString;
+    /** Optional docs / repo URL. */
+    homepage?: string;
+}
 /**
  * Per-plugin settings declaration. Phase 2 implements `public`;
  * `secret` is reserved for Phase 6a (admin-only storage; never reaches
@@ -628,6 +661,25 @@ interface AmplessPlugin {
     name: string;
     /** Plugin API version. Currently 1; future versions will be additive. */
     apiVersion: 1;
+    /**
+     * Optional npm package name (e.g. `'@scope/ampless-plugin-foo'` or
+     * `'ampless-plugin-foo'`). When set, the runtime resolves
+     * `<packageName>/package.json` at `createPluginHead` construction
+     * time and cross-checks the static `amplessPlugin` manifest against
+     * the factory return value (`apiVersion` mismatch throws,
+     * `name` / `trustLevel` / `capabilities` mismatch warns).
+     *
+     * Plugins that omit this field — site-local plugins, first-party
+     * plugins predating Phase 5, etc. — skip cross-check entirely and
+     * fall back to the existing per-factory capability mismatch checks.
+     * Backward compatible: existing plugins continue to work unchanged.
+     *
+     * For external `npm publish` plugins, `packageName` MUST match the
+     * package's actual `name` and the package's `exports` MUST expose
+     * `./package.json`. The scaffold tool (`npx create-ampless plugin`)
+     * handles both automatically.
+     */
+    packageName?: string;
     trust_level: TrustLevel;
     /**
      * Stable per-install namespace. Defaults to `name` when omitted.
@@ -1259,4 +1311,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 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 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/package.json

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