ampless 1.0.0-alpha.13 → 1.0.0-alpha.15

package/dist/index.d.ts

@@ -1,7 +1,20 @@
 type ContentEventType = 'content.created' | 'content.updated' | 'content.published' | 'content.unpublished' | 'content.deleted';
 type MediaEventType = 'media.uploaded' | 'media.deleted';
 type SiteSettingsEventType = 'site.settings.updated';
-type EventType = ContentEventType | MediaEventType | SiteSettingsEventType;
+/**
+ * Emitted on every Post mutation (INSERT / MODIFY / REMOVE) with both
+ * the previous and the next projection of the row. Drives index-style
+ * derivation: the built-in trusted-processor handler uses it to keep
+ * the `PostTag` denormalized index in sync without making every write
+ * path (admin, MCP, future REST clients) remember to call a helper.
+ *
+ * Plugins that maintain their own indexes (custom search, sitemaps
+ * with per-tag pages, etc.) can subscribe through the same hook
+ * surface as the other event types — the diff payload is already in
+ * the right shape for "compute add/remove/update".
+ */
+type PostIndexEventType = 'post.index.refresh';
+type EventType = ContentEventType | MediaEventType | SiteSettingsEventType | PostIndexEventType;
 /** Minimal projection of a Post item carried in events (no body, to keep payloads small). */
 interface ContentEventPayload {
     postId: string;
@@ -23,7 +36,17 @@ interface MediaEventPayload {
  */
 interface SiteSettingsEventPayload {
 }
-type EventPayloadOf<T extends EventType> = T extends ContentEventType ? ContentEventPayload : T extends MediaEventType ? MediaEventPayload : T extends SiteSettingsEventType ? SiteSettingsEventPayload : never;
+/**
+ * Diff payload for `post.index.refresh`. `previous` is null on INSERT;
+ * `next` is null on REMOVE; both populated on MODIFY. Subscribers
+ * compute the add / remove / update set from this — see the trusted
+ * processor's `rebuildPostTags` handler for the canonical example.
+ */
+interface PostIndexEventPayload {
+    previous: ContentEventPayload | null;
+    next: ContentEventPayload | null;
+}
+type EventPayloadOf<T extends EventType> = T extends ContentEventType ? ContentEventPayload : T extends MediaEventType ? MediaEventPayload : T extends SiteSettingsEventType ? SiteSettingsEventPayload : T extends PostIndexEventType ? PostIndexEventPayload : never;
 interface AmplessEvent<T extends EventType = EventType> {
     type: T;
     payload: EventPayloadOf<T>;
@@ -213,9 +236,8 @@ type CacheStrategy = 'auto' | 'deep' | 'hot';
  * Well-known keys:
  *   - `no_layout`: when true, the public page is served as bare HTML
  *     (no theme chrome). Middleware rewrites the request to the
- *     unified internal route handler (`/r/<slug>`) for such posts
- *     and renders the body verbatim — no Next.js root layout, no
- *     theme chrome.
+ *     internal `/raw/<slug>` handler for such posts and renders the
+ *     body verbatim — no Next.js root layout, no theme chrome.
  *   - `cache`: see `CacheStrategy`. Overrides the default 'auto'
  *     cache strategy for this post. Independent of `no_layout` —
  *     applies uniformly to themed, no_layout, and static posts.
@@ -815,4 +837,4 @@ declare function resolveThemeValues(manifest: ThemeManifest, stored: Record<stri
 
 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 MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, type Page, type PluginEventHandler, type PluginMetadata, type PluginRuntimeContext, type Post, type PostMetadata, type PostStatus, type PostsProvider, type Role, SITE_CONFIG_PK, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, 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, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, 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 MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, type Page, type PluginEventHandler, type PluginMetadata, type PluginRuntimeContext, type Post, type PostIndexEventPayload, type PostIndexEventType, type PostMetadata, type PostStatus, type PostsProvider, type Role, SITE_CONFIG_PK, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, 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, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, validateThemeValue };

package/package.json

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